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.

Teste os recursos do Cloud Billing no Google Cloud console

Para seguir a documentação da API, é preciso que você já tenha usado Google Cloude conheça os recursos e conceitos do Cloud Billing no console Google Cloud . Se você ainda não conhece conceitos como contas do Cloud Billing, projetos do Google Cloud , produtos do Google Cloude orçamentos e alertas do Cloud Billing, leia o seguinte antes de começar a programar:

• Visão geral dos conceitos do Cloud Billing
• Gerenciar sua conta do Cloud Billing
• Visualizar projetos vinculados a uma conta de faturamento do Cloud
• Visão geral dos orçamentos e das regras de alerta de orçamento
• Gerenciar orçamentos de limite de gastos
• Controle de acesso para a API Cloud Billing Budget

Depois de se familiarizar com os recursos e conceitos do Cloud Billing, teste a Google Cloud interface do usuário do console.

Conceitos importantes do Cloud Billing

• Cada conta do Cloud Billing pode ter milhares de orçamentos associados a ela por vez. Consulte Cotas e limites para ver os limites atuais e outras informações.
• Um orçamento é vinculado a somente uma Conta de faturamento do Cloud por vez.
• Uma única conta do Cloud Billing é vinculada a um ou mais Google Cloud projetos e paga por eles.
• Um projeto do Google Cloud Google Cloud é vinculado a somente uma conta do Cloud Billing por vez.
• É possível criar orçamentos somente de alertas para monitorar os custos de uma conta inteira do Cloud Billing, incluindo todos os Google Cloud projetos pagos por essa conta. Também é possível definir o escopo dos orçamentos somente de alertas usando filtros de orçamento granulares para monitorar partes específicas dos custos. Os filtros incluem Google Cloud projetos, serviços, o período do orçamento e outros filtros aplicáveis à sua conta do Cloud Billing.
• É possível criar orçamentos com limite de gastos para limitar os gastos em um serviço qualificado em um Google Cloud projeto específico. Quando o limite de gastos é aplicado, o novo uso do serviço no projeto especificado é pausado até que o limite seja suspenso.

Aprender os fundamentos da REST

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

• Enviar solicitações HTTP e analisar as respostas.
• Usar bibliotecas de cliente (recomendado).

Se você não quiser usar as bibliotecas de cliente, precisará entender os fundamentos do REST.

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

O termo REST é a abreviação de "Representational State Transfer (Transferência de Estado Representacional)". 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 armazenados em um repositório de dados. Um cliente envia uma solicitação para o servidor realizar uma ação específica, como criar, recuperar, atualizar ou excluir um recurso. O servidor executa a ação e envia uma resposta, geralmente na forma 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/v1/resourcePath?parameters

O conjunto completo de URIs usados para cada operação compatível na API está resumido nos documentos de referência REST da API Cloud Billing Budget.

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).