Version 8.0

グラフAPI

2020年8月4日リリース | 2022年11月1日まで利用可能 | ブログ投稿

アクセストークン

廃止されたエンドポイント

v8.0以降で廃止。2020年11月2日にすべてのバージョンで廃止される予定です。

• GET /token_deprecation_check

アルバム

再導入されたエンドポイント

すべてのバージョンに適用。

• GET /{album-id}/likes

アプリ構成

アプリタイプ

この変更はすべてのバージョンに適用されます。

新しく作成するアプリで、次のアプリタイプを選択できるようになりました: ビジネス、ゲーム、なし。これにより、選択したタイプに基づいて不適切なアクセス許可と機能が削除され、アプリレビューのインターフェイスが簡素化されます。さらに、ビジネスアプリとしてタイプが指定されたアプリは、新しい認証メカニズムを使用し、今後はモードを使用しなくなります。また、新しい機能にアクセスできます。詳しくは、ビジネスアプリの更新履歴の項目をご覧ください。

ビジネスアプリ

ビジネスアプリとしてタイプが指定されたアプリは、アクセスレベルと呼ばれる新しい認証メカニズムを使用します。アクセスレベルは、ビジネスアプリで廃止された開発モードとライブモードで提供されていた機能に代わる機能を提供します。これにより、アプリレビュープロセスがよりシンプルで直感的になります。さらに、新しいビジネスアセットユーザープロフィールアクセス機能がリリースされました。この機能を使用して、ビジネスアプリは公開ユーザーフィールドの小規模なセットを読み取ることができます。これらの変更について、以下で詳しく説明します。

アクセスレベル

すべてのバージョンに適用。

アクセスレベルは、アクセス許可と機能に個別に適用される、ビジネスアプリ用の新しいグラフAPI認証メカニズムです。標準アクセスでは、アプリに関する役割またはアプリを申請したビジネス内の役割を持つユーザーが所有するデータへのアクセスのみが許可されます。Advanced Accessでは、任意のアプリユーザーが所有するデータへのアクセスが許可されますが、アプリレビューが必要です。ビジネスアプリでは、このアプリタイプで使用できるすべてのアクセス許可と機能に対する標準アクセスが自動的に付与されます。

開発モードとライブモードの廃止

すべてのバージョンに適用。

ビジネスアプリとしてタイプが指定されたアプリでは、開発モードとライブモードが廃止されました。これらのモードは、同じ機能をより幅広い目的で使用できるアクセスレベルに置き換えられました。ビジネスアプリには、利用可能なすべてのアクセス許可と機能に対する標準アクセスが付与されるため、アプリに関する役割またはアプリを申請したビジネス内の役割を持つすべてのユーザーは、利用可能なアクセス許可をいつでもアプリに付与できます。これにより、アプリレビューの必要がなくなり、開発中のモードの切り替えが不要になります。

新しいビジネスアセットユーザープロフィールアクセス機能

すべてのバージョンに適用。

新しいビジネスアセットユーザープロフィールアクセス機能を使用すると、アプリを申請したビジネスが所有するアセットをユーザーが使用している限り、ビジネスアプリはユーザーの公開フィールドの小規模なセットを読み取ることができます。読み取り可能なユーザーフィールドのリストについては、ビジネスアセットユーザープロフィールアクセスのリファレンスをご覧ください。

コメント

再導入されたエンドポイント

すべてのバージョンに適用。

• GET /{comment-id}/likes

デバイス

廃止されたエンドポイント

v8.0以降で廃止。2020年11月2日にすべてのバージョンで廃止される予定です。

• POST /device/share

グループ

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{group-id}/posts

v8.0以降で廃止。2020年11月2日にすべてのバージョンで廃止される予定です。

• GET /{group-post-id}/likes

Instagram

新しいInstagram oEmbedエンドポイント

すべてのバージョンに適用。

新しいGET /instagram_oembedエンドポイントが導入されました。このエンドポイントは、Instagramの従来型のoEmbedエンドポイント(2020年10月24日に廃止)と同じ機能を提供します。新しいエンドポイントではアクセストークンが要求されるため、アクセスするにはFacebook開発者アカウントと登録済みアプリが必要です。使用方法とその他の詳細情報については、Instagram oEmbedのドキュメントをご覧ください。

ライフイベント

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{life-event-id}
• GET /{life-events-id}/photos

リンク

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{link-id}/reactions

ライブ動画

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{live-video-id}/likes

