バージョン3.1

2018年7月26日リリース | 2020年10月27日まで利用可能 | ブログ投稿

一般
Live API
マーケティングAPI
Messengerプラットフォーム
共通の友達API
ページAPI
Webhooks

一般

これらの変更点はv3.1以降に適用され、2018年10月24日にすべてのバージョンに適用予定です。

すべてのグラフAPIエンドポイントが{}のようなすべて空の構造と[]のようなすべて空のリストを返すようになりました。

Live API

これらの変更点はv3.1以降に適用され、2018年10月24日にすべてのバージョンに適用予定です。

typeパラメーターは、次のエッジに関して廃止されました。このパラメーターは、新しいsourceパラメーターに置き換えられました。

/event/live_videos
/group/live_videos
/official_events/live_videos
/page/live_videos
/user/live_videos

新しいsourceパラメーターは、指定可能な値としてtargetとownerのいずれかを受け入れます。source=targetを指定してノードの/live_videosエッジを照会すると、そのノードに対してストリーミングしたライブ動画が返されます、source=ownerを照会する場合には、そのノードによってストリーミングされたライブ動画が返されます。

イベントノードとグループノードがサポートするのはtargetクエリのみで、ターゲットノードを表示するアクセス許可がない場合には一部のtargetクエリが失敗します。

マーケティングAPI

2018年7月26日リリース | 2019年5月14日まで利用可能 | ブログ投稿

広告管理

行動ベースのターゲット設定カテゴリ - behaviorsで使用されている行動ベースのターゲット設定オプションの一部を廃止しました。それらのカテゴリのいずれかで広告を作成しようとすると、「The category you selected is no longer available.」というエラーになります。ターゲット設定に使用できる有効なカテゴリを確認するには、ターゲット検索を使用してください。
optimization_goalとしてのPAGE_ENGAGEMENTを廃止 - 広告キャンペーンのoptimization_goalとしてのPAGE_ENGAGEMENTを廃止しました。v3.1以降では、optimization_goalをPAGE_ENGAGEMENTに設定した広告キャンペーンを作成、更新、複製することができなくなりました。v3.1より前に作成した既存の広告キャンペーンがそのような設定になっている場合、それらのキャンペーンはまだ実行することができます。また、PAGE_ENGAGEMENTは、このoptimization_goalを使用した既存の広告キャンペーンのデータに対するインサイトAPIの内訳としても、まだ使用できます。
投稿を伴わない単一画像によるページへの「いいね！」広告を廃止 - v3.1以降では、ページ投稿を伴わない単一画像によるページへの「いいね！」広告を作成できなくなりました。代わりに、投稿を伴うページへの「いいね！」広告を作成する必要があります。広告素材、配置、プレビュー、ページへの「いいね！」広告の作成をご覧ください。

Webhooksを介した開発層用のリード獲得広告の取得を停止 - リード獲得広告フォームで収集したデータをWebhooksを介して開発モードのアプリに送信する処理を停止する予定です。この変更は、2019年2月1日から実施されます。
- v3.1でアップデートを購読する場合、アプリが本番環境でライブモードにある場合にのみ、アップデートが送信されます。
- v3.1が使用可能になった後で新しいアプリを作成した場合、アプリが本番環境でライブモードにある場合にのみ、アップデートが送信されます。
- 既存のアプリについては、2019年2月1日までにライブモードにする必要があります。その日までは、引き続き開発モードでアップデートを受信できます。
マーケティングAPIのアクセス層とアプリモードについて詳しくは、マーケティングAPIアクセスのための新しい構造とマーケティングAPI、アクセスと認証をご覧ください。

広告インサイトと効果測定

インサイトAPIのcost_per_store_visitとstore_visitsの名前がcost_per_store_visit_actionsとstore_visit_actionsに変更されました。これにより影響を受けるのは、次の項目です。
- GET {adaccount-id}/insights
- GET {campaign-id}/insights
- GET {adset-id}/insights
- GET {ad-id}/insights
- POST {adaccount-id}/insights
- POST {campaign-id}/insights
- POST {adset-id}/insights
- POST {ad-id}/insights
新しい名前の指標について詳しくは、来店数、測定をご覧ください。来店数APIと関連ドキュメントは、利用が制限されていることにご注意ください。アクセスについては、Facebook担当者にお問い合わせください。

