ジャンルから探す

Web Design & Dev English

WordPressのREST API更新で記事が公開される2つの条件

このブログは、記事の入稿をWordPressのREST APIで自動化しています。そのとき「日時が過去になった下書きをREST APIで更新すると、勝手に公開される」と考えて、下書きを更新するたびに投稿日時を翌日に入れ直す対策を入れていました。

結論から書くと、WordPress 7.1で検証したところ、下書きは更新しても公開されませんでした。更新しただけで公開に変わったのは、予約投稿の日時が過ぎていた記事です。もう1つ、日時が過去の下書きで「公開」を押すと、予約にならずにその場で公開されます。

この記事では、状態と日時の組み合わせを変えて試した結果と、公開に切り替わるWordPress本体の処理、その結果を受けて見直した確認の手順をまとめます。

スポンサーリンク

REST APIで更新しただけで記事が公開されるのはどんなときか

結論:次の2つのときです。①予約(status=future)のまま日時が過ぎた記事を更新したとき、②日時が過去の下書きにstatus=publishを送ったとき。

ローカルに立てたWordPress 7.1で、記事を作ってからREST APIで1項目だけ更新し、更新後の状態を読み直しました。タイムゾーンはAsia/Tokyoです。

更新前の記事 送った内容 更新後の状態
日時が3日前の下書き アイキャッチ(featured_media)だけ 下書きのまま
日時が3日前の下書き タイトルだけ 下書きのまま
日時が3日後の下書き アイキャッチだけ 下書きのまま
日時が3日前の下書き XML-RPCでカスタムフィールドだけ 下書きのまま
予約(future)で日時が過ぎたもの アイキャッチだけ 公開(publish)
日時が3日前の下書き status=publish 公開(日時は3日前のまま)
日時が3日後の下書き status=publish 予約(future)
日時が3日前の下書き status=draftと翌日の日時 下書きのまま(日時だけ変わる)

このブログは多言語化にPolylangを使っているので、Polylang 3.8.9を有効にした状態でも「日時が3日前の下書きのアイキャッチだけ更新」を試しました。結果は同じく下書きのままでした。

予約の日時が過ぎた記事が更新で公開されるのはなぜか

結論:記事を保存するwp_insert_post()が、保存のたびに「予約なのに日時が過ぎている記事」を公開に切り替えるからです。

REST APIで記事を更新すると、内部ではwp_update_post()を経由してwp_insert_post()が呼ばれます。WordPress 7.1のwp-includes/post.phpには、次の処理があります。

if ( 'attachment' !== $post_type ) {
	$now = gmdate( 'Y-m-d H:i:s' );

	if ( 'publish' === $post_status ) {
		if ( strtotime( $post_date_gmt ) - strtotime( $now ) >= MINUTE_IN_SECONDS ) {
			$post_status = 'future';
		}
	} elseif ( 'future' === $post_status ) {
		if ( strtotime( $post_date_gmt ) - strtotime( $now ) < MINUTE_IN_SECONDS ) {
			$post_status = 'publish';
		}
	}
}

切り替えの対象はpublishとfutureの2つだけで、draftはどちらの分岐にも入りません。表で下書きが公開されなかったのは、この処理のとおりです。

予約の日時が過ぎたまま残るのはどんなときか

結論:予約投稿を公開する処理(WP-Cron)が、予約の時刻に動かなかったときです。

予約投稿は、通常は予約時刻にWP-Cronのpublish_future_postが公開します。WP-Cronはサイトへのアクセスをきっかけに動くため、アクセスが無い時間帯や、DISABLE_WP_CRONで止めている環境では、予約時刻を過ぎてもfutureのまま残ります。

検証ではDISABLE_WP_CRONを有効にして、70秒後の日時で予約記事を作りました。80秒待ってから読むとfutureのままで、そこへアイキャッチだけを送るとpublishに変わりました。「アイキャッチを差し替えただけなのに公開された」という現象は、この条件で再現します。

スポンサーリンク

日時が過去の下書きで「公開」を押すとどうなるか

結論:予約にはならず、その場で公開されます。投稿日時は過去のまま残ります。

上の処理でpublishからfutureに切り替わるのは、日時が今より1分以上先のときだけです。日時が過去ならpublishのまま保存されます。

このブログの入稿ツールは、下書きの投稿日時に「翌日19:00」を入れておき、管理画面で「公開」を押すとその日時の予約になる、という運用にしています。下書きを数日寝かせてから「公開」を押すと、予約ではなく即時公開になり、しかも投稿日時が過去なので、トップページの新着順では古い位置に並びます。

検証の結果、何を見直したか

結論:「下書きを更新するたびに日時を入れ直す」対策は、自動公開を防ぐ役に立っていませんでした。見るべきだったのは、更新前の記事がfutureで日時を過ぎていないかです。

