ホーム
ブログ
グラフAPI v26.0とマーケティングAPI v26.0の紹介

2026年7月29日

グラフAPI v26.0とマーケティングAPI v26.0の紹介

作成 Ayyad Farah, Manjari Jain

グラフAPI v26.0とマーケティングAPI v26.0には、新機能、廃止事項、重要な変更が含まれています。以下のハイライトをご覧ください。すべての変更内容と詳細については、V26.0の更新履歴をご覧ください。

重要な日程と変更点

  • グラフAPI - コマース注文管理: 2026年7月29日以降、v26.0以降の影響を受けるエンドポイントへの呼び出しはブロックされます。2026年10月27日に、残りのすべてのグラフAPIバージョンからエンドポイントが削除されます。その後、呼び出しはエラーを返します。代替となるAPIはありません。
  • グラフAPI - Rights Managerの所有者フィールド: 2026年7月29日のv26.0以降、RightsHolderOwnerタイプを返す代替フィールドが利用可能になり、廃止された所有者フィールドは返されなくなります。廃止されるフィールドは、v26.0のリリース後2年間、v25.0以前で引き続き利用できます。
  • グラフAPI - 従来のプロトコル機能: 2026年7月29日以降、v26.0の呼び出しから5つの従来の動作が削除されます。2026年10月27日以降、サポートされている残りのグラフAPIバージョンすべてで同じ動作が適用されます。
  • マーケティングAPI - WhatsAppステータス内の広告: 2026年7月29日リリースのv26.0では、ID、ターゲット設定、最適化、クリエイティブの機能が拡張されています。
  • マーケティングAPI - 住宅、雇用、金融製品およびサービスのキャンペーンのAdvantage+ オーディエンス: 2026年7月29日のv26.0以降、ターゲットが制限されている新規またはコピーされた広告セットは、advantage_audienceを1または0に明示的に設定する必要があります。デフォルトまたは緩和設定では、引き続きデフォルトで1に設定され、既存の広告セットの更新には影響がありません。
  • マーケティングAPI - Instagram発見フィード: 2026年7月29日のv26.0以降、この配置は利用できなくなります。開発者は、配置の設定から「発見」を削除する必要があります。
  • マーケティングAPI - ウェブとアプリのキャンペーンのウェブのみのリンク先: 2026年7月29日のv26.0以降、キャンペーンのコンバージョンの場所がウェブサイトとアプリである場合、広告でapplink_treatmentweb_onlyに設定されたクリエイティブを使用できなくなります。この制限は2026年10月27日にすべてのマーケティングAPIバージョンに適用されます。
  • マーケティングAPI - Messengerストーリーズ: 2026年7月29日以降、v26.0をバージョン指定した呼び出しでは、広告セットの作成または更新時に、story値がmessenger_positionsから自動的に削除されます。この廃止は、2026年10月27日に、バージョン指定のない呼び出しを含むすべてのマーケティングAPIバージョンに適用されます。
  • マーケティングAPI - アンケート広告の作成: 2026年7月29日のv26.0以降、アンケートクリエイティブを作成するリクエストや、広告をアンケート広告に変更するリクエストは却下されます。クリエイティブを変更せずに既存の広告を更新することは、引き続きサポートされます。この廃止は、2026年10月27日にすべてのマーケティングAPIバージョンに適用されます。
  • グラフAPIとマーケティングAPI - 配信推定フィールド: 2026年7月29日より、バージョン26の呼び出しから、daily_outcomes_curvebudget_guardrailestimate_dauの応答フィールドが削除されます。2026年10月27日には、サポートされているほかのすべてのバージョンからも削除されます。代替となるAPIはありません。
  • グラフAPIバージョンの廃止: グラフAPI v20.0は2026年9月24日に廃止され、削除されます。グラフAPI v21.0は2027年1月21日に廃止および削除されます。

一般的なアップデート

マーケティングAPI: WhatsAppステータスでの広告サポートを拡張

