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 do Google Cloud Search.

1. Criar um projeto de API

Para ativar a API, primeiro crie um projeto do Google Cloud. Esse projeto é a base para criar, ativar e usar todos os serviços do Google Cloud, incluindo gerenciamento de APIs, ativação de faturamento, adição e remoção de colaboradores e 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" é exibida.
Digite um nome 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 seu 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 que acabou de criar, 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" aparece.

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 na 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" é exibida.
Digite um nome no campo Nome da conta de serviço.
(opcional) Edite o código da conta de serviço.
Clique em Criar. Uma tela "Permissões da conta de serviço" vai aparecer.
Clique em Continuar. A tela "Conceder aos usuários acesso a essa conta de serviço" aparece.
Clique em CRIAR CHAVE e em Concluído. A caixa de diálogo "Chave privada salva no seu computador" vai aparecer, e uma cópia da chave privada será baixada no seu 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 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 qualquer outra API do Cloud Search, é preciso inicializar o suporte de terceiros para o Google Cloud Search.

Para inicializar o suporte a terceiros no Cloud Search:

O projeto da plataforma Cloud Search contém credenciais de conta de serviço. No entanto, para inicializar o suporte a 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 essa etapa, você terá um arquivo de ID e chave secreta do cliente.
Use o OAuth 2 Playground do Google para receber um token de acesso:
1. Clique em "Configurações" e marque 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 de escopos, digite https://www.googleapis.com/auth/cloud_search.settings e clique em Autorizar. O OAuth 2 Playground 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 a terceiros no Cloud Search, use o seguinte comando curl. Substitua [YOUR_ACCESS_TOKEN] pelo token obtido 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 a terceiros foi 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.