Requisitos previos

Antes de que comiences a escribir el código de tu primera aplicación cliente, hay unas cuantas tareas que debes realizar si aún no las has hecho.

Crea una Cuenta de Google

Necesitas una Cuenta de Google para tener acceso a Compute Engine en la Consola de API de Google. Si ya tienes una cuenta, no tienes que hacer nada más.

También puedes usar Cuenta de Google separada para fines de prueba.

Regístrate y prueba Compute Engine

Para comenzar, puedes crear una instancia de VM en Compute Engine; para ello, usa una de las siguientes guías:

Es importante que te familiarices con los conceptos básicos de Compute Engine antes de continuar. En la documentación de la API, se supone que ya usaste Compute Engine y que estás familiarizado con los conceptos de programación web y los formatos de datos web.

Obtén más información sobre la autenticación.

Existen diferentes maneras de autenticarse en Compute Engine según la forma en que accedas a la API. Para obtener más información, consulta Autentícate en Compute Engine.

Más información sobre REST

Existen dos maneras de invocar la API:

Si decides no usar bibliotecas cliente, deberás comprender los aspectos básicos de REST.

REST es un estilo de arquitectura de software que proporciona un enfoque conveniente y coherente para solicitar y modificar datos.

El término REST es la abreviatura de "Representational State Transfer" (transferencia de estado representacional). En el contexto de las API de Google, se refiere al uso de los verbos HTTP para recuperar y modificar las representaciones de los datos almacenados por Google.

En un sistema RESTful, los recursos se almacenan en un almacén de datos; un cliente envía una solicitud para que el servidor ejecute una acción en particular (como crear, recuperar, actualizar o borrar un recurso) y el servidor ejecuta la acción y envía una respuesta que, por lo general, es una representación del recurso especificado.

En las API con tecnología REST de Google, el cliente especifica una acción con un verbo HTTP como POST, GET, PUTDELETE. Especifica un recurso mediante un URI único a nivel global de la siguiente manera:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Dado que todos los recursos de API tienen URI únicos accesibles a través de HTTP, REST permite el almacenamiento de datos en caché y está optimizado para funcionar con la infraestructura distribuida de la Web.

Puedes encontrar las definiciones de métodos en la documentación de estándares del HTTP 1.1, los que incluyen especificaciones para GET, POST, PUT y DELETE.

REST en la API de Compute Engine

Las operaciones de la API de Compute Engine se asignan directamente a los verbos HTTP de REST.

Los formatos específicos para los URI de la API de Compute Engine son los siguientes:

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

El conjunto completo de URI utilizados para cada operación compatible en la API se resume en el documento Referencia de la API de Compute Engine.

Obtén más información sobre el formato de datos JSON

La API de Compute Engine muestra datos en formato JSON.

JSON (JavaScript Object Notation) es un formato de datos común y, también, independiente del lenguaje que proporciona una representación de texto simple de estructuras de datos arbitrarias. Para obtener más información, visita json.org.