2026年7月29日にリリースされたマーケティングAPI v26.0以降、WhatsAppステータス内の広告では、ID、ターゲット設定、最適化、クリエイティブの機能がサポートされるようになりました。

  • WhatsApp ID: サードパーティのマーケティングAPI呼び出し元は、WhatsAppステータスへの配信を意図した広告クリエイティブに明示的にwamo_whatsapp_identity_specを含める必要があります。このような呼び出し元については、WhatsApp IDは自動的にはデフォルト設定されません。
  • 年齢不明のターゲット設定: WhatsAppステータスの配置が選択され、user_age_unknownが設定されていない場合、フィールドはデフォルトでtrueに設定されます。これは、キャンペーンがWhatsAppで年齢不明の利用者にリーチできることを意味します。
  • 最適化: オフサイトコンバージョンのコンバージョン最適化は、「売上」、「リード」、「エンゲージメント」の目的でサポートされています。ランディングページビューの最適化もサポートされています。
  • クリエイティブフォーマット: カルーセル広告は最大10枚のカードをサポートします。

詳しくは、配置ターゲット設定基本ターゲット設定のドキュメントをご覧ください。

廃止と重要な変更

グラフAPIとマーケティングAPI: 配信推定フィールドの削除

daily_outcomes_curvebudget_guardrailestimate_dauフィールドは、これらの値を提供するサービスが廃止されたため、配信推定エンドポイントの応答から削除されます。2026年7月29日にリリースのグラフAPI v26.0とマーケティングAPI v26.0以降では、これらのフィールドが返されなくなります。この変更は、2026年10月27日に、サポートされているグラフAPIとマーケティングAPIの残りのすべてのバージョンに適用されます。代替となるAPIはありません。

開発者は、該当する削除日までに、これらのフィールドの使用や参照を削除してください。

影響を受けるエンドポイントの例は以下のとおりです。

  • GET /{ad-account-id}/delivery_estimate - 広告アカウントの配信推定値
  • GET /{adset-id}/delivery_estimate - 広告セットの推定配信値

フィールドとエンドポイントの全リストは、V26.0の更新履歴で確認できます。

グラフAPI: コマース注文管理APIの廃止

グラフAPI v26.0以降でこれらのエンドポイントを呼び出すアプリは、2026年7月29日以降、ブロックされます。2026年10月27日に、残りのすべてのグラフAPIバージョンでエンドポイントが削除されます。その後、呼び出しはエラーを返します。

ショップのFacebookとInstagramでの直接チェックアウトの機能は、完全に廃止されました。コマース注文管理APIを使用すると、チェックアウトエクスペリエンスについて、サードパーティプラットフォームから注文のリスト表示、注文詳細の表示、配送の管理、キャンセルの処理、返金の処理、返品のトラッキングが可能でした。基盤となるコマース注文インフラが廃止されるため、これらのエンドポイントは廃止されます。

開発者は、これらのエンドポイントの呼び出しを停止し、依存関係を削除する必要があります。代替となるAPIはありません。

影響を受けるエンドポイントの例は以下のとおりです。

  • GET /{commerce-order-id} - 注文詳細
  • GET /{commerce-order-id}/items - 注文のラインアイテム
  • GET /{commerce-order-id}/payments - 注文の支払い
  • GET /{commerce-order-id}/payment_transaction_details - 支払い取引の詳細
  • GET /{commerce-order-id}/refunds - 注文の返金
  • GET /{commerce-order-id}/shipments - 注文の発送
  • GET /{commerce-order-shipment-id}/items - 発送ラインアイテム
  • GET /{commerce-return-id} - 返品の詳細
  • GET /{commerce-order-cancellation-id}/items - キャンセルされたラインアイテム
  • GET /{page-id}/commerce_orders - ページごとに注文をリストする
  • GET /{commerce-merchant-settings-id}/commerce_orders - コマース販売者設定による注文のリスト
  • GET /{commerce-merchant-settings-id}/commerce_returns - コマース販売者設定による返品一覧
  • GET /{commerce-merchant-settings-id}/tax_settings - 税金の設定

影響を受ける47のエンドポイントの全リストは、グラフAPI v26.0の更新履歴でご確認いただけます。

