Business Management APIs

Compartir carpetas de contenido

Envía una solicitud para pedir a una empresa que comparta su carpeta de contenido. Envía una solicitud POST a {business-creative-folder-id}/agencies y asigna permitted_tasks a MANAGE_CONTENT. Necesitas el permiso business_creative_management para llevar a cabo esta acción.

Ejemplo: el permiso VIEW_INSIGHTS se añade para ver los insights de las piezas de contenido de la carpeta:

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

Respuesta: si una empresa compartió contigo una carpeta y aceptó una solicitud de uso compartido tuya:

{ "success": true }

Respuesta: si la empresa todavía no ha aceptado ninguna solicitud:

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

Ver solicitudes en curso

Para enumerar todos los acuerdos de colaboración que no tienen respuesta, envía una solicitud a {business-id}/received_sharing_agreements y establece request_status en IN_PROGRESS. Necesitas el permiso business_creative_management para llevar a cabo esta acción.

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

Aceptar una solicitud

Para aceptar una solicitud para compartir, puedes enviar una solicitud POST a business_sharing_agreement_request_id y establecer request_status en APPROVE. Solo tienes que realizar esta operación la primera vez que alguien comparte una carpeta con tu empresa.

Necesitas el permiso business_management para llevar a cabo esta acción:

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

Respuesta

{ "success": true }

Como alternativa, para ver las solicitudes pendientes, ve a Configuración de Business Manager > Solicitudes > Solicitudes recibidas.

Compartir carpeta

Si tienes una agencia o un socio para crear los anuncios, debes compartir la carpeta de contenido. Los desarrolladores también pueden crear un proceso para que los anunciantes puedan compartir sus carpetas con otra empresa.

La aplicación debe enviar una solicitud POST a creative_folder_id/agencies y establecer el campo business en el identificador de la empresa del socio y el campo permitted_tasks en MANAGE_CONTENT. Necesitas el permiso business_creative_management para llevar a cabo esta acción.

Ejemplo: añade el permiso VIEW_INSIGHTS donde los usuarios de la aplicación puedan ver los insights de las piezas de contenido de la carpeta:

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

Respuesta

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