Esta página foi traduzida pela API Cloud Translation.

Configurar o acesso à API Google Cloud Search

É necessário configurar o acesso à API Google Cloud Search para poder usar essa API diretamente ou por meio de um SDK. Este documento mostra as etapas necessárias para usar a API REST da API Google Cloud Search.

1. Criar um projeto de API

Para ativar a API, primeiro é necessário criar um projeto do Google Cloud. Esse projeto é a base para criar, ativar e usar todos os serviços do Google Cloud, incluindo o gerenciamento de APIs, a ativação do faturamento, a adição e remoção de colaboradores e o gerenciamento de permissões.

Abra o Console do Google Cloud.
Na parte de cima da página, clique em à direita de "Console do Google Cloud". Será exibida uma caixa de diálogo que lista os projetos atuais.
Clique em NOVO PROJETO. A tela "Novo projeto" vai aparecer.
Digite um nome de projeto no campo Nome do projeto.
(opcional) Clique em Editar para editar o código do projeto. O código do projeto não pode ser alterado após a criação do projeto, portanto, escolha um código que atenda às suas necessidades durante a vida útil do projeto.
Para procurar locais para o projeto, clique em PROCURAR.
Clique em um local para o projeto e em Selecionar.
Clique em Criar. O Console acessa a página "Painel". O projeto é criado em poucos minutos.

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

2. Ativar a API

É necessário ativar a API Google Cloud Search e criar uma conta de serviço para conseguir as credenciais.

Para garantir que você esteja no projeto mais recente, clique no ícone à direita do banner do console do Google Cloud e selecione o projeto recém-criado.
Clique em ATIVAR APIS E SERVIÇOS. A página "Olá! Esta é a Biblioteca de APIs" aparece.
Acesse a API do Google Cloud Search.
Clique em Ativar. A página "Visão geral" vai aparecer.

Para mais informações sobre como ativar e desativar APIs, consulte Gerenciar APIs no console do Google Cloud.

3. Criar credenciais de conta de serviço

No console do Google Cloud, clique em Credenciais no painel de navegação à esquerda. A página "Credenciais" será exibida.
Na lista suspensa Criar credenciais, selecione Conta de serviço. A página "Criar conta de serviço" vai aparecer.
Digite um nome no campo Nome da conta de serviço.
(opcional) Edite o código da conta de serviço.
Clique em Criar. A tela "Permissões da conta de serviço" vai aparecer.
Clique em Continuar. A tela "Conceder aos usuários acesso a esta conta de serviço" será exibida.
Clique em CRIAR CHAVE e em Concluído. A caixa de diálogo "Chave privada salva no seu computador" será exibida, e será feito o download de uma cópia da chave privada no computador.
Clique em Fechar.

Para mais informações sobre contas de serviço, consulte Contas de serviço, aplicativos da Web e aplicativos instalados

4. Identificar o endereço de e-mail

No console do Google Cloud, selecione o projeto que você criou na parte de cima da página.
Clique no menu de navegação à esquerda do banner do console do Google Cloud.
Clique em IAM e Admin > Contas de serviço.
Na lista, em "ID da conta de serviço", anote o endereço de e-mail gerado que identifica a conta de serviço configurada. Esse endereço de e-mail é usado quando você adiciona uma origem de dados ao Cloud Search.

5. Inicializar o suporte de terceiros

Antes de chamar outras APIs do Cloud Search, é necessário inicializar o suporte de terceiros para o Google Cloud Search.

Para inicializar o suporte de terceiros ao Cloud Search:

Seu projeto do Cloud Search Platform contém credenciais da conta de serviço. No entanto, para inicializar o suporte de terceiros, é necessário criar credenciais de aplicativo da Web. Para instruções sobre como criar credenciais de aplicativo da Web, consulte Criar credenciais. Depois de concluir esta etapa, você terá um ID e um arquivo de chave secreta do cliente.
Use o playground do OAuth 2 do Google para receber um token de acesso:
1. Clique em "Configurações" e marque a caixa Usar suas próprias credenciais de autenticação.
2. Insira o ID e a chave secreta do cliente da etapa 1.
3. Clique em Fechar.
4. No campo "Escopos", digite https://www.googleapis.com/auth/cloud_search.settings e clique em Autorizar. O playground do OAuth 2 retorna um código de autorização.
5. Clique em Trocar código de autorização dos tokens. Um token é retornado.

Para inicializar o suporte de terceiros para o Cloud Search, use o seguinte comando curl. Substitua [YOUR_ACCESS_TOKEN] pelo token recebido na etapa 2.

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 funcionar, o corpo da resposta vai ter uma instância de operation. Por exemplo:

{
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
}

Se não funcionar, entre em contato com o suporte do Cloud Search.

Use operations.get para verificar se o suporte de terceiros está inicializado:

curl \
'https://cloudsearch.googleapis.com/v1/operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY?key=
[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

Quando a inicialização de terceiros é concluída, ela contém o campo done definido como true. Exemplo:

{
name: "operations/customers/01b3fqdm/lro/AOIL6eBv7fEfiZ_hUSpm8KQDt1Mnd6dj5Ru3MXf-jri4xK6Pyb2-Lwfn8vQKg74pgxlxjrY"
done: true
}

Próximas etapas

Veja algumas das próximas etapas que podem ser seguidas:

Se você planeja usar o Google Cloud Search com um repositório de dados que não seja do Google, como o Microsoft® SharePoint®, é necessário criar uma origem de dados. Para instruções sobre como adicionar uma origem de dados, consulte Adicionar uma origem de dados para pesquisa.
Depois de configurar a origem de dados, é possível criar e registrar esquemas para identificar como o Google Cloud Search representa os dados no repositório.