Condividi cartelle delle creatività

Chiedi a un Business Manager di condividere con te la propria cartella delle creatività inviando una richiesta. Invia una richiesta POST a: {business-creative-folder-id}/agencies e assegna permitted_tasks a MANAGE_CONTENT. Hai bisogno dell'autorizzazione business_creative_management per questa azione.

Esempio — L'autorizzazione VIEW_INSIGHTS è stata aggiunta per la visualizzazione degli insight relativi alle risorse delle creatività nella cartella:

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

Risposta: se un Business Manager ha condiviso una cartella con te e ha accettato la richiesta di condivisione da parte tua:

{ "success": true }

Risposta: se il Business Manager non ha ancora accettato la richiesta di condivisione:

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

Visualizzazione delle richieste in corso

Per elencare tutti gli accordi di partnership che non hanno ancora una risposta, invia una richiesta a {business-id}/received_sharing_agreements e imposta request_status su IN_PROGRESS. Hai bisogno dell'autorizzazione business_creative_management per questa azione.

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

Accettazione di una richiesta

Puoi accettare una richiesta di condivisione inviando una richiesta POST a business_sharing_agreement_request_id e impostando request_status su APPROVE. Devi effettuare questa operazione solo la prima volta che qualcuno condivide una cartella con il tuo Business Manager.

Hai bisogno dell'autorizzazione business_management per questa azione:

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

Risposta

{ "success": true }

In alternativa, per visualizzare le richieste in sospeso, vai a Impostazioni di Business Manager > Richieste > Richieste ricevute.

Condivisione della cartella

Se hai un'agenzia o un partner che crea le tue inserzioni, devi condividere la cartella delle creatività. Gli sviluppatori possono anche creare un flusso in modo che gli inserzionisti possano condividere le loro cartelle con un altro Business Manager.

La tua app deve inviare una richiesta POST a creative_folder_id/agencies e impostare il campo business sull'ID business del partner e il campo permitted_tasks su MANAGE_CONTENT. Hai bisogno dell'autorizzazione business_creative_management per questa azione.

Esempio — Aggiungi l'autorizzazione VIEW_INSIGHTS per cui gli utenti dell'app possono visualizzare gli insight relativi alle risorse delle creatività nella cartella:

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

Risposta

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