Antes de empezar a programar tu primera aplicación cliente, tienes que hacer varias cosas (si es que aún no las has hecho):
Prueba las funciones de facturación de Cloud en la Google Cloud consola
En esta documentación de la API se presupone que ya has utilizado Google Cloudy que conoces las funciones y los conceptos de facturación de Cloud de la consola Google Cloud .
Si aún no conoces conceptos como las cuentas de facturación de Cloud y los Google Cloud proyectos, prueba la interfaz de usuario antes de empezar a programar.
Conocer los aspectos básicos de REST
Hay dos formas de invocar la API Cloud Billing:
- Enviar peticiones HTTP y analizar las respuestas.
- Utilizar bibliotecas cliente.
Si prefieres no utilizar las bibliotecas cliente, tendrás que comprender los aspectos básicos de REST.
REST es un tipo de arquitectura de software que proporciona un método cómodo y uniforme para enviar peticiones y modificar datos.
El término REST es la abreviatura en inglés de "Representational State Transfer" (transferencia de estado representacional). En el contexto de las API de Google, hace referencia al uso de verbos HTTP para obtener y modificar representaciones de datos que ha almacenado Google.
En un sistema RESTful (es decir, que utiliza una arquitectura REST), los recursos se guardan en un almacén de datos. El cliente envía una petición para que el servidor realice una acción determinada (como crear, obtener, actualizar o eliminar un recurso) y este, tras llevarla a cabo, envía una respuesta, normalmente como una representación del recurso especificado.
En las API RESTful de Google, el cliente especifica una acción mediante un verbo HTTP como POST, GET, PUT o DELETE. El recurso se especifica globalmente mediante un URI exclusivo con el siguiente formato:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Como todos los recursos de la API tienen URI accesibles mediante HTTP, REST permite almacenar los datos en caché y está optimizado para funcionar con la infraestructura distribuida de la Web.
Pueden resultarte útiles las definiciones de métodos de la documentación del estándar HTTP 1.1, ya que incluyen las especificaciones de GET, POST, PUT y DELETE.
REST en la API Cloud Billing
Las operaciones de la API Cloud Billing están directamente asociadas a verbos HTTP de REST.
El formato específico para los URIs de la API Cloud Billing es:
https://www.googleapis.com/billing/v1/resourcePath?parameters
El conjunto completo de URIs utilizados para cada operación admitida en la API se resume en los documentos de referencia de la API Cloud Billing (REST y RPC).
Conocer los aspectos básicos de JSON
La API Cloud Billing devuelve datos en formato JSON.
JSON (JavaScript Object Notation) es un formato de datos común e independiente del lenguaje que proporciona una representación de texto sencilla de estructuras de datos arbitrarias. Para obtener más información, consulta json.org.