Visão geral do gerenciamento de ativos

Uma empresa pode acessar vários ativos. Sua empresa pode possuir os ativos ou ter acesso a eles como agência. Use as APIs de Gerenciamento de Ativos de Negócios do Facebook para adicionar, remover ou consultar o relacionamento entre uma empresa e os respectivos ativos a fim de gerenciar os ativos de negócios e o acesso a eles.

Agência refere-se a um tipo de entidade empresarial que pode gerenciar ou acessar ativos de propriedade de outra empresa. Essa relação permite à agência realizar tarefas ou ações específicas em nome do cliente, como gerenciar contas de anúncios, páginas ou outros ativos digitais.

Grupos de ativos de negócios

Os grupos de ativos de negócios ajudam grandes anunciantes ou agências a gerenciar de forma eficiente os usuários e os ativos da empresa. Organize ativos e usuários de modo que representem as operações do mundo real. Por exemplo, uma empresa pode estruturar ativos e usuários de acordo com a marca, a região, o cliente ou com base em outro princípio de organização que preferir.

Os grupos de ativos de negócios podem incluir contas de anúncios, Páginas, pixels do Facebook, conjuntos de eventos offline, apps, catálogos, conversões personalizadas e contas do Instagram. Os ativos podem pertencer a uma empresa ou ser compartilhados para conceder acesso a uma agência.

Você pode usar a API para adicionar usuários a um grupo de ativos de negócios. Depois, será possível conceder permissões a essas pessoas para que acessem os ativos em um grupo de ativos de negócios. Isso ajuda você a conceder acesso a vários ativos de uma só vez, sem criar um número excessivo de administradores no nível da empresa.

Com a API mencionada, você pode gerenciar grupos de ativos de negócios que foram criados por outra pessoa no Gerenciador de Negócios ou pode administrar ativos dentro do grupo de ativos de negócios. Você pode fazer o seguinte:

Obter uma lista de grupos de ativos de negócios associados a uma empresa
Excluir ou renomear um grupo de ativos de negócios
Ver todos os ativos em um grupo de ativos de negócios
Obter, adicionar, editar e excluir permissões de usuário para ativos em um grupo de ativos de negócios
Atribuir usuários a um grupo de ativos de negócios
Obter, adicionar e excluir ativos de um grupo de ativos de negócios

Permissões

Para usar a API de Grupos de Ativos de Negócios, seu app precisa ter o nível de acesso apropriado à API de Marketing:

Para todos os pontos de extremidade de adição e remoção: o usuário do token de acesso precisa ser um administrador da empresa. Caso contrário, o acesso será negado.
Para todos os pontos de extremidade da API, seu app precisa da permissão business_management.

Veja quando serão necessárias permissões adicionais:

Pontos de extremidade do grupo de ativos de negócios	Permissões obrigatórias
Obter lista de contas de anúncios	`ads_management`
Obter lista de catálogos de produtos, adicionar catálogo de produtos ou remover catálogo de produtos	`ads_management`
Obter lista de contas do Instagram, adicionar conta do Instagram ou remover conta do Instagram	`ads_management`. Se você estiver usando a versão 4.0 da API de Marketing, a permissão `instagram_basic` também será necessária.
Obter lista de pixels	`ads_read`
Obter lista de conjuntos de eventos offline	`ads_management`
Obter lista de conversões personalizadas	`ads_read`
Adicionar conversão personalizada	`ads_management`

Limitações

Você verá um erro se tentar reduzir ou remover permissões para um ativo contido em um grupo de ativos de negócios por meio das seguintes chamadas de API:

Solicitação DELETE para /{page_id}/assigned_users
Solicitação POST para /{page_id}/assigned_users
Solicitação DELETE para /act_{ad_account_id}/assigned_users
Solicitação POST para /act_{ad_account_id}/assigned_users

Para reduzir ou remover permissões, siga estas etapas:

Faça uma chamada para obter uma lista de grupos de ativos associados a uma empresa. Procure grupos de ativos em que contained_asset_id é igual a {page_id} ou {ad_account_id}.
Para cada identificação de grupo de ativos de negócios retornada, faça uma chamada de API a fim de remover um usuário desse grupo.
Depois, faça a solicitação DELETE ou POST exibida acima para remover a permissão desse usuário na Página ou na conta de anúncios.

Caso você forneça recursos de gerenciamento de permissões a outras empresas no seu app, use essa API para evitar inconsistências e erros entre a API e o Gerenciador de Negócios.