ライブ動画の「いいね！」を取得するには、GET /{live-video-id}/reactionsエンドポイントを使用してください。

save_vodパラメーター

v8.0以降に適用。2020年11月2日にすべてのバージョンに適用される予定です。

save_vodパラメーターは以下のエッジで廃止されます。

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Messengerプラットフォーム

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

アプリレビュー

すべてのバージョンに適用。

Messengerのアプリレビューは、アプリダッシュボードの[製品] > [Messenger] > [設定]から[アプリレビュー]に移動されました。Messenger固有のアクセス許可であるpages_messaging、pages_user_gender、pages_user_locale、pages_user_timezoneをリクエストするには、[アプリレビュー] > [アクセス許可と機能]にアクセスします。詳しくは、Messengerのアプリレビューに関するドキュメントをご覧ください。

Messengerプロフィールエッジ

v8.0以降に適用。

POST /{page-id}/messenger_profileで、ネストされた永続メニュータイプが廃止されました。

新機能: Messenger for Shops

v8.0以降に適用。

Messenger for Shops上の商品の送受信をサポートします。メッセージで商品を送信するために使用できる商品テンプレート、商品テンプレートを使用したメッセージとFacebookショップ商品詳細ページからのメッセージ用のWebhook、商品を含むメッセージ用のエコーWebhookがサポートされます。

• GET /{message_id}/access_requests
• POST {page_id}/message
• message_echo Webhook
• messages Webhook

ネイティブオファー

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

廃止されたエンドポイント

v8.0以降で廃止。2020年11月2日にすべてのバージョンで廃止される予定です。

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

ページ

廃止されたエンドポイント

v8.0以降で廃止。

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

ページ投稿

すべてのバージョンで廃止。

ページ投稿のコメントIDフォーマット{page-id}_{post_id}_{comment-id}が廃止されました。代わりに{pagepost-id}_{comment-id}フォーマットを使用してください。

写真

廃止されたエンドポイント

すべてのバージョンで廃止。

• GET /{photo-id}/sharedposts

スポット

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{place-information-id} (訂正をご覧ください)

投稿

廃止されたエンドポイント

v8.0以降で廃止。2020年11月2日にすべてのバージョンで廃止される予定です。

• GET /{post-id}/likes

投稿の「いいね！」を取得するには、GET /post/reactionsエンドポイントを使用してください。

検索

廃止されたエンドポイント

v8.0以降で廃止。2020年11月2日にすべてのバージョンで廃止される予定です。

• GET /search?type=place
• GET /search?type=audience_interest

セキュリティ設定

廃止されたフィールド

v8.0以降で廃止。2020年11月にすべてのバージョンで廃止される予定です。

• secure_browsing

ソーシャルプラグイン

Facebook oEmbedエンドポイント

この変更は2020年10月24日にすべてのバージョンに適用される予定です。

Facebookの公開投稿と公開動画にアプリでHTMLを埋め込むことができるFacebook oEmbedエンドポイントは、2020年10月24日に廃止されます。廃止されるエンドポイントと同じ機能を提供する以下の3つの新しいエンドポイントが導入されました。

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

新しいエンドポイントではアクセストークンが要求され、リクエストにはレート制限が適用されます。使用法の詳細とその他の情報については、新しいoEmbedエンドポイントのドキュメントをご覧ください。

ユーザー

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{user-id}/taggable_friends

廃止されたフィールド

v8.0以降で廃止。2020年11月にすべてのバージョンで廃止される予定です。

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

すべてのバージョンで廃止。

• can_review_measurement_request
• is_famedeeplinkinguser

再認証

この変更はすべてのバージョンに適用されます。

2020年10月24日以降、以下のフィールドでは、90日間アクティビティが行われない場合、データアクセスの再認証が必要になります。

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

ユーザー写真

2020年10月24日にすべてのバージョンに適用。

2020年10月24日以降、GET /{user-id}/pictureエンドポイント(GET /{user-id}?fields=picture)では、トークンレスリクエストに対してapp-scoped user ID (ASID)が要求されます。ASIDを持たないユーザーをクエリする場合は、アプリアクセストークン、クライアントアクセストークン、ユーザーアクセストークンのいずれかをリクエストに含める必要があります。詳しくは、ユーザー写真のリファレンスをご覧ください。

動画の質問

廃止されたエンドポイント

v8.0以降で廃止。

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

廃止されたエンドポイント

v8.0以降で廃止。2020年11月2日にすべてのバージョンで廃止される予定です。