ビジネスマネージャAPI

v3.1では、現在の役割ベースのアクセス許可に置き換わるものとして、タスクベースのアクセス許可という新しい概念が導入されます。これは、ビジネスマネージャAPIによって管理された広告アカウントや、ページへのアクセスに影響を与えます。広告アカウントやページへの役割ベースのアクセスはまだ利用可能ですが、将来的には廃止されます。広告アカウントでは、次の役割が影響を受け、次の同等のタスクが提供されます。

役割	タスク	説明
`ADMIN`	`['MANAGE', 'ADVERTISE', 'ANALYZE']`	広告キャンペーン、レポート、請求、広告アカウントアクセス許可のすべての側面を管理します。
`GENERAL_USER`	`['ADVERTISE', 'ANALYZE']`	広告アカウントに関連付けられた支払い方法を使用して広告を作成します。レポートを実行します。
`GENERAL_USER`	`['ANALYZE']`	レポートを実行します。

ビジネスマネージャAPIでは、次の役割が以下のタスクに置き換えられます。

役割	タスク
`MANAGER`	`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`
`CONTENT_CREATOR`	`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`
`MODERATOR`	`['MODERATE', 'ADVERTISE', 'ANALYZE']`
`ADVERTISER`	`['ADVERTISE', 'ANALYZE']`
`INSIGHTS_ANALYST`	`['ANALYZE']`

Facebookピクセルの管理では、次の役割に影響が及び、次の新しいタスクが導入されます。

役割	タスク
`PIXEL_EDITOR`	`['EDIT', 'ANALYZE']`
`PIXEL_ANALYST`	`['ANALYZE']`

この変更の一環として、ビジネス管理APIの次のフィールドが廃止され、以下のフィールドに置き換えられます。

分野	廃止	新しいフィールド
`GET {adaccount-id}/users`	`permissions`、`role`	`tasks`
`POST {adaccount-id}/users`	`role`、`uidRoles`、`emailRoles`	`tasks`
`GET {user-id}/adaccounts`	`permissions`、`role`	`tasks`
`GET {user-id}/assigned_ad_accounts`	`role`、`permitted_role`	`tasks`、`permitted_tasks`
`GET {user-id}/assigned_pages`	`role`、`permitted_role`	`tasks`、`permitted_tasks`
`GET {adaccount-id}/assigned_users`	`role`、`permitted_role`	`tasks`、`permitted_tasks`
`POST {adaccount-id}/assigned_users`	`role`	`tasks`
`GET {page-id}/assigned_users`	`role`、`permitted_role`	`tasks`、`permitted_tasks`
`POST {page-id}/assigned_users`	`role`	`tasks`
`GET {fb-pixel-id}/assigned_users`	`role`、`permitted_role`	`tasks`、`permitted_tasks`
`GET {adaccount-id}/userpermissions`	`role`	`tasks`
`POST {adaccount-id}/userpermissions`	`role`	`tasks`
`GET {page-id}/userpermissions`	`role`	`tasks`
`POST {page-id}/userpermissions`	`role`	`tasks`
`GET {business-id}/client_ad_accounts`	`permitted_role`	`permitted_tasks`
`POST {business-id}/client_ad_accounts`	`permitted_role`	`permitted_tasks`
`GET {business-id}/client_pages`	`permitted_role`	`permitted_tasks`
`POST {business-id}/client_pages`	`permitted_role`	`permitted_tasks`
`GET {business-id}/client_pixels`	`permitted_role`	`permitted_tasks`
`GET {adaccount-id}/agencies`	`permitted_role`	`permitted_tasks`
`POST {adaccount-id}/agencies`	`permitted_role`	`permitted_tasks`
`GET {page-id}/agencies`	`permitted_role`	`permitted_tasks`
`POST {page-id}/agencies`	`permitted_role`	`permitted_tasks`
`GET {business-id}/pending_client_pages`	`permitted_role`	`permitted_tasks`
`GET {business-id}/pending_client_ad_accounts`	`permitted_role`	`permitted_tasks`

