Autorização

Para acessar pontos de extremidade da API de Marketing, o app precisa passar por múltiplas camadas de autorização da Graph API.

Camada 1: tipos de app

Quando você cria um app do Facebook, nós perguntamos como ele será utilizado. Sua resposta determina o tipo do app: Empresa, Jogos ou Nenhum. Consulte Tipos de app.

É necessário criar um app de empresa para acessar pontos de extremidade da API de Marketing. Consulte os produtos disponíveis para apps de empresa.

Depois de registrar seu app, será possível atribuir funções a qualquer pessoa com uma conta de desenvolvedor para ajudar você com o desenvolvimento.

Camada 2: níveis de acesso, permissões e recursos

Os apps de empresa estão sujeitos a uma camada adicional de autorização da Graph API: os níveis de acesso. Durante o processo de análise, seu app também deverá solicitar permissões e recursos específicos.

Níveis de acesso

Nível de acesso	Descrição
Acesso padrão	O acesso padrão será aprovado automaticamente para todas as permissões e recursos disponíveis aos apps de empresa. Caso você seja iniciante, use essa opção. É possível criar fluxos de trabalho de ponta a ponta antes de solicitar permissões completas. Você pode acessar um número ilimitado de contas de anúncios. Algumas chamadas de API não estão disponíveis com o acesso padrão porque podem pertencer a várias contas ou porque não é possível identificar a conta afetada de modo programático.
Acesso avançado	O acesso avançado deve ser aprovado para cada permissão ou recurso por meio do processo de análise do app. Para solicitar o acesso avançado, vá para o Painel de Apps e clique em Análise do aplicativo > Permissões e recursos. Encontre a permissão ou o recurso que você quer acessar e clique em Solicitar acesso avançado em Ação. É possível selecionar um ou mais recursos. Depois de selecionar as opções, clique em Continuar a solicitação. Será exibida uma tela que guiará você pelo processo de envio. Após você enviar as informações, o Facebook responderá com uma mensagem de aprovação ou recusa, com informações adicionais se o app não estiver qualificado para o acesso padrão. Se você tiver aprovação para o acesso avançado, será preciso concluir as seguintes ações para manter esse status: Ter feito ao menos 1.500 chamadas da API de Marketing com sucesso nos últimos 15 dias. Ter feito chamadas da API de Marketing com uma taxa de erro menor do que 10% nos últimos 15 dias.

Nível de acesso

Descrição

Acesso padrão

O acesso padrão será aprovado automaticamente para todas as permissões e recursos disponíveis aos apps de empresa.

Caso você seja iniciante, use essa opção. É possível criar fluxos de trabalho de ponta a ponta antes de solicitar permissões completas. Você pode acessar um número ilimitado de contas de anúncios.

Algumas chamadas de API não estão disponíveis com o acesso padrão porque podem pertencer a várias contas ou porque não é possível identificar a conta afetada de modo programático.

Acesso avançado

O acesso avançado deve ser aprovado para cada permissão ou recurso por meio do processo de análise do app.

Para solicitar o acesso avançado, vá para o Painel de Apps e clique em Análise do aplicativo > Permissões e recursos.

Encontre a permissão ou o recurso que você quer acessar e clique em Solicitar acesso avançado em Ação. É possível selecionar um ou mais recursos. Depois de selecionar as opções, clique em Continuar a solicitação. Será exibida uma tela que guiará você pelo processo de envio.

Após você enviar as informações, o Facebook responderá com uma mensagem de aprovação ou recusa, com informações adicionais se o app não estiver qualificado para o acesso padrão.

Se você tiver aprovação para o acesso avançado, será preciso concluir as seguintes ações para manter esse status:

Ter feito ao menos 1.500 chamadas da API de Marketing com sucesso nos últimos 15 dias.
Ter feito chamadas da API de Marketing com uma taxa de erro menor do que 10% nos últimos 15 dias.

Cada nível tem restrições. Veja mais em Níveis de acesso e recursos. Todos os desenvolvedores devem seguir os Termos da Plataforma do Facebook e as Políticas do Desenvolvedor. As chamadas em QUALQUER nível de acesso são feitas em relação aos dados de produção.

