Começar

Esta página explica como os programadores podem começar a usar as APIs Google Cloud .

Se estiver a usar as Google Cloud APIs pela primeira vez, pode seguir os passos neste guia para chamar as APIs através de comandos curl. Pode usar comandos curl para experimentar uma API antes de desenvolver a sua aplicação.

Criar uma Conta Google

Para usar as APIs Google Cloud nas suas aplicações, primeiro, tem de ter uma Conta Google. Isto permite-lhe usar produtos para programadores Google, incluindo a Google Cloud consola, a CLI gcloud, o Cloud Logging e o Cloud Monitoring. Se está a usar o Google Cloudpela primeira vez, crie uma conta para avaliar o desempenho dos nossos produtos em cenários reais. Os novos clientes também recebem 300 USD em créditos gratuitos para executar, testar e implementar cargas de trabalho.

Criar um projeto Google

Para usar as APIs Cloud, também precisa de ter um projeto Google. Um projeto é equivalente a uma conta de programador. Serve como um contentor de recursos para os seus recursos do Google Cloud. Também fornece um limite de isolamento para a sua utilização dos serviços Google Cloud , para que possa gerir os limites de quota e a faturação de forma independente ao nível do projeto. A telemetria de utilização e os painéis de controlo também são agrupados por projetos. Se ainda não tiver um projeto, pode criar um através da Google Cloud consola.

Um projeto pode ser proprietário de uma vasta gama de recursos, incluindo chaves de API, clientes OAuth, contas de serviço, MVs do Compute Engine, contentores do Cloud Storage e conjuntos de dados do BigQuery. Quando uma aplicação chama uma API Cloud, o projeto que detém as credenciais da aplicação é denominado projeto cliente, e o projeto que detém o recurso de destino é denominado projeto de recursos. Um pedido API pode afetar vários recursos, pelo que estão envolvidos vários projetos de recursos.

Se quiser parar de usar o Google Cloud por qualquer motivo, pode usar a Google Cloud consola para eliminar o seu projeto. O seu projeto e todos os recursos no projeto são eliminados após o período de retenção. Tenha em atenção que diferentes tipos de dados têm diferentes períodos de retenção.

Descobrir APIs

Antes de usar qualquer API Cloud, deve usar a biblioteca de APIs da Google Cloud consola para procurar as APIs Cloud disponíveis e descobrir as que melhor se adequam às necessidades da sua empresa. Para mais informações sobre uma API Cloud específica, visite o respetivo site de documentação pública, como a API Spanner.

Ativar APIs

Algumas APIs Cloud estão ativadas por predefinição. Para usar uma API Cloud que não esteja ativada por predefinição, tem de a ativar para o seu projeto. Consoante os serviços e os projetos envolvidos na sua aplicação, incluindo o projeto cliente e os projetos de recursos, pode ter de ativar uma API para vários projetos. Quando ativa uma API que depende de outras APIs, essas APIs também são ativadas ao mesmo tempo.

A ativação de uma API requer que aceite os Termos de Utilização e a responsabilidade de faturação da API. Precisa de autorização serviceusage.services.enable no projeto para ativar APIs. Para mais informações, consulte o artigo Controlo de acesso em Utilização do serviço.

Além disso, o serviço a ativar tem de ser público ou o proprietário do serviço tem de conceder ao utilizador a autorização servicemanagement.services.bind no serviço privado. Consulte o artigo Controlo de acesso à gestão de serviços para mais informações.

Para ativar uma API para um projeto através da consola:

  1. Aceda à Google Cloud Biblioteca de APIs da consola.
  2. Na lista de projetos, selecione o projeto que quer usar.
  3. Na biblioteca de APIs, selecione a API que quer ativar. Se precisar de ajuda para encontrar a API, use o campo de pesquisa e/ou os filtros.
  4. Na página da API, clique em ATIVAR.

Na mesma página, pode desativar uma API para o seu projeto se já não a usar para evitar a utilização indevida e cobranças acidentais de faturação. Também pode ativar e desativar APIs Cloud através da CLI gcloud e da API Service Usage:

$ gcloud services enable pubsub.googleapis.com
$ gcloud services disable pubsub.googleapis.com

Ativar faturação

Algumas APIs Cloud cobram pela utilização. Tem de ativar a faturação para o seu projeto antes de poder começar a usar estas APIs no seu projeto. A utilização da API num projeto é cobrada à conta de faturação associada ao projeto.

Se não tiver uma conta de faturação, aceda à Google Cloud página de faturação da consola e siga as instruções para criar uma. Em seguida, associe a sua conta de faturação ao projeto.

Autenticação em APIs

A forma como se autentica numa API depende do seu ambiente de desenvolvimento e dos métodos de autenticação suportados pela API.

A configuração das credenciais padrão da aplicação para utilização numa variedade de ambientes é a abordagem mais comum e é recomendada para a maioria das aplicações. Se a API suportar chaves da API, essa é outra opção. Se a sua aplicação precisar de aceder a recursos do Google Cloud pertencentes aos seus utilizadores finais, crie um ID do cliente OAuth 2.0 e use as bibliotecas de autenticação.

Para informações gerais sobre a autenticação, consulte o artigo Autenticação na Google.

Criar aplicações

Se estiver a criar uma aplicação com APIs Cloud, recomendamos que use as bibliotecas cliente do Google Cloud, se disponíveis. As bibliotecas cliente podem processar funcionalidades comuns da API para sua conveniência, como autenticação, processamento de erros, repetição e validação de payload. Tem de transmitir as credenciais da sua aplicação às bibliotecas cliente durante a inicialização para que as bibliotecas cliente possam fazer chamadas paraGoogle Cloud APIs em nome da sua aplicação.

Consulte os seguintes guias passo a passo que usam as bibliotecas cliente para algumas APIs populares:

Para mais informações, consulte o artigo Bibliotecas de cliente explicadas.

Mais informações