Business Management APIs

Compartilhar pastas de criativos

Peça a uma empresa para compartilhar a pasta de criativos enviando uma solicitação. Envie uma solicitação POST para {business-creative-folder-id}/agencies e atribua permitted_tasks a MANAGE_CONTENT. Você precisará da permissão business_creative_management para executar essa ação.

Exemplo – A permissão VIEW_INSIGHTS é adicionada para possibilitar a visualização de insights dos ativos de criativo na pasta:

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

Resposta – Se uma empresa tiver compartilhado uma pasta com você e aceitado sua solicitação de compartilhamento:

{ "success": true }

Resposta – Se a empresa ainda não tiver aceitado uma solicitação de compartilhamento:

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

Ver solicitações em andamento

Para listar todos os acordos de parceria sem resposta, envie uma solicitação para {business-id}/received_sharing_agreements e defina request_status como IN_PROGRESS. Você precisará da permissão business_creative_management para executar essa ação.

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

Aceitar uma solicitação

Você pode aceitar uma solicitação de compartilhamento enviando um POST para business_sharing_agreement_request_id e definindo request_status como APPROVE. Só é necessário fazer isso na primeira vez que alguém compartilha uma pasta com sua empresa.

Você precisará da permissão business_management para executar essa ação.

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

Resposta

{ "success": true }

Como alternativa, para ver solicitações pendentes, acesse Configurações do Gerenciador de Negócios > Solicitações > Solicitações recebidas.

Compartilhar pasta

Caso uma agência ou um parceiro crie anúncios para você, será preciso compartilhar sua pasta de criativos. Os desenvolvedores também podem criar um fluxo para permitir que os anunciantes compartilhem as próprias pastas com outra empresa.

Seu app deverá enviar uma solicitação POST para creative_folder_id/agencies e definir o campo business como a identificação da empresa do parceiro e o campo permitted_tasks como MANAGE_CONTENT. Você precisará da permissão business_creative_management para executar essa ação.

Exemplo – Adicione a permissão VIEW_INSIGHTS para que os usuários do seu app possam visualizar os insights dos ativos de criativo na pasta:

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

Resposta

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