Pré-requisitos

Antes de começar a codificar seu primeiro aplicativo cliente, há algumas coisas que você precisa fazer, caso ainda não tenha feito.

Obtenha uma conta do Google

Você precisa de uma Conta do Google para ter acesso ao Compute Engine no Console de APIs do Google. Se você já possui uma conta, está tudo pronto.

Você também pode querer uma Conta do Google separada para fins de teste.

Inscreva-se e experimente o Compute Engine

Para começar, crie uma instância de VM no Compute Engine usando um dos seguintes guias:

É importante familiarizar-se com os princípios básicos do Compute Engine antes de continuar. A documentação da API pressupõe que você tenha usado o Compute Engine e esteja familiarizado com os conceitos de programação da Web e os formatos de dados da Web.

Saiba mais sobre autenticação

Existem diferentes maneiras de autenticar no Compute Engine, dependendo de como você acessa a API. Para obter mais informações, consulte Autenticar no Compute Engine .

Aprenda sobre REST

Existem duas maneiras de invocar a API:

Se decidir não usar bibliotecas cliente, você precisará entender os conceitos básicos de REST.

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 “ Transferência de Estado Representacional ”. No contexto das APIs do Google, refere-se ao uso de verbos HTTP para recuperar e modificar representações de dados armazenados pelo Google.

Em um sistema RESTful, os recursos são armazenados em um armazenamento de dados; um cliente envia uma solicitação para que o servidor execute uma ação específica (como criar, recuperar, atualizar ou excluir um recurso), e o servidor executa a ação e envia uma resposta, geralmente na forma de uma representação do recurso especificado.

Nas APIs RESTful do Google, o cliente especifica uma ação usando um verbo HTTP como POST , GET , PUT ou DELETE . Ele especifica um recurso por um URI globalmente exclusivo no seguinte formato:

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

Como todos os recursos da API possuem URIs exclusivos acessíveis por HTTP, o REST permite o armazenamento em cache de dados e é otimizado para funcionar com a infraestrutura distribuída da web.

Você pode achar úteis as definições de método na documentação dos padrões HTTP 1.1; eles incluem especificações para GET , POST , PUT e DELETE .

REST na API Compute Engine

As operações da API Compute Engine são mapeadas diretamente para verbos HTTP REST.

Os formatos específicos para URIs da API Compute Engine são:

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

O conjunto completo de URIs usados ​​para cada operação compatível na API está resumido no documento de referência da API do Compute Engine .

Saiba mais sobre o formato de dados JSON

A API Compute Engine retorna dados no formato JSON.

JSON (JavaScript Object Notation) é um formato de dados comum e independente de linguagem que fornece uma representação de texto simples de estruturas de dados arbitrárias. Para obter mais informações, consulte json.org .