開発者向けニュースに戻る

Introducing Facebook Graph API v10.0 and Marketing API v10.0

2021年2月23日作成者:Kirk Thaker

本日、FacebookはグラフAPI v10.0とマーケティングAPI v10.0をリリースします。

このリリースには、アプリとFacebookプラットフォームを統合する方法に影響する可能性がある多くのお知らせ、アップデート、廃止、および「廃止の解除」が含まれています。この投稿では、これらの更新情報に加えて、該当する場合にビジネスの中断を避けるために開発者が実行する必要がある手順の概要を説明します。

すべての変更に関する詳細情報を以下に示します。技術仕様については、v10.0の更新履歴をご覧ください。

Facebookの開発者プラットフォームの詳細については、プラットフォーム主導のハブを参照してください。

お知らせとアップデート

データの使用状況の確認の証明

FacebookプラットフォームAPIの利用を続けるには、登録から60日以内にデータの使用状況の確認(DUC)を実施してください。DUCを実施するには、アプリダッシュボードの[マイアプリ]ページに移動します。

昨年の秋、Facebookはデータの使用状況の確認(DUC)を導入しました。これは、開発者がAPIアクセスとデータ使用についてFacebookのプラットフォーム規約および開発者ポリシーを遵守していることを証明するための年度ごとの要件を新たに規定したものです。

すべてのアプリに段階的にロールアウトするFacebookのプロセスの一環として、開発者に期限日と詳細な手順を連絡します。この連絡は、開発者アラート、登録された連絡先アドレスへのメール、アプリダッシュボードの必要なアクションのリストに表示される通知によって行われます。

DUCを実施するための詳細な手順については、開発者向けドキュメントを参照してください。また、よくある質問のDUCに関するセクションもご覧ください。

グループAPIの90日間のデータアクセスレベルとデータ制限:

2021年5月24日以降、グループAPIを利用する場合、アプリの利用可能なデータアクセス期間が90日に制限されます。

また、消費者アプリでは、アプリが開発モードにあるかライブモードにあるかに基づいて階層化されるグループAPIアクセスを導入します。グループAPIのアクセス許可は、ビジネスアプリの標準アクセスおよび詳細アクセスと同様に動作するようになります。

現在、開発モードのアプリは、公開グループと開発者が管理者であるプライベートグループのすべてのコンテンツにアクセスできます。それらのアプリは、アプリレビューが完了すると、アプリをインストールしたグループのすべてのコンテンツにアクセスできます。

2021年5月24日以降、開発モードのアプリは、公開グループと開発者が管理者であるプライベートグループの自分が所有するコンテンツにしかアクセスできなくなります。つまり、他のグループユーザー(アプリの役割を持たないユーザー)が公開したコンテンツ(投稿やコメントなど)にはアクセスできません。

詳細については、v10.0の更新履歴をご覧ください。

ビジネスアプリのpublic_profileアクセス許可とemailアクセス許可のアクセスレベル

ユーザーデータを安全に保護するための継続的な方針の一環として、新規および既存のビジネスタイプのアプリ向けにグラフAPI v8.0で発表したアクセスレベルモデルに、public_profile (デフォルト公開プロフィールフィールド)アクセス許可とemailアクセス許可が追加されました。

新しく作成されるビジネスタイプのアプリには、public_profileアクセス許可とemailアクセス許可を含む標準アクセスが最初に設定されます。アプリにpublic_profileへの標準アクセスが設定されている場合、アプリに関する役割またはアプリを申請したビジネス内の役割を持つユーザーのみがアプリの検索またはログインを行えます。外部ユーザーがアプリにログインする必要がある場合、アプリ管理者はアプリダッシュボードで詳細アクセスをリクエストできます。このアクセスは自動的に許可されます。

詳細については、v10.0の更新履歴をご覧ください。

データ削除リクエストのリマインダー

2020年11月10日にお知らせしたように、消費者タイプとゲームタイプのアプリについてアプリレビューを申請する場合、または開発モードからライブモードに移行する場合は、データ削除リクエストのコールバックを提供するか、ユーザーが自分のデータの削除をリクエストする方法を明示的に示すURLを表示する必要があります。Facebookはこの要件を2022年11月10日までに適用することを予定しており、適用の60日前に、アプリ開発者にリマインダーを送ります。

