Antes de começar a codificar seu primeiro aplicativo cliente, há algumas coisas que você precisa fazer, se ainda não tiver feito.
Testar os recursos do Cloud Billing 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 Cloud Billing no Console do Google Cloud.
Se você ainda não tiver familiaridade com conceitos como "contas de faturamento do Google Cloud" e "projetos do Cloud", teste a interface do usuário antes de começar a codificar.
Conhecer os fundamentos de REST
Há duas maneiras de invocar a API Cloud Billing:
- Enviar solicitações HTTP e analisar as respostas.
- Usar bibliotecas de cliente.
Se você não quer usar as bibliotecas de cliente, precisa entender os fundamentos da REST.
O 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 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
As operações da API Cloud Billing são mapeadas diretamente para verbos HTTP REST.
Os formatos específicos para os URIs da API Cloud Billing são:
https://www.googleapis.com/billing/v1/resourcePath?parameters
O conjunto completo dos URIs usados para cada operação permitida na API está resumido nos documentos de referência da API Cloud Billing Budget (REST, RPC).
Aprender os fundamentos do JSON
A API Cloud Billing retorna 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).