Primeiros passos

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

Como criar uma Conta do Google

Para usar as APIs do Cloud nos seus aplicativos, primeiro você precisa ter uma Conta do Google. Isso permite que você use os produtos para desenvolvedores do Google, como o Console do Cloud e o Stackdriver Logging and Monitoring. Se você não tem uma Conta do Google, inscreva-se aqui.

Como criar um projeto do Google

Para usar as APIs do Cloud, você também precisa ter um projeto do Google. Um projeto é equivalente a uma conta de desenvolvedor. Ele serve como um contêiner de recursos para os recursos do Google Cloud Platform (GCP). Ele também fornece um limite de isolamento para o uso dos serviços do GCP, para que você possa gerenciar os limites de cota e o faturamento de maneira independente no nível do projeto. A telemetria e os painéis de uso também são agrupados por projeto. Se você ainda não tiver um projeto, crie um usando o Console do Cloud.

Um projeto pode ter uma ampla variedade de recursos, incluindo chaves de API, clientes OAuth, contas de serviço, VMs do Compute Engine, buckets do Cloud Storage e conjuntos de dados do BigQuery. Quando um aplicativo chama uma API do Cloud, o projeto que possui as credenciais do aplicativo é chamado de projeto cliente, e o projeto que possui o recurso de destino é chamado de projeto de recurso. Uma solicitação de API pode tocar em vários recursos, portanto, vários projetos de recursos estão envolvidos.

Se você quiser parar de usar o GCP por qualquer motivo, use o Console do Cloud para excluir seu projeto. Seu projeto e todos os recursos no projeto serão excluídos após a janela de retenção. Os diferentes tipos de dados têm períodos de retenção diferentes.

Ativando APIs

Para usar uma API do Cloud, você precisa ativá-la para seu projeto. Dependendo de quantos projetos estão envolvidos, incluindo o projeto cliente e os projetos de recursos, pode ser necessário ativar uma API para vários projetos.

Para ativar uma API, você precisa aceitar os Termos de Serviço e a responsabilidade de faturamento da API. Você precisa da permissão serviceusage.services.enable no projeto e na permissão servicemanagement.services.bind na API para ativá-la. Para mais informações, consulte Controle de acesso do Service Usage.

Para ativar uma API para um projeto usando o console:

  1. Acesse a biblioteca de APIs do Console do Cloud.
  2. Na lista de projetos, selecione um projeto ou crie um novo.
  3. Na Biblioteca de APIs, selecione a API que você 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, você pode desativar uma API para seu projeto se não usá-la mais para evitar o uso indevido e cobranças acidentais. Também é possível ativar e desativar as APIs do Cloud usando o SDK do Cloud e a API Service Usage.

Ativando faturamento

Algumas APIs do Cloud cobram pelo uso. Você precisa ativar o faturamento para seu projeto antes de começar a usar essas APIs no projeto. O uso da API em um projeto é cobrado na conta de faturamento associada ao projeto.

Se você não tiver uma conta de faturamento, acesse a página de faturamento do Console do Cloud e siga as instruções para criar uma. Em seguida, vincule sua conta de faturamento ao seu projeto.

Como criar aplicativos

Se você estiver criando um aplicativo usando APIs do Cloud, recomendamos usar as bibliotecas de cliente do Google Cloud, se disponíveis. As bibliotecas de cliente lidam com recursos comuns da API para sua conveniência, como autenticação, tratamento de erros, repetição e validação de carga útil. Para mais informações, consulte Explicações sobre bibliotecas de cliente.

Como conseguir e usar credenciais de aplicativos

As APIs do Cloud aceitam apenas solicitações de API de aplicativos registrados. Essa restrição ajuda os produtores de API a relatar e associar o uso da API ao projeto correto do Google que possui o aplicativo.

As APIs do Cloud usam credenciais de aplicativo para identificar os aplicativos de chamada. Os tipos de credenciais incluem chaves de API, clientes OAuth 2.0 e contas de serviço. Para mais informações sobre autenticação e credenciais do aplicativo, consulte Visão geral da autenticação.

Se você é novo nas APIs do Google e quer apenas executar alguns testes manuais antes de escrever qualquer código, use oauth2l para gerar as credenciais de solicitação e usá-las com o comando curl.

Mais informações

Para mais informações sobre faturamento, consulte Criar, modificar ou fechar sua conta de faturamento.

Para informações sobre como ativar o faturamento no seu projeto, consulte Modificar as configurações de faturamento de um projeto.

Para ver mais informações sobre como usar uma API ou uma ferramenta de linha de comando para ativar e desativar APIs, consulte Como ativar e desativar serviços na Documentação do Service Usage.