データ保持削減プロジェクトに基づくグラフAdsInsight APIのオプションの変更

広告マネージャのUIは、保持期間が37か月を超える広告インサイト指標データのレポート作成をサポートしなくなります。保持期間が37か月を超える日付範囲がリクエストに含まれている場合、APIはエラーを返します。「date_preset = lifetime」は無効になり、「date_preset = maximum」に置き換えられます。

AdsInsightに対するグラフAPI v10.0の変更は、「date_preset = lifetime」を除いて、90日後にグラフAPIの他のすべてのバージョンに適用されます。呼び出される特定のフィールドを変更する必要はありません。プリセット機能が組み込まれ、すべての「lifetime」呼び出しにデフォルトで最大37か月の保持期間が設定されます。

この変更は、広告クリエイティブ、オーディエンス、配信設定、または広告オブジェクト名に関連するデータには影響せず、既存の指標の計算に変更はありません。この変更は、広告マネージャ、広告レポート、軽量広告エクスペリエンスなどの広告レポートのサーフェス全体に適用されます。

  • リリース日 - 2021年2月23日:
    • バージョン10.0
      • 「date_preset = maximum」が有効になります
      • 「date_preset = lifetime」が無効になります
      • 保持期間が37か月を超える明示的な日付範囲がリクエストに含まれている場合、エラーが返されます
    • バージョン9.0以下
      • 現在の機能に変更はありません
  • リリース後90日 - 2021年5月24日:
    • バージョン9.0以下
      • 「date_preset = maximum」が有効になります(新しいバージョンと同じ)
      • 保持期間が37か月を超える明示的な日付範囲がリクエストに含まれている場合、エラーが返されます(新しいバージョンと同じ)
      • 「date_preset = lifetime」は引き続き動作しますが、過去37か月以内のデータのみを返します(つまり、「maximum」と同様に動作します)

詳細については、v10.0の更新履歴をご覧ください。

ThreatExchangeの外部所有データに関する新しい削除ポリシー

2021年5月24日以降、パートナーがThreatExchangeにアップロードするデータにexpire_timeを設定すると、指定された有効期限でデータが「ハードデリート」されます。データが無効になったことを指定したい場合は、「expired_on」フィールドを設定すると、自動的に削除されます。

従来の「ソフトデリート」は、有効期限が切れたコンテンツに期限切れのラベルを付けることを意味していました。今後、ソフトデリートはサポートされません。有効期限が切れたコンテンツはハードデリートされ、ThreatExchangeに表示されなくなります。

さらに、ThreatExchange内のFacebook以外のすべてのThreatDescriptorは、有効期限が切れるとハードデリートされます。有効期限は、引き続きThreatDescriptorの作成者によって設定されます。今後、Facebookによって作成されていないすべての期限切れのThreatDescriptorで、削除が開始されます。このポリシーが適用されたときに削除されたくない期限切れのThreatDescriptorが現在アプリにある場合は、有効期限を延長するか「0」に設定して、データが期限切れにならないようにしてください。

変更の詳細については、こちらをクリックしてください

新しいAPIにおけるターゲット設定の変更

2021年5月24日以降、類似カスタムオーディエンスを作成する際に、APIのすべてのバージョンでlocation_specパラメーターとcountryパラメーターが要求されなくなります。

類似オーディエンスを作成する際、ユーザーは類似ソースと希望する比率を選択します。類似オーディエンスの場所は、キャンペーンのターゲット設定仕様の国の場所によって決定されます。この変更は、既存のキャンペーンには影響しません。新規のキャンペーンと編集されるキャンペーンにのみ影響します。

新しいプラットフォームライブステータスページの導入

新しいFacebookのビジネスステータスページは、透明性を高め、Facebookのプラットフォーム製品を使用する外部開発者との事前のコミュニケーションを活性化するために役立ちます。このページは、Facebookのビジネス製品(広告、WhatsApp Business API、Facebook開発者プラットフォームなど)のプラットフォームステータスを一元的に確認する場所として利用できます。現在、このページは広告マネージャとWhatsapp Business APIで利用可能です。その他のビジネス製品は、2021年5月に追加される予定です。

廃止

[ライブ配信を開始]ダイアログの廃止

