Chia sẻ thư mục nội dung

Bạn có thể gửi yêu cầu để đề nghị doanh nghiệp chia sẻ thư mục nội dung của họ. Hãy gửi yêu cầu POST đến {business-creative-folder-id}/agencies và chỉ định permitted_tasks cho MANAGE_CONTENT. Bạn cần có quyền business_creative_management để thực hiện hành động này.

Ví dụ - Quyền VIEW_INSIGHTS được thêm để xem thông tin chi tiết về các tài sản nội dung trong thư mục:

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

Phản hồi - Nếu doanh nghiệp đã chia sẻ thư mục với bạn và chấp nhận yêu cầu chia sẻ của bạn:

{ "success": true }

Phản hồi - Nếu doanh nghiệp chưa chấp nhận yêu cầu chia sẻ:

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

Xem yêu cầu đang xử lý

Để liệt kê mọi thỏa thuận hợp tác chưa có phản hồi, hãy gửi yêu cầu đến {business-id}/received_sharing_agreements và đặt request_status thành IN_PROGRESS. Bạn cần có quyền business_creative_management để thực hiện hành động này.

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

Chấp nhận yêu cầu

Bạn có thể chấp nhận yêu cầu chia sẻ bằng cách gửi yêu cầu POST đến business_sharing_agreement_request_id và đặt request_status thành APPROVE. Bạn chỉ cần thực hiện thao tác này khi người dùng chia sẻ thư mục với doanh nghiệp của bạn lần đầu.

Bạn cần có quyền business_management để thực hiện hành động này:

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

Phản hồi

{ "success": true }

Ngoài ra, để xem yêu cầu đang chờ xử lý, hãy chuyển đến phần Cài đặt Trình quản lý kinh doanh > Yêu cầu > Yêu cầu đã nhận.

Nếu có agency hoặc đối tác tạo quảng cáo cho bạn, bạn nên chia sẻ thư mục nội dung của mình. Nhà phát triển cũng có thể xây dựng quy trình để nhà quảng cáo có thể chia sẻ thư mục của họ với doanh nghiệp khác.

Ứng dụng của bạn cần gửi yêu cầu POST đến creative_folder_id/agencies, đồng thời đặt trường business thành ID doanh nghiệp của đối tác và trường permitted_tasks thành MANAGE_CONTENT. Bạn cần có quyền business_creative_management để thực hiện hành động này.

Ví dụ - Thêm quyền VIEW_INSIGHTS để người dùng ứng dụng của bạn có thể xem thông tin chi tiết về các tài sản nội dung trong thư mục:

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

Phản hồi

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