Esta página descreve como usar chaves de API para acessar APIs e serviços do Google Cloud que aceitam chaves de API.
Nem todas as APIs do Google Cloud aceitam chaves de API para autorizar o uso. Confira a documentação do serviço ou da API que você quer usar para determinar se é compatível com chaves de API.
Para saber como criar e gerenciar chaves de API, incluindo a restrição delas, consulte Gerenciar chaves de API.
Para saber como usar chaves de API com a Plataforma Google Maps, consulte a documentação da Plataforma Google Maps. Para mais informações sobre a API de chaves de API, consulte a documentação da API de chaves de API.Usar uma chave de API com REST
É possível transmitir a chave de API para uma chamada da API REST como um parâmetro de consulta com o
seguinte formato. Substitua API_KEY
pela string da sua chave de API.
Por exemplo, para transmitir uma chave de API de uma solicitação da API Cloud Natural Language
a documents.analyzeEntities
:
POST https://language.googleapis.com/v1/documents:analyzeEntities?key=API_KEY
Como alternativa, é possível usar o cabeçalho x-goog-api-key
para transmitir sua chave.
Esse cabeçalho precisa ser usado com solicitações gRPC.
curl -X POST \ -H "X-goog-api-key: API_KEY" \ -H "Content-Type: application/json; charset=utf-8" \ -d @request.json \ "https://translation.googleapis.com/language/translate/v2"
Usar uma chave de API com bibliotecas de cliente
O suporte da biblioteca de cliente às chaves de API é específico da linguagem.
Este exemplo usa a API Cloud Natural Language, que oferece suporte a chaves de API para autenticação, e demonstra como fornecer uma chave de API à biblioteca.
C#
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
C++
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
Go
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
Java
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
Node.js
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
PHP
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
Python
Para executar este exemplo, instale a biblioteca de cliente da Natural Language.
Ao usar chaves de API nos seus aplicativos, garanta que elas sejam mantidas em segurança durante o armazenamento e a transmissão. A exposição pública das chaves de API pode levar a cobranças inesperadas na sua conta. Para mais informações, consulte Práticas recomendadas para gerenciar chaves de API.
A seguir
- Consulte uma visão geral dos métodos de autenticação.
- Saiba mais sobre a API de chaves de API.