アセット管理の概要

ビジネスは複数のアセットにアクセスすることができます。アセットは、ビジネスが所有している場合とビジネスが代理店としてアクセスする場合があります。Facebookのビジネス管理アセットAPIを使用して、ビジネスとそのアセットとの関連を追加、削除、照会することや、ビジネスアセットを管理し、それにアクセスすることができます。

代理店とは、別のビジネスが所有する資産の管理やアクセスが可能なビジネスエンティティを指します。この関係により、代理店はクライアントに代わって特定のタスクやアクション(広告アカウント、ページ、その他のデジタルアセットの管理など)を実行できます。

ビジネスアセットグループ

ビジネスアセットグループを使用すると、大規模な広告主や広告代理店は、ビジネスにおけるユーザーやアセットを効率よく管理できるようになります。アセットやユーザーの編成は、実際の運用方法に則したやり方で行ってください。例えば、ブランド、地域、クライアント、または各企業で定められた組織上の原則に従って、アセットやユーザーを構成することが可能です。

ビジネスアセットグループには、広告アカウント、ページ、Metaピクセル、オフラインイベントセット、アプリ、カタログ、カスタムコンバージョン、Instagramアカウントを含めることができます。ビジネスはアセットを所有することも、広告代理店と共有してアセットへのアクセスを提供することもできます。

このAPIを使用すれば、ビジネスアセットグループにユーザーを追加できます。追加したユーザーには、ビジネスアセットグループ内のアセットへのアクセス許可を付与することが可能です。これにより、ビジネスレベルで管理者を多数設定しなくても、一度に複数のアセットへのアクセス許可を付与できます。

このAPIを使用すると、ビジネスマネージャを通じて誰かがすでに作成したビジネスアセットグループや、ビジネスアセットグループ内のアセットを管理することが可能です。次のことができます。

ビジネスに関連付けられたビジネスアセットグループのリストを取得する
ビジネスアセットグループを削除または名前を変更する
ビジネスアセットグループの全アセットを確認する
ビジネスアセットグループ内のアセットに対するユーザーのアクセス許可を取得、追加、編集、削除する
ビジネスアセットグループにユーザーを割り当てる
ビジネスアセットグループのアセットを取得、追加、削除する

アクセス許可

ビジネスアセットグループAPIを使うには、アプリに適切なマーケティングAPIアクセスレベルが必要です。

すべての追加および削除のエンドポイントでは、アクセストークンのユーザーがビジネスの管理者である必要があります。それ以外の場合、アクセスは拒否されます。
すべてのAPIエンドポイントで、アプリにbusiness_managementのアクセス許可が付与されている必要があります。

以下を行う場合は、追加のアクセス許可が必要です。

ビジネスアセットグループのエンドポイント	必要なアクセス許可
広告アカウントのリストを取得する	`ads_management`
商品カタログのリストを取得する、商品カタログを追加または削除する	`ads_management`
Instagramアカウントのリストを取得する、Instagramアカウントを追加または削除する	`ads_management`。マーケティングAPI v4.0を使用している場合は、`instagram_basic`も必要です。
ピクセルのリストを取得する	`ads_read`
オフラインイベントセットのリストを取得する	`ads_management`
カスタムコンバージョンのリストを取得する	`ads_read`
カスタムコンバージョンを追加する	`ads_management`

制限

次のAPI呼び出しによってビジネスアセットグループに含まれるアセットのアクセス許可を減らしたり削除したりすると、エラーが発生します。

/{page_id}/assigned_usersへのDELETEリクエスト
/{page_id}/assigned_usersへのPOSTリクエスト
/act_{ad_account_id}/assigned_usersへのDELETEリクエスト
/act_{ad_account_id}/assigned_usersへのPOSTリクエスト。

アクセス許可を減らす、または削除するには、以下の手順に従ってください。

呼び出しを行って、ビジネスに関連付けられたアセットグループのリストを取得します。contained_asset_idが{page_id}または{ad_account_id}と同じアセットグループを見つけてください。
返されたビジネスアセットグループのIDごとに、API呼び出しを行い、そのグループからユーザーを削除します。
その後、上記のDELETEまたはPOSTリクエストの呼び出しを行い、ページまたは広告アカウントで対象ユーザーへのアクセス許可を削除します。

ほかのビジネス向けにアプリでアクセス許可の管理機能を提供する場合は、APIとビジネスマネージャ間の相違やエラーを防ぐため、このAPIを使用してください。