2021年5月24日に、[ライブ配信を開始]ダイアログ(GLD) SDKが廃止されます。この従来のライブプロダクションツールの廃止は、APIのすべてのバージョンで行われます。この変更は、Facebookでのライブ一斉配信にのみ影響します。開発者は、すべてのカスタマイズされたライブプロダクションソリューションについて、Live ProducerLive APIを使用することをおすすめします。

GLD SDKの廃止後にライブ配信を行うためのソリューション:

  • facebook.com/live/producer (または、ページ/プロフィールの「ライブ動画」ボタンなど、Facebookの他のエントリポイント)から直接Live Producerにアクセスする
  • すべてのカスタムソリューションをLive APIと統合する

詳細については、v10.0の更新履歴をご覧ください。

接続ターゲット設定の廃止

2021年5月24日以降、広告セットの作成/編集時に、接続ターゲット設定がサポートされなくなります。この要件は、新規のキャンペーンと編集されるキャンペーンにのみ影響し、既存のキャンペーンには影響しません。

詳細については、v10.0の更新履歴をご覧ください。

廃止の解除

廃止が解除されるエンドポイント - gr:delete:Page/tabs

グラフAPI v8.0のリリース時に、[ページ]タブ用のgr:delete:Page/tabsエンドポイントが廃止されました。グラフAPI v10.0では、このエンドポイントを直ちに復活させることが決定しました。他のすべてのグラフAPIバージョンでは、2021年5月24日に再びアクセスが可能になります。

詳細については、v10.0の更新履歴をご覧ください。

廃止が解除されるエンドポイント - gr:post:Business/business_users、gr:post:Business/system_users、and gr:post:User/access_tokens

グラフAPI v9.0のリリース時に、次の3つのビジネスエンドポイントへのアクセスが制限されました。

  • gr:post:Business/business_users
  • gr:post:Business/system_users
  • gr:post:User/access_tokens

グラフAPI v10.0がリリースされた時点で、アプリが次の2つの条件のいずれかを満たす場合、API呼び出しに対してこれらのエンドポイントを再びオープンします。

  • ターゲットビジネスは、呼び出し元アプリの所有ビジネスです
  • ターゲットビジネスは、呼び出し元アプリの所有ビジネスの(ビジネス2層モデルの)子ビジネスです

詳細については、v10.0の更新履歴をご覧ください。

アクションアイテムのカレンダー

マーケティングAPIバージョンの廃止:

マーケティングAPIのバージョン管理スケジュールに基づく今後のマーケティングAPIバージョンの廃止に注意してください。

  • 2021年3月3日:マーケティングAPI v7.0が廃止され、プラットフォームから削除されます
  • 2021年5月4日:マーケティングAPI v8.0が廃止され、プラットフォームから削除されます
  • 2021年8月25日:マーケティングAPI v9.0が廃止され、プラットフォームから削除されます

ビジネスの中断を避けるため、すべての呼び出しを本日リリースされた最新のマーケティングAPIバージョンに移行することをおすすめします(詳細については、更新履歴をご覧ください)。

グラフAPIバージョンの廃止:

グラフAPIのバージョン管理スケジュールに基づく以下のグラフAPIバージョンの廃止に注意してください。

  • 2021年5月4日:グラフAPI v3.2が廃止され、プラットフォームから削除されます
  • 2021年8月3日:グラフAPI v3.3が廃止され、プラットフォームから削除されます

一般的な廃止

  • 2021年5月24日:
    • [ライブ配信を開始]ダイアログが廃止され、プラットフォームから削除されます
    • 接続ターゲット設定が廃止され、プラットフォームから削除されます

必要な開発者アクション

  • ローリング登録:データの使用状況の確認の証明
    • 登録後60日以内に、データの使用状況の確認を実施する必要があります
    • よくある質問のDUCに関するセクションをご覧ください
  • 2021年2月23日:グラフAdsInsight APIの変更がグラフAPI v10.0でのみ導入されます
  • 2021年5月24日:
    • グラフAdsInsight APIの変更がグラフAPI v9.0以下で導入されます
    • アプリレビューに基づくアクセスレベルの変更が適用されます
      • グループAPIのデータアクセス期間が90日に制限されます
      • グループAPIの階層化されたデータレベルが実装されます
      • ビジネスアプリのpublic_profileアクセス許可とemailアクセス許可の変更が適用されます
    • ThreatExchangeの新しい「ハードデリート」データポリシーが実装されます
  • 2022年11月10日:データ削除リクエストに関する期限