Para verificar seu nível de acesso atual, vá para Painel de Apps > Análise do aplicativo > Permissões e recursos.

Permissões e recursos

As permissões que precisam ser solicitadas mudam de acordo com a API que você quer acessar.

Caso o app gerencie somente sua conta de anúncios, o acesso padrão e as permissões ads_read e ads_management serão suficientes. Se o app gerenciar contas de anúncios de outras pessoas, será necessário ter acesso avançado e as permissões ads_read e/ou ads_management. Veja todas as permissões disponíveis para apps de empresa.

Os recursos que devem ser solicitados mudam conforme a maneira como você pretende usar nossas APIs. Para gerenciar anúncios, é comum solicitar o recurso Ads Management Standard Access. Veja todos os recursos disponíveis para apps de empresa.

Para obter o acesso avançado do Acesso Padrão ao Gerenciamento de Anúncios, seu app precisa atender a estes requisitos:

Ter feito ao menos 1.500 chamadas da API de Marketing com sucesso nos últimos 15 dias.
Ter feito chamadas da API de Marketing com uma taxa de erro menor do que 10% nos últimos 15 dias.

Se estiver gerenciando os anúncios de outra pessoa, use o parâmetro scope para solicitar as permissões ads_management ou ads_read para alguém. Seu app obterá acesso quando alguém clicar em Permitir:

https://www.facebook.com/v19.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Ao preencher o campo YOUR_URL, insira / à direita. Por exemplo: http://www.facebook.com/

Exemplos

Caso de uso	O que solicitar
Você quer ler e gerenciar anúncios das próprias contas ou de contas de anúncios para as quais tenha recebido acesso.	Permissão: `ads_management` Recurso: `Ads Management Standard Access`
Você quer ler relatórios de anúncios das próprias contas ou de contas de anúncios para as quais tenha recebido acesso.	Permissão: `ads_read` Recurso: `Ads Management Standard Access`
Você quer obter relatórios de anúncios de um conjunto de clientes, bem como ler e gerenciar anúncios de outro conjunto de clientes.	Permissões: `ads_management` e `ads_read` Recurso: `Ads Management Standard Access`

Níveis de acesso e recursos

A tabela abaixo mostra como os níveis de acesso avançado e padrão afetam o recurso Acesso Padrão ao Gerenciamento de Anúncios.

	Acesso padrão	Acesso avançado
Limites de contas	Gerencie um número ilimitado de contas de anúncios. Administradores ou desenvolvedores de apps podem fazer chamadas de API em nome de administradores de contas de anúncios ou anunciantes.	Gerencie um número ilimitado de contas de anúncios se tiver as permissões `ads_read` ou `ads_management` da conta de anúncios.
Limites de volume	Volumes extremamente limitados por conta de anúncio. Somente para desenvolvimento. Não para apps em produção veiculando para anunciantes publicados.	Volumes ligeiramente limitados por conta de anúncios.
Gerenciador de Negócios	Acesso limitado às APIs do Gerenciador de Negócios e do Catálogo de produtos. Sem acesso do Gerenciador de Negócios para administrar contas de anúncios, permissões de usuários e Páginas.	Acesso a todas as APIs do Gerenciador de Negócios e do Catálogo de produtos.
Usuário do sistema	É possível criar um usuário do sistema e um usuário do sistema administrador.	Pode criar dez usuários do sistema e um usuário do sistema administrador.
Criação da Página	Não é possível criar páginas por meio da API.	Não é possível criar páginas por meio da API.

Níveis de acesso x Acesso Padrão ao Gerenciamento de Anúncios

As permissões e os recursos para apps contam com dois níveis de acesso diferentes: o acesso padrão e o acesso avançado. Observe que, nesse contexto, o termo "acesso padrão" não está relacionado ao recurso Acesso Padrão ao Gerenciamento de Anúncios. O acesso avançado do Acesso Padrão ao Gerenciamento de Anúncios ainda exige que o app seja aprovado no processo de análise.

Camada 3: verificação da empresa

A verificação da empresa é um processo que nos permite confirmar sua identidade como entidade corporativa, o que será necessário caso o app acesse dados sensíveis. Saiba mais sobre o processo de verificação da empresa.