Páginas

As empresas podem reivindicar as Páginas que pertencem a elas. Isso permite que os administradores atribuam facilmente pessoas às Páginas às quais elas deveriam ter acesso.

Reivindicar Páginas

As empresas podem reivindicar a propriedade de uma página própria, o que permite gerenciar todos os aspectos da página, incluindo a remoção de todas as agências ou outras empresas que tenham recebido acesso. Como alternativa, as empresas também podem solicitar acesso de agência a uma página. Isso permite que elas veiculem anúncios na página por meio de contas de anúncios às quais têm acesso.

Reivindicar Páginas como proprietário

Se você quiser reivindicar uma Página para sua empresa como OWNER, será preciso obter a identificação da Página e da empresa. Depois, envie uma solicitação POST:

O solicitante precisa ter:

• permissão de administrador na página
• permissão na empresa proprietária ou aprovação da solicitação pela empresa proprietária

Para fazer essa solicitação, você deverá utilizar o token de acesso de um usuário administrador ou de um usuário do sistema administrador da sua empresa. Se o usuário que fizer a chamada atuar como administrador ou MANAGER da Página por mais de 7 dias, a empresa passará imediatamente a ser proprietária da Página. O Facebook retornará o access_status na resposta, que será definido como CONFIRMED. Se uma pessoa atuar como administrador ou MANAGER da Página por menos de 7 dias, a solicitação da API não será aprovada automaticamente.

Se o usuário que fizer uma chamada de reivindicação de OWNER não tiver as permissões necessárias na Página, a chamada falhará. Ao contrário da reivindicação de uma conta de anúncios, nenhuma solicitação será enviada aos administradores da Página para aprovação.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Reivindicar Páginas como agência

Se você quiser reivindicar uma Página para sua empresa como uma AGENCY, será preciso obter a identificação da Página em questão. Depois, envie uma solicitação POST:

Se o solicitante tiver permissão de administrador na página, essa solicitação será aprovada automaticamente. Caso contrário, o administrador da Página precisará aprovar a solicitação.

A agência não pode compartilhar novamente a Página com outra empresa.

A agência pode começar a veicular anúncios na Página (por meio de contas de anúncios às quais elas têm acesso) imediatamente.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Se você usar a opção AGENCY:

• Forneça as permitted_tasks.
• Uma empresa deverá ser proprietária da Página.
• O token de acesso precisará ter as permissões pages_manage_metadata e pages_show_list.

Caso você faça uma reivindicação de AGENCY, mas não tenha as permissões necessárias na Página, a resposta será PENDING. O administrador da Página em questão poderá entrar e conceder ou negar o acesso, bem como denunciar a reivindicação como spam. Se uma empresa tiver muitas solicitações de acesso à Página denunciadas como spam, bloquearemos o Gerenciador de Negócios.

Para ver todas as Páginas de clientes com acesso solicitado, mas pendentes de aprovação, faça a seguinte chamada GET. Para isso, você precisará do token de acesso do usuário do sistema administrador:

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

Visualizar Páginas ou Páginas de propriedade de empresas que pertencem a clientes da empresa

Para ver todas as Páginas da sua empresa, use esta chamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Para ver todas as Páginas das quais sua empresa é uma agência, use a seguinte chamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Isso retornará uma lista das Páginas que pertencem a clientes de um Gerenciador de Negócios.

Adicionar Páginas em massa

Você pode adicionar Páginas individuais a um Gerenciador de Negócios usando a interface do usuário da ferramenta. Para adicionar Páginas em massa a um Gerenciador de Negócios, faça estas chamadas POST:

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

Em que:

• <ACCESS_TOKEN> é um token de acesso com a permissão business_management.
• <BUSINESS_ID> é o ID do Gerenciador de Negócios para o qual as Páginas devem ser reivindicadas.
• <PAGE_ID_n> são as identificações das Páginas que serão reivindicadas.

Remover Páginas

Para remover uma página da empresa, faça a seguinte chamada DELETE:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Adicionar pessoas às Páginas

Depois que sua empresa tiver uma Página, você poderá atribuir tarefas às pessoas. As tarefas incluem:

Serão necessários:

• page_id: a identificação da Página.
• user_id: o número de identificação do usuário a ser adicionado.
• Tarefas para atribuição.

Faça esta chamada POST para adicionar uma pessoa com as tarefas ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']:

A identificação da empresa tem de ser a identificação da empresa proprietária da página

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Alterar o acesso às Páginas

Para alterar as tarefas de um usuário existente, use a mesma chamada POST que você utilizaria para adicionar um novo usuário com tarefas:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Ver permissões para Páginas

Para ver páginas com permissões de usuário, faça esta chamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

Para ver permissões específicas em uma Página, faça esta chamada GET:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

Remover o acesso à Página

Antes de remover uma Página do Gerenciador de Negócios, remova os administradores da Página em questão da sua empresa.

Para remover o acesso de uma pessoa a uma Página da sua propriedade, você precisará do seguinte:

• page_id: a identificação da Página.
• user_id: o número de identificação do usuário que será removido.

A chamada DELETE é:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"