Não é possível definir permissões em apps, catálogos, contas do Instagram nem conversões personalizadas por meio do grupo de ativos de negócios. Em vez disso, atribua permissões no nível do ativo.

Por exemplo, se você adicionar Rogério a um grupo de ativos de negócios no Gerenciador de Negócios de Jorge, ele poderá obter permissões para qualquer Página, conta de anúncios, pixels e assim por diante, no respectivo grupo. No entanto, para remover ou editar as permissões de Rogério em qualquer ativo adicionado ao grupo de ativos de negócios de Jorge, será preciso realizar essa ação no próprio grupo.

Com a API de ativos, você pode adicionar permissões de usuário no nível do ativo, como alterar o status de um pessoa de "moderador" para "administrador" da Página. Veja exemplos para Página e conta de anúncios.

Os grupos de ativos de negócios substituíram a API de Projetos em 13 de outubro de 2019. Você deve migrar todos os apps da API de Projetos para os grupos de ativos de negócios.

Funções aceitas

Quando um usuário for adicionado a uma empresa, uma das duas funções a seguir poderá ser atribuída via APIs de Usuários Empresariais:

Constante da API	Nome	Descrição
`ADMIN`	Administrador da empresa	Pode gerenciar todos os aspectos das configurações do negócio, incluindo alterar ou excluir a conta e adicionar ou remover pessoas.
`EMPLOYEE`	Funcionário da empresa	Pode ver todas as informações nas configurações do negócio, mas não tem permissão para realizar alterações, exceto adicionar à empresa Páginas ou contas de anúncios que sejam administradas pelo usuário.

Catálogos

As funções a seguir podem ser atribuídas a qualquer usuário empresarial (administrador ou funcionário) em catálogos que podem ser acessados pela empresa usando as APIs de Catálogo:

Constante da API	Nome	Descrição
`['MANAGE', 'ADVERTISE']`	Administrador do catálogo	Pode gerenciar todos os aspectos do catálogo com acesso completo de leitura e gravação, incluindo criar/atualizar/excluir itens, gerenciar feeds, anexar catálogos a pixels e apps, criar conjuntos de produtos, veicular anúncios de catálogo Advantage+ com o catálogo, mudar configurações de catálogos e assim por diante.
`['ADVERTISE']`	Anunciante do catálogo	Pode criar conjuntos de produtos e veicular anúncios de catálogo Advantage+ com o catálogo. Não tem permissão para editar produtos, feeds nem configurações do catálogo.

Contas de anúncios

As tarefas a seguir podem ser atribuídas a qualquer usuário empresarial para contas de anúncios que podem ser acessadas pela empresa usando as APIs de Conta de Anúncios:

Constante da API	Nome	Descrição
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	Administrador da conta de anúncios	Pode gerenciar todos os aspectos de campanhas, relatórios, cobrança e permissões da conta, além de poder definir os limites de gastos da conta de anúncios. Os administradores das contas de anúncios também podem associar formas de pagamento da empresa.
`['ADVERTISE', 'ANALYZE']`	Anunciante na conta de anúncios	Pode ver e editar anúncios, além de configurar anúncios usando a forma de pagamento associada à conta de anúncios.
`['ANALYZE']`	Analista da conta de anúncios	Pode ver o desempenho do anúncio.

Páginas

Você pode atribuir as seguintes tarefas a qualquer usuário empresarial em Páginas que podem ser acessadas pela empresa usando as APIs de Página:

Constante da API	Nome	Descrição
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Administrador da Página	Pode gerenciar funções na Página, enviar mensagens e publicar como a Página, além de criar anúncios e ver insights.
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Editor da Página	Pode editar a Página, enviar mensagens e publicar como a Página, além de criar anúncios e ver insights.
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Moderador da Página	Pode responder e excluir comentários na Página, enviar mensagens como a Página, criar anúncios e ver insights. Não tem permissão para criar publicações em nome da Página.
`['ADVERTISE', 'ANALYZE']`	Anunciante da Página	Pode criar anúncios para a Página e ver insights. Não tem permissão para criar publicações em nome da Página.
`['ANALYZE']`	Analista da página	Pode ver insights. Não tem permissão para criar publicações em nome da Página.

Apps

Não há APIs de gerenciamento de tarefas ou funções para apps no Gerenciador de Negócios.

Contas do Instagram

Não há a opção de gerenciamento de funções para as contas do Instagram no Gerenciador de Negócios. Os usuários com acesso a contas de anúncios poderão veicular anúncios para as contas do Instagram que tiverem sido vinculadas.