この新しいデザインは、ページAPIにも影響を与えます。グラフAPI 3.1、ページAPI、重要な変更をご覧ください。ビジネスマネージャAPIのドキュメントについては、以下をご覧ください。

Messengerプラットフォーム

2018年7月26日より前に作成されたアプリの場合、これらの変更内容は2019年1月8日に有効になります。2018年7月26日以降に作成されたアプリの場合、これらの変更内容は直ちに有効になります。

ユーザープロフィールAPIは、デフォルトでは、first_name、last_name、profile_picフィールドのみを返すようになりました。その他のフィールドに関しては、アプリダッシュボードの[Messengerプラットフォーム]タブを通じて製品レビューを受けることが必要になりました。

last_ad_referralフィールドとis_payment_enabledフィールドは廃止されました。2018年10月30日にAPIから削除されます。

共通の友達API

これらの変更点はv3.1以降に適用され、2018年10月24日にすべてのバージョンに適用予定です。

共通の友達APIは2018年4月4日に廃止され、以下に示すエンドポイントは空のデータセットを返すようになりました。これらのエンドポイントは完全に廃止され、エラーを返すようになります。

/user-context/all_mutual_friends
/user-context/mutual_friends
/user-context/three_degree_mutual_friends

ページAPI

アクセス許可

これらの変更点はv3.1以降に適用され、2019年2月1日にすべてのバージョンに適用予定です。

pages_manage_ctaアクセス許可には、すべてのPOSTリクエストとDELETE リクエストに関してアプリレビューが必要になりました。2018年7月26日より前に作成されたアプリはこのアクセス許可を引き続き使用できますが、pages_manage_ctaの使用を継続するには2019年2月1日より前にレビューを申請する必要があります。

ページの管理権限

これらの変更点はv3.1以降に適用されます。

ページの管理権限は廃止が進行中であり、ページタスクに置き換えられています。ページの管理権限をユーザーに許可するのではなく、同等のタスクをユーザーに許可することが必要になりました。

役割	同等のタスク
`Admin`	`ADVERTISE`、`ANALYZE`、`CREATE_CONTENT`、`MANAGE`、`MODERATE`
`Advertiser`	`ADVERTISE`、`ANALYZE`
`Analyst`	`ANALYZE`
`Editor`	`ADVERTISE`、`ANALYZE`、`CREATE_CONTENT`、`MODERATE`
`Moderator`	`ADVERTISE`、`ANALYZE`、`MODERATE`

役割ベースのアクセス許可がタスクベースのアクセス許可に完全に置き換えられるまでは、/page/rolesを使用してタスクを許可する場合、特定の役割の同等のタスクすべてを許可する必要があります。許可しないと、POST操作が失敗します。

これらの変更点をサポートするため、permsフィールドとroleフィールドは廃止され、新しいtasksフィールドに置き換えられました。この変更による影響を受けるのは、以下のエッジです。

/me/accounts
/page/roles
/user/accounts

これらの変更点がマーケティングAPIとビジネスマネージャAPIに与える影響についてはマーケティングAPI更新履歴をご覧ください。

Webhooks

これらの変更点はv3.1以降に適用され、2018年10月24日にすべてのバージョンに適用予定です。

以下のユーザーWebhookフィールドが廃止されました。

pic_big_with_logo
pic_small_with_logo
pic_square_with_logo
pic_with_logo

以下のユーザーWebhookフィールドでは、HTTPではなくHTTPS URLが使用されるようになりました。

pic
pic_big
pic_small
pic_square
picture

また、これらのフィールドのURLには有効期限が設定されます。この点はすべてのAPIバージョンで直ちに有効になります。