Business Management APIs

クリエイティブフォルダーの共有

リクエストを送信して、ビジネスにクリエイティブフォルダーの共有を依頼します。{business-creative-folder-id}/agenciesにPOSTリクエストを送信し、permitted_tasksをMANAGE_CONTENTに割り当てます。このアクションにはbusiness_creative_management権限が必要です。

例 — フォルダー内のクリエイティブアセットのインサイトを閲覧するためにVIEW_INSIGHTSの権限が追加されました。

curl -X POST \
  -F 'permitted_tasks=['MANAGE_CONTENT','VIEW_INSIGHTS']' \
  -F 'business={partner-business-id} ' \
  -F 'access_token={access-token}' \
     https://graph.facebook.com/<API_VERSION>/<BUSINESS_CREATIVE_FOLDER_ID>/agencies

応答 — ビジネスがフォルダーをあなたと共有し、あなたからの共有リクエストを受け入れた場合。

{ "success": true }

応答 — ビジネスがまだ共有リクエストを受け入れていない場合。

{
  "success": true,
  "share_status": "In Progress"
}

進行中のリクエストを見る

応答のないすべてのパートナーシップ契約を一覧表示するには、{business-id}/received_sharing_agreementsにリクエストを送信し、request_statusをIN_PROGRESSに設定します。このアクションにはbusiness_creative_management権限が必要です。

curl -i -X GET "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/received_sharing_agreements
     ?request_status=IN_PROGRESS
     &access_token={access-token}"

リクエストを受け入れる

business_sharing_agreement_request_idにPOSTを送信し、request_statusをAPPROVEに設定することで、共有リクエストを受け入れることができます。これは、自分のビジネスに対して、誰かが初めてフォルダーを共有した時にのみ実行する必要があります。

このアクションにはbusiness_management権限が必要です。

curl -X POST \
     -F 'request_status=APPROVE' \
     -F 'access_token={access-token}' \
     https://graph.facebook.com/<API_VERSION>/<BUSINESS_SHARING_AGREEMENT_REQUEST_ID>

応答

{ "success": true }

または、保留中のリクエストを表示するには、[ビジネスマネージャの設定] > [リクエスト] > [受信したリクエスト]に移動します。

フォルダーの共有

広告を作成するエージェンシーやパートナーがいる場合は、クリエイティブフォルダーを共有すべきです。開発者は、広告主がフォルダーを別のビジネスと共有できるようにフローを構築することもできます。

アプリはPOSTリクエストをcreative_folder_id/agenciesに送信し、businessフィールドをパートナーのビジネスIDに設定し、permitted_tasksフィールドをMANAGE_CONTENTに設定する必要があります。このアクションにはbusiness_creative_management権限が必要です。

例 — アプリのユーザーがフォルダー内のクリエイティブアセットのインサイトを閲覧できるVIEW_INSIGHTS権限を追加。

curl -X POST \
  -F 'permitted_tasks=['MANAGE_CONTENT','VIEW_INSIGHTS']' \
  -F 'business={partner-business-id}' \
  -F 'access_token={access-token}' \
  https://graph.facebook.com/<API_VERSION>/<BUSINESS_CREATIVE_FOLDER_ID>/agencies

応答

{
  "success":true,
  "share_status": "In Progress"
}