Pré-requisitos da API Cloud Billing Budget

Antes de começar a codificar seu primeiro aplicativo de orçamento do Faturamento do Cloud, você precisa realizar algumas tarefas.

Testar os recursos do Faturamento do Cloud no Console do Google Cloud

Para seguir a documentação da API, é preciso que você já tenha usado o Google Cloud e conheça os recursos e conceitos do Faturamento do Cloud no Console do Google Cloud. Se você não conhece bem conceitos como contas de faturamento do Cloud, projetos e produtos do Google Cloud ou orçamentos e alertas do Faturamento do Cloud, leia estes documentos de faturamento antes de começar a codificar:

Após se familiarizar com os recursos e conceitos do Faturamento do Cloud, teste a interface do usuário do Console do Cloud.

Conceitos importantes do Faturamento do Cloud

  • Uma Conta de faturamento do Cloud pode ter muitos orçamentos associados (até 5.000 de cada vez).
  • Um orçamento é vinculado a somente uma Conta de faturamento do Cloud por vez.
  • Uma Conta de faturamento do Cloud é vinculada e paga por um ou mais projetos do Google Cloud.
  • Um projeto do Google Cloud é vinculado a somente uma Conta de faturamento do Cloud por vez.
  • É possível criar um orçamento para monitorar os custos de uma Conta de faturamento do Cloud inteira, incluindo todos os projetos do Google Cloud pagos por ela. É possível também usar filtros de orçamento granulares para monitorar partes específicas dos custos em grupos de projetos e serviços do Google Cloud.

Conhecer os fundamentos de REST

Há duas maneiras de invocar a API Cloud Billing Budget:

Em breve: as bibliotecas de cliente da API Cloud Billing Budget compatíveis com o Google estarão disponíveis em breve para várias linguagens conhecidas. As bibliotecas de cliente oferecem melhor integração de linguagens, mais segurança e compatibilidade com chamadas que exigem autorização do usuário.

Até que elas sejam disponibilizadas, você precisará entender os fundamentos de REST.

REST é um estilo de arquitetura de software que fornece uma abordagem conveniente e consistente para solicitar e modificar dados.

O termo REST é a sigla de Representational State Transfer. No contexto das APIs do Google, ele se refere ao uso de verbos HTTP para recuperar e modificar representações de dados armazenados pelo Google.

Em um sistema RESTful, os recursos são mantidos em um armazenamento de dados. Um cliente envia uma solicitação para que uma ação específica seja executada no servidor, como a criação, recuperação, atualização ou exclusão de um recurso. Essa ação é executada e uma resposta é enviada, geralmente no formato de uma representação do recurso especificado.

Nas APIs RESTful do Google, uma ação é especificada no cliente usando um verbo HTTP como POST, GET, PUT ou DELETE. Um recurso é definido por meio de um URI global exclusivo no seguinte formato:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Como todos os recursos da API têm URIs exclusivos acessíveis por HTTP, a REST permite o armazenamento em cache dos dados e é otimizada para funcionar na infraestrutura distribuída da Web.

As definições de método (em inglês) encontradas na documentação dos padrões HTTP 1.1 podem ser úteis. Nelas estão incluídas as especificações GET, POST, PUT e DELETE.

REST na API Cloud Billing Budget

As operações da API Cloud Billing Budget são mapeadas diretamente para os verbos HTTP da REST.

Veja a seguir os formatos específicos dos URIs da API Cloud Billing Budget:

https://billingbudgets.googleapis.com/v1beta1/resourcePath?parameters

O conjunto completo dos URIs usados para cada operação aceita na API está resumido nos documentos de referência da API Cloud Billing Budget (REST, RPC, links em inglês){: track-type="tasks" track-name="internalLink" track-metadata-position="body" }.

Conhecer os fundamentos do JSON

A API Cloud Billing Budget retorna os dados no formato JSON.

JSON (JavaScript Object Notation) é um formato de dados comum e independente de linguagem que oferece uma representação de texto simples das estruturas de dados arbitrárias. Para mais informações, acesse json.org (em inglês).