グラフAPI: Rights Managerの所有者フィールドがRightsHolderOwnerに移行されました

AudioVisualReferenceMatchとImageReferenceMatchのreference_ownerおよびmatched_reference_ownerフィールド、CopyrightOwnershipTransferのsending_rights_holderおよびreceiving_rights_holderフィールドは廃止されます。グラフAPI v26.0以降、Rights Managerが使用する所有権モデルをより適切に表すために、専用のRightsHolderOwnerタイプを返す代替フィールドが利用可能になりました。廃止されたフィールドはv26.0以降の応答で返されません。

廃止されるフィールドは、v26.0のリリースから2年間、v25.0以前で引き続き機能します。その後、削除されます。開発者はこの2年の間に、代替フィールドに移行する必要があります。

以下の置き換えフィールドを使用してください。

  • reference_ownerではなくreference_owner_rh_ownerを使用します。
  • matched_reference_ownerではなくmatched_reference_owner_rh_ownerを使用します。
  • sending_rights_holderではなくsending_rights_holder_ownerを使用します。
  • receiving_rights_holderではなくreceiving_rights_holder_ownerを使用します。

影響を受けるエンドポイントの例は以下のとおりです。

  • GET /{audio-visual-reference-match-id} - 参照マッチングの詳細
  • GET /{image-reference-match-id} - 画像リファレンスのマッチング詳細
  • GET /{copyright-ownership-transfer-id} - 所有権譲渡の詳細

すべてのフィールドのリストは、グラフAPI v26.0の更新履歴で参照できます。

グラフAPI: 従来のプロトコル機能が廃止されました

2026年7月29日以降、グラフAPI v26.0以降では、5つの従来のプロトコルの動作(prettydebugdate_format、root GET /?ids=...リクエスト、従来のIf-None-Match / ETag処理)がサポートされなくなります。

これらの動作は、グラフAPIの応答を簡素化し、リクエスト処理の一貫性を向上するために廃止されます。

グラフAPI v26.0以降の場合:

  • prettyは無視され、JSON応答はコンパクト形式を使用します。クライアントツールまたはコードでJSONをフォーマットします。
  • debugは無視され、デバッグ応答エンベロープは追加されません。標準のデバッグツールを使用します。debug_tokenエンドポイントには影響はありません。
  • date_formatを含むリクエストはパラメーターエラーを返します。デフォルトの日付フォーマットを使用し、必要に応じてローカルで値を変換してください。
  • GET /?ids=...を使用するルートリクエストはパラメーターエラーを返します。オブジェクトごとのリクエストまたはサポートされているバッチ処理を使用してください。
  • If-None-Matchは無視されます。古いETag応答ヘッダーと304 Not Modified動作は削除され、リクエストは完全な応答を返します。

2026年10月27日より、上記の変更はサポートされているグラフAPIの全バージョンに適用されます。移行の詳細については、ランタイムリクエストログとグラフAPI v26.0の更新履歴をご確認ください。

新しいページエクスペリエンスで従来のページフィールドを廃止(グラフAPI v26.0)

開発者ブログ投稿の下書き。リリース予定: グラフAPI v26.0。変更のタイプ: 廃止(90日)。

概要

新デザインのページでは、5つの従来のページノードフィールド(current_locationgenrenetworkparkingstart_info)とauto_publish_page_info_updatesページ設定がグラフAPI v26.0以降で廃止されます。これらのフィールドは管理されなくなりました。新デザインのページではアクセスしないでください。

タイムライン

  • 2026年7月29日:新デザインのページで、これらのフィールドがブロックされ、v26.0以降で設定が削除されます。
  • リリースから約90日後:残りのすべてのバージョンにも同じ変更が適用されます。2026年10月下旬の正確な日付は未定です。

変更点

v26.0以降では、新デザインのページでこれら5つのフィールドのいずれかをリクエストするとバージョンエラーが返され、auto_publish_page_info_updatesの設定はページ設定の応答に表示されなくなります。以前のバージョンの場合、90日間の移行期間が終了するまで動作は変わりませんが、その後はすべてのバージョンに同じことが適用されます。