もともとこの対策は、記事のアイキャッチを差し替えただけで記事が公開された、という出来事から入れたものでした。ただ、そのときの記事がdraftだったのかfutureだったのかは記録に残っておらず、今となっては確認できません。当時は「過去日時の下書き」が原因だと考えましたが、今回の検証の結果を見る限り、その理解は誤りでした。

このブログでは、雑記ブログの方針と記事の考え方まとめに書いたとおり、誤りは訂正したことを残して直す方針にしています。そのため、当初の理解もこの記事に残しました。

▼REST APIで記事を更新するときの確認手順

① 更新の前にstatusとdateを読む。status=futureで日時が過ぎていたら、更新すると公開される

② 下書きを公開する前に日時が未来かを確かめる。過去なら予約にならず即時公開になる

③ 更新の後にもう一度読み直し、statusとdateが意図せず変わっていないかを確かめる

Pythonで書くと、次の形になります。更新の前後で状態を読み比べ、変わっていたら止めます。

from datetime import datetime
from zoneinfo import ZoneInfo
import requests

def get_post(post_id):
    r = requests.get(f"{API}/posts/{post_id}", params={"context": "edit"}, headers=AUTH, timeout=30)
    r.raise_for_status()
    return r.json()

before = get_post(post_id)
scheduled = datetime.fromisoformat(before["date"]).replace(tzinfo=ZoneInfo("Asia/Tokyo"))
if before["status"] == "future" and scheduled <= datetime.now(ZoneInfo("Asia/Tokyo")):
    raise SystemExit("予約の日時が過ぎています。更新すると公開されます")

requests.post(f"{API}/posts/{post_id}", json={"featured_media": media_id}, headers=AUTH, timeout=60).raise_for_status()

after = get_post(post_id)
for key in ("status", "date"):
    if before[key] != after[key]:
        raise SystemExit(f"{key} が変わりました: {before[key]} → {after[key]}")

dateはサイトのタイムゾーンの時刻で返るので、比べるときはサイトのタイムゾーン(このブログはAsia/Tokyo)を付けて比べています。

スポンサーリンク

手元のWordPressで同じ検証をする方法

結論:WordPress Playground CLIを使うと、PHPやDockerを入れずに、ローカルのWordPressを1コマンドで起動できます。

本番のサイトで試すと、検証用の記事が本当に公開されてしまいます。今回はNode.jsで動くWordPress Playground CLIでWordPress 7.1を起動し、そこへREST APIを送りました。

npm i @wp-playground/cli
npx wp-playground-cli server --blueprint=bp.json --port 9400

bp.jsonには、WP-Cronを止める設定と、REST APIの認証に使うアプリケーションパスワードの作成を書きました。

{
  "preferredVersions": { "php": "8.3", "wp": "latest" },
  "steps": [
    { "step": "defineWpConfigConsts", "consts": { "WP_ENVIRONMENT_TYPE": "local", "DISABLE_WP_CRON": true } },
    { "step": "setSiteOptions", "options": { "timezone_string": "Asia/Tokyo" } },
    { "step": "runPHP", "code": "<?php require '/wordpress/wp-load.php'; $u = get_user_by('login', 'admin'); list($pw) = WP_Application_Passwords::create_new_application_password($u->ID, array('name' => 'rest-test')); file_put_contents('/wordpress/app-pass.txt', $pw); ?>" }
  ]
}

WP_ENVIRONMENT_TYPEをlocalにしているのは、アプリケーションパスワードがHTTPSのサイトか、ローカル環境でしか使えないためです。起動後はhttp://127.0.0.1:9400/app-pass.txtからパスワードを読み、adminユーザーのBasic認証でREST APIを呼べます。

REST APIの確認をスクリプトにまとめる考え方は、Python活用でQA業務を効率化する5つの方法のAPIテストの節でも書いています。

まとめ

▼要点

① WordPress 7.1では、下書きはREST APIで更新しても公開されない

② 予約(future)で日時が過ぎた記事は、どの項目を更新しても公開に切り替わる

③ 日時が過去の下書きで「公開」を押すと、予約ではなく即時公開になる

④ 切り替えているのはwp_insert_post()の、publishとfutureを日時で入れ替える処理

⑤ 更新の前後でstatusとdateを読み比べれば、意図しない公開に気づける

「更新しただけで公開された」と感じる出来事の原因は、下書きではなく予約の方にありました。対策を入れる前に、手元で再現しておくべきだったと思います。

※WordPress 7.1(PHP 8.3・WordPress Playground CLI)で、2026年9月12日に確認した内容です。テーマやプラグインが保存処理に手を加えている場合は、結果が変わることがあります。