Business Management APIs

Creative Assets-Ordner teilen

Bitte ein Unternehmen durch Senden einer Anfrage, seinen Creative Assets-Ordner zu teilen. Sende eine POST-Anfrage an {business-creative-folder-id}/agencies und weise permitted_tasks zu MANAGE_CONTENT zu. Für diese Handlung benötigst du die Berechtigung business_creative_management:

Beispiel: Die Berechtigung VIEW_INSIGHTS wird hinzugefügt, um Insights für die Creative Assets im Ordner anzuzeigen:

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

Antwort: Wenn ein Unternehmen einen Ordner mit dir geteilt hat und deine Anfrage zum Teilen angenommen hat:

{ "success": true }

Antwort: Wenn das Unternehmen die Anfrage zum Teilen noch nicht angenommen hat:

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

Offene Anfragen anzeigen

Um alle Partnerschaftsvereinbarungen aufzulisten, die noch nicht beantwortet wurden, sende eine Anfrage an {business-id}/received_sharing_agreements und setze request_status auf IN_PROGRESS. Für diese Handlung benötigst du die Berechtigung 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}"

Eine Anfrage annehmen

Du kannst eine Anfrage zum Teilen annehmen, indem du eine POST-Anfrage an business_sharing_agreement_request_id sendest und request_status auf APPROVE setzt. Dieser Schritt ist nur nötig, wenn jemand zum ersten Mal einen Ordner mit deinem Unternehmen teilt.

Für diese Handlung benötigst du die Berechtigung 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>

Antwort

{ "success": true }

Zum Anzeigen offener Anfragen kannst du alternativ Business Manager-Einstellungen > Anfragen > Erhaltene Anfragen aufrufen.

Ordner teilen

Wenn deine Werbeanzeigen von einer Agentur oder einem Partner erstellt werden, solltest du deinen Creative Assets-Ordner teilen. Entwickler*innen können auch einen Vorgang erstellen, damit Werbetreibende ihre Ordner mit einem anderen Unternehmen teilen können.

Deine App sollte eine POST-Anfrage an creative_folder_id/agencies senden und das Feld business auf die Unternehmens-ID des Partners und das Feld permitted_tasks auf MANAGE_CONTENT setzen. Für diese Handlung benötigst du die Berechtigung business_creative_management:

Beispiel: Füge die Berechtigung VIEW_INSIGHTS hinzu, wo die Nutzer*innen deiner App die Insights für die Creative Assets im Ordner anzeigen können:

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

Antwort

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