Business Management APIs

Membagikan Folder Materi Iklan

Minta bisnis untuk membagikan folder materi iklan mereka dengan cara mengirimkan permintaan. Kirim permintaan POST ke {business-creative-folder-id}/agencies dan terapkan permitted_tasks ke MANAGE_CONTENT. Anda memerlukan izin business_creative_management untuk melakukan tindakan ini.

Contoh — Izin VIEW_INSIGHTS ditambahkan untuk melihat insight bagi aset materi iklan di folder ini:

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

Tanggapan — Jika sebuah bisnis membagikan folder dengan Anda, dan mereka menerima permintaan berbagi dari Anda:

{ "success": true }

Tanggapan — Jika bisnis belum menerima permintaan berbagi:

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

Melihat Permintaan Dalam Proses

Untuk mendapatkan daftar semua perjanjian kemitraan yang tidak memiliki tanggapan, kirim permintaan ke {business-id}/received_sharing_agreements dan atur request_status ke IN_PROGRESS. Anda memerlukan izin business_creative_management untuk melakukan tindakan ini.

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

Menerima Permintaan

Anda dapat menerima permintaan berbagi dengan mengirimkan POST ke business_sharing_agreement_request_id dan mengatur request_status ke APPROVE. Anda hanya perlu melakukan ini saat pertama kali seseorang berbagi folder dengan bisnis Anda.

Anda memerlukan izin business_management untuk melakukan tindakan ini:

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

Tanggapan

{ "success": true }

Atau, untuk melihat permintaan yang tertunda, buka Pengaturan Pengelola Bisnis > Permintaan > Permintaan yang Didapatkan.

Membagikan Folder

Jika iklan Anda dibuatkan oleh agensi atau mitra, sebaiknya Anda membagikan folder materi iklan Anda. Developer juga dapat membuat alur agar pengiklan dapat berbagi folder ke bisnis lain.

Aplikasi Anda dapat mengirim permintaan POST ke creative_folder_id/agencies dan mengatur kolom business ke ID bisnis mitra dan kolom permitted_tasks ke MANAGE_CONTENT. Anda memerlukan izin business_creative_management untuk melakukan tindakan ini.

Contoh — Tambahkan izin VIEW_INSIGHTS agar pengguna aplikasi dapat melihat insight untuk aset materi iklan di folder ini:

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

Tanggapan

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