Partage de dossiers créatifs

Demandez à une entreprise de partager son dossier créatif en lui soumettant une demande. Envoyez une requête POST à {business-creative-folder-id}/agencies et définissez le champ permitted_tasks sur MANAGE_CONTENT. Pour effectuer cette action, vous devez disposer de l’autorisation business_creative_management.

Exemple : l’autorisation VIEW_INSIGHTS est ajoutée pour permettre de consulter les statistiques des éléments de contenu publicitaire dans le dossier :

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

Réponse : si une entreprise a partagé un dossier avec vous et a accepté une demande de partage de votre part :

{ "success": true }

Réponse : si l’entreprise n’a pas encore accepté une demande de partage :

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

Voir les demandes en cours

Pour obtenir la liste de tous les accords de partenariat qui n’ont pas reçu de réponse, envoyez une requête à {business-id}/received_sharing_agreements et définissez request_status sur IN_PROGRESS. Pour effectuer cette action, vous devez disposer de l’autorisation 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}"

Accepter une demande

Vous pouvez accepter une demande de partage en envoyant une requête POST à business_sharing_agreement_request_id et en définissant request_status sur APPROVE. Cette opération n’est nécessaire que lors du premier partage d’un dossier avec votre entreprise.

Pour effectuer cette action, vous devez disposer de l’autorisation 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>

Réponse

{ "success": true }

Si vous souhaitez consulter les demandes en attente, accédez à Paramètres Business Manager > Demandes > Demandes reçues.

Partager le dossier

Si vous faites appel à une agence ou à un partenaire pour créer vos publicités, vous devez partager votre dossier créatif. Les équipes de développement peuvent également créer un flux pour permettre aux annonceurs de partager leurs dossiers avec une autre entreprise.

Votre application doit envoyer une requête POST à creative_folder_id/agencies et définir le champ business sur l’ID de l’entreprise du partenaire et le champ permitted_tasks sur MANAGE_CONTENT. Pour effectuer cette action, vous devez disposer de l’autorisation business_creative_management.

Exemple : ajouter l’autorisation VIEW_INSIGHTS là où les utilisateur·ices de votre application peuvent consulter les statistiques des éléments de contenu publicitaire dans le dossier :

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

Réponse

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