Configurar o acesso à API Google Cloud Search

É necessário configurar o acesso à API Google Cloud Search antes de usá-la diretamente ou por um SDK. Este documento aborda as etapas necessárias para a API REST do Cloud Search.

1. Criar um projeto de API

Para ativar a API, primeiro crie um projeto do Google Cloud. Esse projeto é a base para usar os serviços do Google Cloud, gerenciar APIs e definir permissões.

Abra o Console do Google Cloud.
Clique no menu suspenso do projeto à direita de "Console do Google Cloud" e selecione NOVO PROJETO.
Digite um nome no campo Nome do projeto.
(Opcional) Clique em Editar para mudar o ID do projeto. Não é possível mudar esse ID depois da criação.
Clique em PROCURAR para escolher um local e depois em Selecionar.
Clique em Criar. O projeto geralmente fica pronto em minutos.

Para mais informações, consulte Como criar e gerenciar projetos.

2. Ativar a API

Ative a API Cloud Search e crie uma conta de serviço para conseguir credenciais.

Selecione seu novo projeto no menu suspenso do banner do console do Google Cloud.
Clique em ATIVAR APIS E SERVIÇOS.
Pesquise e selecione a API Google Cloud Search.
Clique em Ativar.

Para mais informações, consulte Gerenciar APIs no console do Google Cloud.

3. Criar credenciais de conta de serviço

No console do Google Cloud, clique em Credenciais na navegação à esquerda.
Selecione Conta de serviço no menu suspenso Criar credenciais.
Digite um nome no campo Nome da conta de serviço.
(Opcional) Edite o ID da conta de serviço.
Clique em Criar e continuar.
Clique em Concluído para acessar a lista "Contas de serviço".
Clique no e-mail da sua nova conta de serviço e selecione a guia Chaves.
Clique em ADICIONAR CHAVE > Criar nova chave.
Selecione JSON e clique em Criar. A chave privada é baixada para seu computador.

Para mais informações, consulte Contas de serviço.

4. Identificar o e-mail da conta de serviço

No console do Google Cloud, selecione seu projeto.
Clique em Menu de navegação > IAM e admin > Contas de serviço.
Anote o endereço de e-mail da sua conta de serviço. Você precisa disso para adicionar uma fonte de dados ao Cloud Search.

5. Inicializar o suporte de terceiros

Inicialize o suporte de terceiros para o Google Cloud Search antes de chamar qualquer outra API do Cloud Search.

Para inicializar o suporte a terceiros:

Crie credenciais de aplicativo da Web no projeto da plataforma do Cloud Search. Consulte Criar credenciais. Você precisa do ID e da chave secreta do cliente.
Receba um token de acesso usando o OAuth 2.0 Playground:
1. Clique em Configuração do OAuth 2.0 (ícone de configurações) e marque Usar suas próprias credenciais do OAuth.
2. Insira o ID e a chave secreta do cliente.
3. No campo de escopos, insira https://www.googleapis.com/auth/cloud_search.settings e clique em Autorizar APIs.
4. Clique em Trocar código de autorização dos tokens.

Execute este comando curl, substituindo [YOUR_ACCESS_TOKEN] pelo seu token:

curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

Se a solicitação for bem-sucedida, o corpo da resposta vai incluir um operation. Se falhar, entre em contato com o suporte do Cloud Search.

Use operations.get para verificar a inicialização:

curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

A inicialização é concluída quando done é true.

Próximas etapas

Para usar o Cloud Search com um repositório que não seja do Google, como o Microsoft® SharePoint®, é necessário criar uma origem de dados. Consulte Adicionar uma origem de dados para pesquisar.
Depois de configurar a origem de dados, crie e registre um esquema para identificar como o Cloud Search representa os dados.