影響を受けるエンドポイント:

  • GET /{page-id}?fields=current_location
  • GET /{page-id}?fields=genre
  • GET /{page-id}?fields=network
  • GET /{page-id}?fields=parking
  • GET /{page-id}?fields=start_info
  • GET /{page-id}?fields=settings - 返される設定リストからauto_publish_page_info_updatesの設定が削除されます

開発者がすべきこと

  • 該当のフィールドとauto_publish_page_info_updatesの設定をページリクエストから削除してください。
  • 新デザインのページでのこれらのフィールドの使用については、リクエストログ、クライアント統合、ダッシュボードを確認してください。
  • 完全な最新のリストについては、グラフAPI v26.0の更新履歴をご覧ください。

参照

マーケティングAPI: 住宅、雇用、金融製品およびサービスのキャンペーンに適用されるAdvantage+ オーディエンスの要件

2026年7月29日以降、マーケティングAPI v26.0では、オーディエンス設定が完全にデフォルト設定または緩和されている場合、targeting_automation内のadvantage_audienceパラメーターが自動的に1にデフォルト設定されます。制限のあるオーディエンス設定の場合、開発者は、特別な広告カテゴリ(住宅、雇用、金融製品およびサービス)のキャンペーンでadvantage_audience1または0に明示的に設定する必要があります。

この動作は、新しい広告セットを作成する場合にのみ適用されます。既存の広告セットを更新する場合、どのAPIバージョンでもこの動作は発生しません。

これは、マーケティングAPI v23.0で、特別な広告カテゴリ以外のキャンペーンに対して導入された動作と同じです。詳しくは、Advantage+ オーディエンスのトラブルシューティングのドキュメントをご覧ください。

以下のAPIエンドポイントが影響を受けます。

  • POST /{ad-account-id}/adsets
  • POST /{adset-id}
  • POST /{adset-id}/copies

マーケティングAPI: 発見タブ広告の配置が利用できなくなりました

2026年7月29日にリリースのマーケティングAPI v26.0以降、Instagram発見タブフィードの配置は利用できなくなります。[発見]への配信は停止され、キャンペーンの消化は対象となる他の配置に自動的に移行されます。

[発見]タブの配置が指定された広告セットを作成または更新しようとすると、エラーが表示されます。開発者は、配置の設定から「発見」を削除し、他の対象の配置を使用してください。

以下のエンドポイントが影響を受けます。

  • POST /act_{ad-account-id}/adsets
  • POST /{ad-set-id}

マーケティングAPI: ウェブとアプリのキャンペーンではウェブのみのリンク先が廃止されます

2026年7月29日より、マーケティングAPI v26.0では、applink_treatmentweb_onlyに設定した広告クリエイティブを、コンバージョンの場所にウェブサイトとアプリを使用するキャンペーン内の広告に結び付けることができなくなります。これは、POST /act_{ad-account-id}/adsおよびPOST /{ad-id}による広告の作成やアップデートに影響します。

広告クリエイティブエンドポイントは変わりませんが、POST /act_{ad-account-id}/adcreativesapplink_treatmentの値が設定される場所です。開発者は、applink_treatment=web_onlyの統合を確認し、ウェブサイトとアプリのキャンペーンで自動リンク先選択または別の互換性のある手動リンク先を使用する必要があります。

v26.0のリリースから90日後の2026年10月27日には、この制限がマーケティングAPIの全バージョンに適用される予定です。詳しくは、広告および広告クリエイティブのドキュメントをご覧ください。

マーケティングAPI: Messengerストーリーズの配置が廃止されました

2026年7月29日にリリースされたマーケティングAPI v26.0以降、バージョン指定のv26.0以降の呼び出しで広告セットを作成または更新する場合、messenger_positionsstory値が利用できなくなります。

これらの呼び出しでは、storyはターゲット設定の仕様から静かに削除され、新規または既存の広告セットの有効な配置に表示されなくなります。GET /{ad_set-id}?fields=targetingでリクエストされた場合、過去のターゲットデータにstoryが引き続き含まれる可能性があります。専用のエラーは返されませんが、storyを削除すると配置設定が無効になる場合、標準の配置検証エラーが適用される可能性があります。

