Antes de poder começar a programar a sua primeira aplicação cliente, 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 está familiarizado com as funcionalidades e os conceitos de faturação na nuvem na Google Cloud consola.
Se ainda não conhece conceitos como contas de faturação do Google Cloud e Google Cloud projetos, experimente a interface do utilizador antes de começar a programar.
Aprenda as noções básicas da REST
Existem duas formas de invocar a API Cloud Billing:
- Enviar pedidos HTTP e analisar as respostas.
- Usando bibliotecas de cliente.
Se decidir não usar bibliotecas de cliente, tem de compreender os princípios básicos da 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
As operações da API Cloud Billing são mapeadas diretamente para verbos HTTP REST.
Os formatos específicos dos URIs da Cloud Billing API são:
https://www.googleapis.com/billing/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 (REST, RPC).
Aprenda os conceitos básicos de JSON
A API Cloud Billing 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.