Antes de começar a programar a sua primeira aplicação de orçamento do Cloud Billing, tem de fazer algumas coisas, se ainda não as tiver feito.
Experimente as funcionalidades do Cloud Billing na Google Cloud consola
Esta documentação da API pressupõe que usou o Google Cloude que conhece as funcionalidades e os conceitos da Faturação do Google Cloud na consola Google Cloud . Se ainda não conhece conceitos como contas do Cloud Billing, Google Cloud projetos, Google Cloud produtos e orçamentos e alertas do Cloud Billing, leia o seguinte antes de começar a programar:
- Vista geral dos conceitos do Cloud Billing
- Faça a gestão da sua conta de faturação do Google Cloud
- Veja os projetos associados a uma conta do Cloud Billing
- Orçamentos e regras de alerta de orçamento
- Controlo de acesso para a API Cloud Billing Budget
Depois de se familiarizar com as funcionalidades e os conceitos da Cloud Billing, experimente a Google Cloud interface do utilizador da consola.
Conceitos-chave do Cloud Billing
- Cada conta de faturação do Google Cloud pode ter vários milhares de orçamentos associados em simultâneo. Consulte Quotas e limites para ver os limites atuais e informações adicionais.
- Um orçamento está associado apenas a uma conta de faturação do Google Cloud de cada vez.
- Uma única conta do Cloud Billing está associada a um ou maisGoogle Cloud projetos e paga por eles.
- Um Google Cloud projeto está associado apenas a uma conta do Cloud Billing de cada vez.
- Pode criar um orçamento para monitorizar os custos de uma conta do Cloud Billing inteira, incluindo todos os Google Cloud projetos pagos por essa conta de faturação. Também pode definir o âmbito do orçamento através de filtros de orçamento detalhados para monitorizar partes específicas dos seus 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.
Aprenda as noções básicas da REST
Existem duas formas de invocar a API Cloud Billing Budget:
- Enviar pedidos HTTP e analisar as respostas.
- Usando bibliotecas de cliente (recomendado).
Se decidir não usar bibliotecas de cliente, tem de compreender os princípios básicos do REST.
REST é um estilo de arquitetura de software que oferece uma abordagem prática e consistente para pedir e modificar dados.
O termo REST é a abreviatura de "Representational State Transfer". No contexto das APIs Google, refere-se à utilização de verbos HTTP para obter e modificar representações de dados armazenados pela Google.
Num sistema RESTful, os recursos são armazenados num repositório de dados; um cliente envia um pedido para que o servidor execute uma ação específica (como criar, obter, atualizar ou eliminar um recurso), e o servidor executa a ação e envia uma resposta, muitas vezes sob a forma de uma representação do recurso especificado.
Nas APIs RESTful da Google, o cliente especifica uma ação através de um verbo HTTP, como POST, GET, PUT ou DELETE. Especifica um recurso através de um URI globalmente exclusivo do seguinte formulário:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Uma vez que todos os recursos da API têm URIs acessíveis por HTTP exclusivos, o REST permite o armazenamento em cache de dados e está otimizado para funcionar com a infraestrutura distribuída da Web.
Pode achar as definições de métodos na documentação das normas HTTP 1.1 úteis. Estas incluem especificações para GET, POST, PUT e DELETE.
REST na API Cloud Billing Budget
As operações da API Cloud Billing Budget são mapeadas diretamente para verbos HTTP REST.
Os formatos específicos dos URIs da API Google Cloud Billing Budget são:
https://billingbudgets.googleapis.com/v1/resourcePath?parameters
O conjunto completo de URIs usado para cada operação suportada na API é resumido nos documentos de referência da API Cloud Billing Budget (REST, RPC).
Aprenda os conceitos básicos de JSON
A API Cloud Billing Budget devolve dados no formato JSON.
O JSON (JavaScript Object Notation) é um formato de dados comum e independente do idioma que oferece uma representação de texto simples de estruturas de dados arbitrárias. Para mais informações, consulte json.org.