以下のエンドポイントが影響を受けます。

  • POST /act_{ad-account-id}/adsets
  • POST /{ad_set-id}

手動配置を使用している開発者は、messenger_positionsからstoryを削除してください。これが唯一の値である場合は、messenger_positionsフィールド全体を削除してください。marketing_messagesのようなほかのMessengerの配置が使用されていない場合は、publisher_platformsからmessengerを削除することも検討してください。Advantage+ 配置ではアクションは不要です。

この変更はAPIのみに適用され、広告マネージャには影響しません。バージョン指定のない呼び出しや、v26.0より前のバージョンへの呼び出しについては、当面の間影響はありません。v26.0のリリースから90日後の2026年10月27日に、バージョン指定のない呼び出しを含むすべてのマーケティングAPIバージョンに廃止が適用されます。

マーケティングAPI: アンケート広告の作成は廃止されました

2026年7月29日にリリースのマーケティングAPI v26.0以降、広告や広告クリエイティブを作成または更新する際にアンケートコンポーネントはサポートされなくなります。interactive_components_specではpoll_specフィールドとtypeフィールドの"poll"値を利用できなくなります。

アンケートクリエイティブを作成するリクエストや、アンケートクリエイティブを使用するために広告を変更するリクエストは却下されます。クリエイティブを変更せずに既存の広告を更新すること(ステータス、予算、スケジュールの変更など)は可能です。

以下のエンドポイントが影響を受けます。

開発者は、アンケート関連のフィールドをクリエイティブの仕様から削除し、アンケートコンポーネントのないクリエイティブを使用してください。v26.0より前のバージョンへの呼び出しやバージョン指定のない呼び出しについては、当面の間影響はありません。

v26.0のリリースから90日後の2026年10月27日に、この廃止がマーケティングAPIの全バージョンに適用される予定です。

Meta Business SDK v26のリリース

グラフAPI v26のリリース後まもなく、Meta Business SDK v26リリースが公開されます。このリリースには、依存関係のアップグレード、コンバージョンAPIパラメータービルダー統合、新しいAPI機能、コマース注文管理APIと複数のレガシープロトコル機能の廃止が含まれます。

Business SDKは、オープンソースのコンバージョンAPIパラメータービルダーと統合されました。この新しい連携を活用することで、コンバージョンAPI連携の品質を向上させることができます。主な機能: パラメーターfbcfbpevent_source_urlreferrer_urlclient_ip_addressを自動生成(広告主が設定した条件により制限)して強化し、サポートされる言語で自動的に個人を特定できる情報を正規化/ハッシュ化します。詳しくはこちらをご覧ください。コマース注文管理API (47件のエンドポイント)は、完全に廃止され、代替はありません。Instagram発見フィード広告の配置は削除され、指定するとエラーが発生します。Messengerストーリーズの配置は、messenger_positionsから自動的に削除されます。WhatsAppステータス内の広告に、ID指定、最大10枚のカードのカルーセル、オフサイトコンバージョン最適化といった新しい機能が登場です。

プラットフォームSDKの2年にわたる廃止スケジュールの一環として、今後の廃止および終了の予定にご注意ください。

  • 2026年9月: FacebookプラットフォームSDK v20.0が廃止されます
  • 2027年1月: FacebookプラットフォームSDK v21.0が廃止されます

APIバージョンの廃止:

グラフAPIに関するFacebookのバージョン管理スケジュールの一環として、今後の廃止予定にご注意ください。

グラフAPI

  • 2026年9月24日: グラフAPI v20.0が廃止され、プラットフォームから削除されます。
  • 2027年1月21日: グラフAPI v21.0が廃止され、プラットフォームから削除されます。

支障が出ないように、すべての呼び出しを最新のAPIバージョンに移行してください。


ニュースレターを購読

月刊ニュースレターに登録して、Meta for Developersの最新情報をチェックしましょう。

登録する