Grupos de ativos e usuários

Gerencie os grupos de ativos de negócios e saiba como conectar os usuários corporativos a grupos de ativos. 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.

Grupos de ativos

Obter uma lista de grupos

Para obter uma lista de grupos de ativos associados a um negócio, envie uma solicitação GET para o ponto de extremidade BusinessBusinessAssetGroups.

Exemplo de solicitação

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_asset_groups
    ?access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Northern Region"
    },
    {
      "id": "BUSINESS-ID",
      "name": "Western Region"
    }
  ],
....
}

Obter um grupo específico

Para obter detalhes sobre um grupo de ativos de negócios específico, envie uma solicitação GET para o ponto de extremidade BusinessAssetGroup.

Exemplo de solicitação

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "id": "BUSINESS-ASSET-GROUP-ID", "name": "BUSINESS-ASSET-GROUP-NAME"
}

Renomear um grupo

Para renomear um grupo de ativos específico, envie uma solicitação POST para o ponto de extremidade BusinessAssetGroup e defina name como o novo valor.

Exemplo de solicitação

curl -i -X POST 
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
   ?name=BUSINESS-ASSET-GROUP-NAME
   &access_token=<ACCESS_TOKEN>"

Exemplo de resposta

"success":  "true"

Excluir um grupo

Para excluir um grupo de ativos específico, envie uma solicitação DELETE para o ponto de extremidade BusinessAssetGroup.

Exemplo de solicitação

curl -i -X DELETE 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Exemplo de resposta

"success":  "true"

Usuários

Campos públicos de um usuário que tem uma função na empresa que obteve o app.

Requisitos

• O recurso Acesso ao perfil de usuário de ativo de negócios permite que apps de Negócios leiam um conjunto reduzido de campos públicos de um usuário, desde que o usuário tenha interagido com ativos de propriedade da empresa que reivindicou o app.

Leia a referência Acesso ao perfil de usuário de ativo de negócios para obter uma lista de campos públicos que podem ser lidos.

Obter o acesso de um usuário a grupos

Para exibir uma lista de todos os grupos de ativos de negócios que um usuário no escopo da empresa pode acessar, envie uma solicitação GET para o ponto de extremidade BusinessScopedUser/AssignedBusinessAssetGroups.

Exemplo de solicitação

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_business_asset_groups
    ?limit=1
    &access_token=<ACCESS_TOKEN>"

Exemplo de resposta

A resposta inclui funções que definem os níveis de acesso de um usuário por tipo de ativo:

{
  "data": [
    {
      "id": "BUSINESS-ID" 
      "name": "USER NAME",      
      "page_roles": [ "ANALYZE", "ADVERTISE" ],
      "offline_conversion_data_set_roles": ["UPLOAD"],
      "adaccount_roles": ["ANALYZE", "ADVERTISE"],      
      "pixel_roles": ["ANALYZE", "EDIT"]    
    }  
    ],
        ....
}

Obter as permissões de um usuário

Para ler uma lista de usuários atribuídos a um grupo de ativos, envie uma solicitação GET para o ponto de extremidade BusinessAssetGroupAssignedUsers.

Exemplo de solicitação

curl -i -X GET
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?limit=2
    &business=<BUSINESS_ID>
    &access_token=<ACCESS_TOKEN>"

Exemplo de resposta

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Dabney Donigan",
      "page_roles": [ "ANALYZE" ],  
      "offline_conversion_data_set_roles": [ "ADVERTISE", "UPLOAD", "MANAGE" ],
      "adaccount_roles": [ "ANALYZE" ],
      "pixel_roles": [ "ANALYZE", "EDIT" ]
      }
      ],
   ....
}

Atribuir um usuário ao grupo de ativos

Para atribuir usuários a um grupo de ativos de negócios, envie uma solicitação POST para o ponto de extremidade BusinessAssetGroupAssignedUsers.

Exemplo de solicitação

curl -i -X POST 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=USER-ID 
    &page_roles=LIST-OF-PAGE-ROLES
    &adaccount_roles=LIST-OF-AD-ACCOUNT-ROLES
    &pixel_roles=LIST-OF-PIXEL-ROLES
    &offline_conversion_data_set_roles=LIST-OF-OFFLINE-CONVERSION-ROLES
    &access_token=<ACCESS_TOKEN>"

Exemplo de resposta

"success":  "true"

Remover um usuário do grupo de ativos

Para remover um usuário de um grupo, envie uma solicitação POST para o ponto de extremidade BusinessAssetGroup.

Exemplo de solicitação

curl -i -X DELETE \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=<USER_ID>
    &access_token=<ACCESS_TOKEN>"

Exemplo de resposta

"success":  "true"