Business Management APIs

Compartir carpetas de contenido

Solicitar a un negocio que comparta su carpeta de contenido enviando una solicitud. 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 realizar esta acción.

Ejemplo: el permiso VIEW_INSIGHTS se agrega para ver las estadísticas de los recursos de contenido en 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 un negocio compartió una carpeta contigo y aceptó una solicitud de compartir enviada por ti:

{ "success": true }

Respuesta: si el negocio aún no aceptó una solicitud de compartir:

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

Consulta solicitudes en progreso

Para enumerar los acuerdos de colaboración que no tienen una respuesta, envía una solicitud a {business-id}/received_sharing_agreements y configura request_status en IN_PROGRESS. Necesitas el permiso business_creative_management para realizar 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 de compartir, envía una solicitud POST a business_sharing_agreement_request_id y configura request_status en APPROVE. Solo necesitas hacer esto la primera vez que alguien comparta una carpeta con tu empresa.

Necesitas el permiso business_management para realiza 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 }

De manera alternativa, ve a Configuración del administrador comercial > Solicitudes > Solicitudes recibidas para ver solicitudes pendientes.

Compartir una carpeta

Si tienes una agencia o un socio que crea tus anuncios, deberás compartir tu carpeta de contenido. Los desarrolladores pueden crear un proceso para que los anunciantes compartan sus carpetas con otro negocio.

Tu app debe enviar una solicitud POST a creative_folder_id/agencies y establecer el campo business en el identificador del negocio del socio y el campo permitted_tasks en MANAGE_CONTENT. Necesitas el permiso business_creative_management para realizar esta acción.

Ejemplo: agregar el permiso VIEW_INSIGHTS para que los usuarios de la app puedan ver las estadísticas relativas a los recursos de contenido en 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"
}