Visão geral

É possível criar e gerenciar segmentos de dados usando a API Authorized Buyers Marketplace, que expõe um recurso curators.dataSegments. Essa é uma API REST com bibliotecas de cliente geradas que você pode usar na sua integração.

Configurar a autenticação

As APIs do Google usam o protocolo OAuth 2.0 para autenticação e autorização. Saiba como configurar uma conta de serviço para acessar a API Marketplace.

  1. Se você ainda não tiver feito isso, crie um projeto do Google Cloud que hospede as credenciais usadas para acessar a API.
  2. Acesse a página APIs ativadas do Console do Google Cloud. Selecione o projeto criado anteriormente.

  3. Uma lista de APIs e serviços ativados vai aparecer. Para acessar a API Marketplace, é necessário ativá-la. Se a API Marketplace não estiver ativada, clique em +Ativar APIs e serviços e siga estas instruções:

    1. Você será direcionado a uma página com uma caixa de pesquisa. Pesquise API Authorized Buyers Marketplace.
    2. Selecione API Authorized Buyers Marketplace na página de resultados.
    3. Clique em Ativar.
  4. No menu de navegação, selecione Credenciais.
  5. Clique em +Criar credenciais e, no menu suspenso que aparece, selecione Conta de serviço.
  6. Insira um Nome para a conta de serviço. O ID da conta de serviço é criado automaticamente. Anote esse valor porque ele será necessário mais tarde na etapa 14. Opcionalmente, insira uma Descrição. Clique em Criar e continuar.
  7. Configure as permissões da conta de serviço, se quiser, e clique em Continuar.
  8. Se quiser, configure usuários ou grupos que podem realizar ações como a conta de serviço e clique em Concluído.
  9. A nova conta de serviço aparece em Contas de serviço. Encontre e clique no ID da conta de serviço que você acabou de criar.
  10. Clique na guia Chaves.
  11. No menu suspenso Adicionar chave, selecione Criar nova chave.
  12. Selecione JSON como o tipo de chave e clique em Criar.
  13. Faça o download da chave para o diretório de trabalho. Para mais informações sobre como armazenar sua chave com segurança, consulte Como gerenciar chaves de conta de serviço. A chave é usada pelo aplicativo para fazer chamadas de API.
  14. Compartilhe o ID da conta de serviço com seu gerente técnico de contas para vincular a conta de serviço à sua conta.

Escopos da API

Ao passar pelo fluxo do OAuth 2.0 para receber um token de acesso usado para fazer uma chamada de API, é necessário especificar as APIs que podem ser acessadas usando esse token. Para a API Authorized Buyers Marketplace, esse escopo é https://www.googleapis.com/auth/authorized-buyers-marketplace.

Como identificar segmentos de dados na API e na seleção em tempo real

Na API Marketplace, os segmentos de dados são identificados com um nome de recurso específico da API, como:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Ao identificar os segmentos de dados relevantes para uma oportunidade de anúncio na Curadoria em tempo real, especifique o valor do ID do recurso DATA_SEGMENT_ID em vez do recurso name completo usado pela API.

Próximas etapas