Pré-requisitos

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 de faturamento no Console do Google Cloud Platform

Esta documentação da API pressupõe que você usou o Google Cloud Platform e que está familiarizado com os recursos e conceitos de faturamento no Console do Google Cloud Platform.

Se você não estiver familiarizado com conceitos como projetos e contas de faturamento, teste a interface do usuário antes de começar a codificar.

Aprender os fundamentos sobre a REST

Há duas maneiras de invocar a API:

Se você não quer usar as bibliotecas cliente, precisa entender os fundamentos do 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 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 RESTful APIs 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, o REST permite o armazenamento em cache de dados e é otimizado para trabalhar com a infraestrutura distribuída da Web.

As definições de métodos encontradas na documentação de padrões HTTP 1.1 podem ser úteis. Elas incluem as especificações de GET, POST, PUT e DELETE.

REST na Google Cloud Billing API

As operações da Google Cloud Billing API mapeiam diretamente para os verbos HTTP da REST.

Os formatos específicos dos URIs da Google Cloud Billing API são:

https://www.googleapis.com/billing/v1/resourcePath?parameters

O conjunto completo de URIs usados em cada operação compatível na API está resumido nos documentos de referência da API Google Cloud Billing (REST, RPC).

Aprender os fundamentos sobre o JSON

A Google Cloud Billing API retorna dados no formato JSON.

JSON (notação de objetos do JavaScript) é um formato de dados comum, independente de linguagem, que fornece uma representação das estruturas de dados arbitrárias em formato de texto simples. Para mais informações, acesse json.org.

Esta página foi útil? Conte sua opinião sobre: