Visão geral

É possível criar e gerenciar segmentos de dados usando a API Curation Partners, que expõe um curators.dataSegments recurso. Essa é uma API REST com bibliotecas de cliente geradas que podem ser usadas na 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 Curation Partners.

  1. Se ainda não tiver feito isso, crie um projeto do Google Cloud Project 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. Analise a lista de APIs e serviços ativados. Para acessar a API Curation Partners, é necessário ativá-la. Se a API Curation Partners não estiver ativada, clique em +Ativar APIs e serviços e siga estas instruções:

    1. Pesquise API Curation Partners usando a caixa de pesquisa.
    2. Selecione API Curation Partners na página de resultados.
    3. Clique em Ativar.

    Há um problema conhecido em que não é possível encontrar a API Curation Partners com a caixa de pesquisa do console do Google Cloud. Como alternativa, você pode usar a CLI do Google Cloud para ativar a API. Depois de instalar a CLI gcloud, ative a API Curation Partners com o seguinte comando:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. No menu de navegação, selecione Credenciais.

  5. Clique em +Criar credenciais e, no menu suspenso resultante, selecione Conta de serviço.

  6. Insira um Nome para a conta de serviço. O ID da conta de serviço é criado automaticamente após a criação. Anote esse valor, porque ele será necessário na etapa 14. Opcionalmente, insira uma descrição. Clique em Criar e continuar.

  7. Se quiser, configure as permissões da conta de serviço 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. Sua nova conta de serviço será listada 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 a chave com segurança, consulte Como gerenciar chaves de contas de serviço. A chave é usada pelo aplicativo para fazer chamadas de API.

  14. Compartilhe o ID da conta de serviço com o gerente técnico de contas para vincular a conta de serviço à sua conta.

Escopos da API

Ao seguir o 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 Curation Partners, esse escopo é https://www.googleapis.com/auth/curation-partners.

Como identificar segmentos de dados na API em comparação com a curadoria em tempo real

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

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

Ao identificar os segmentos de dados relevantes para uma oportunidade de anúncio na curadoria em tempo real Curation, especifique o valor do ID do recurso DATA_SEGMENT_ID em vez do nome completo do recurso fornecido pela API no campo name.

Próximas etapas