ビジネスアセットグループを通じて、アプリ、カタログ、Instagramアカウント、カスタムコンバージョンへのアクセス許可を設定することはできません。この場合、アセットレベルでアクセス許可を割り当てる必要があります。

例えば、JasperのビジネスマネージャのビジネスアセットグループにRogerを追加すると、Rogerはビジネスアセットグループ内のすべてのページ、広告アカウント、ピクセルなどのアクセス許可を得ることができます。ただし、Jasperのビジネスアセットグループ内のアセットに対するRogerのアクセス許可を削除または編集するには、対象のビジネスアセットグループでこのアクションを実行する必要があります。

また、ページモデレーターを管理者に変更するなど、アセットAPIを使用して、アセットレベルでユーザーのアクセス許可を追加することも可能です。ページと広告アカウントの例をご覧ください。

2019年10月13日に、プロジェクトAPIはビジネスアセットグループに置き換えられました。プロジェクトAPIのすべてのアプリをビジネスアセットグループに移行していただく必要があります。

割り当て可能な役割

ユーザーをビジネスに追加したら、ビジネスユーザー APIを使って次の2つのロールのいずれかを割り当てることができます。

APIの定数	名前	説明
`ADMIN`	ビジネス管理者	アカウントの変更や削除、ユーザーの追加や削除など、ビジネスに関するあらゆる設定を管理できます。
`EMPLOYEE`	ビジネス従業員	ビジネス設定に関するすべての情報を閲覧できますが、変更はできません。ただし、ユーザー自身が管理者を務めるページまたは広告アカウントをビジネスに追加することはできます。

カタログ

カタログAPIを使うことで、ビジネスがアクセスできるカタログ上で、このビジネスの任意のユーザー(管理者または従業員)に対して次のロールを割り当てることができます。

APIの定数	名前	説明
`['MANAGE', 'ADVERTISE']`	カタログ管理者	完全な読み取りおよび書き込みのアクセス権を持ち、アイテムの作成、更新、削除、フィードの管理、カタログのピクセルやアプリへの添付、商品セットの作成、カタログによるAdvantage+ カタログ広告の実施、カタログ設定の変更など、カタログに関するあらゆる設定を管理できます。
`['ADVERTISE']`	カタログ広告主	商品セットを作成し、カタログによるAdvantage+ カタログ広告を実施できます。商品、フィード、カタログ設定を編集することはできません。

広告アカウント

広告アカウントAPIを使うことで、ビジネスがアクセスできる広告アカウントに関して、このビジネスの任意のユーザーに次のタスクを割り当てることができます。

APIの定数	名前	説明
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	広告アカウント管理者	キャンペーン、レポート、支払い、アカウントへのアクセス許可のすべてを管理でき、広告アカウントの費用上限を設定できます。広告アカウント管理者は、ビジネスの支払い方法の関連付けも行えます。
`['ADVERTISE', 'ANALYZE']`	広告アカウント広告主	広告を表示して編集したり、広告アカウントに関連付けられた支払い方法を使って広告を作成したりできます。
`['ANALYZE']`	広告アカウントアナリスト	広告のパフォーマンスを閲覧できます。

ページ

ページAPIを使って、このビジネスがアクセスできるページ上のビジネスのユーザーに次のタスクを割り当てることができます。

APIの定数	名前	説明
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	ページ管理者	ページの役割管理、ページを代表したメッセージの送信と投稿、広告作成、インサイトの閲覧を行えます。
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	ページ編集者	ページの編集、ページを代表したメッセージの送信と投稿、広告作成、インサイトの閲覧を行えます。
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	ページモデレーター	ページに寄せられたコメントへの返信や削除、ページを代表したメッセージの送信、広告作成、インサイトの閲覧を行えます。ページを代表した投稿は行えません。
`['ADVERTISE', 'ANALYZE']`	ページ広告管理者	ページの広告を作成し、インサイトを閲覧できます。ページを代表した投稿は行えません。
`['ANALYZE']`	ページアナリスト	インサイトを閲覧できます。ページを代表した投稿は行えません。

アプリ

ビジネスマネージャには、アプリに関する役割またはタスクを管理するAPIはありません。

Instagramアカウント

ビジネスマネージャには、Instagramアカウントに関する役割管理はありません。Instagramアカウントで広告を掲載できるのは、Instagramアカウントにリンクされた広告アカウントへのアクセス権を持つユーザーです。