• GET /{company-id}/access_requests
• GET /access_requests

マーケティングAPI

2020年8月4日リリース | 2021年5月4日まで利用可能 | ブログ投稿

広告アカウント

廃止されたエンドポイント

v8.0以降で廃止。

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

アクセス許可

v8.0以降に適用。2020年11月2日にすべてのバージョンに適用される予定です。

アプリが広告アカウントのビジネスフィールドにアクセスするには、詳細なアクセス許可が必要です。特定のビジネスオブジェクトに対するアクセス許可の付与が必要になります。

アセットのカスタマイズルール

検証

v8.0以降に適用。

asset_feed_specを使用するすべての広告には、少なくとも2つのターゲットカスタマイズルールが含まれていることが必要です。クリエイティブでasset_feed_specを使用しており、かつ、含まれているルールが2つに満たない場合、その広告を作成することはできません。

この変更は、配置アセットカスタマイズ、複数言語の広告、セグメントアセットカスタマイズに影響します。

セグメントアセットカスタマイズ

v8.0以降に適用。2020年11月2日にすべてのバージョンに適用される予定です。

セグメントアセットカスタマイズユーザーでは、地理的位置情報に関連しないすべての使用法が廃止されました。この変更に伴い、すべてのターゲット設定ルールで、カスタマイズスペックの内部に地理的位置情報が含まれることが必要になります。デフォルトルールの例外として、地理的位置情報を含める必要がない場合があります。

入札

ターゲット単価入札戦略

v8.0以降に適用

TARGET_COST入札戦略は廃止されました。その代わりとして、平均目標達成単価上限入札の使用をおすすめします。利用可能なすべての入札戦略については、こちらをご覧ください。

ビジネスマネージャ

廃止されたエンドポイント

v8.0以降で廃止。

• GET{system-user-id}/updated_by

再導入された共有同意書エンドポイント

すべてのバージョンに適用

以下のエンドポイントが再導入されました。

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

これらのエンドポイントは、グラフAPI V6.0がリリースされたときに廃止されました。

キャンバス

廃止されたエンドポイント

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

カタログAPI

アクセス許可

v8.0以降に適用。2021年1月31日にすべてのバージョンに適用される予定です。

製品カタログエンドポイントにアクセスする際、ads_managementアクセス許可が不要になりました。今後、これらのエンドポイントを呼び出すには、catalog_managementアクセス許可が必要になります。過去90日以内にads_managementを使用してカタログエンドポイントにアクセスした開発者は、2020年8月14日までに、catalog_managementアクセス許可に自動的に移行されます。

以前のバージョンのAPIを使用している開発者は、今から2021年2月28日までの間、ads_managementアクセス許可で引き続き製品カタログエンドポイントを呼び出すことができます。v8.0を使用している場合は、catalog_managementアクセス許可が必要です。

2月の期限を過ぎると、catalog_managementアクセス許可はads_managementに関連付けられなくなるため、ユーザーがcatalog_managementアクセス許可を明示的にアプリに付与する必要があります。

認証

v8.0以降に適用。2020年11月2日にすべてのバージョンに適用される予定です。

[アップデート]下記のカタログAPIエンドポイントで、二段階認証ビジネス設定が考慮されるようになりました。カタログを所有するビジネスが現在のアプリユーザーに二段階認証を要求する場合、アプリユーザーが二段階認証を行わないと、このエンドポイントを呼び出すアプリにエラーが返されます。

現在のアプリユーザーがパートナービジネスを通じてカタログにアクセスできる場合は、パートナーのビジネスマネージャからの認証要件が考慮されます。システムユーザーは、二段階認証を行う必要はありません。

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

レポート機能

廃止

v8.0以降に適用

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

ターゲット設定

廃止されたもの

v8.0以降に適用

• GET /search?type=adzipcode

修正点

• 2020年9月28日 — 明確化のためカタログAPI認証の項目を更新しました。
• 2020年10月23日 — カタログAPIの項目を次のように更新しました。

  • 以前のバージョンのAPIを使用している開発者が引き続きads_managementアクセス許可で製品カタログエンドポイントを呼び出せる期限を延長しました。新しい期限は2021年2月28日です。
  • 明確化のため、システムユーザー認証に関する説明を追加しました。
• 2021年5月17日 — 廃止されたエンドポイントをGET /{place-id}からGET /{place-information-id}に変更しました。GET /{place-id}は廃止されていません。