Prerequisiti

Prima di poter iniziare a codificare la tua prima applicazione client, devi eseguire alcune operazioni, se non l'hai già fatto.

Crea un Account Google

Per ottenere l'accesso a Compute Engine nella console API di Google, devi disporre di un Account Google. Se hai già un account, è tutto pronto.

Ti consigliamo inoltre di creare un Account Google separato a scopo di test.

Registrati e prova Compute Engine

Per iniziare, puoi creare un'istanza VM su Compute Engine utilizzando una delle seguenti guide:

È importante acquisire familiarità con le nozioni di base di Compute Engine prima di continuare. La documentazione dell'API presuppone che tu abbia utilizzato Compute Engine e che tu conosca i concetti di programmazione web e i formati dei dati web.

Scopri di più sull'autenticazione

Esistono diversi modi per autenticarsi su Compute Engine, a seconda di come accedi all'API. Per ulteriori informazioni, consulta Autenticazione in Compute Engine.

Scopri di più su REST

Esistono due modi per richiamare l'API:

  • Inviare richieste HTTP e analizzarne le risposte.
  • Utilizzare le librerie client.

Se decidi di non utilizzare le librerie client, è necessario che tu conosca le nozioni di base di REST.

REST è un tipo di architettura software che fornisce un approccio pratico e coerente per la richiesta e la modifica dei dati.

Il termine REST è l'acronimo di "REpresentational State Transfer". Nel contesto delle API di Google, si riferisce all'utilizzo dei verbi HTTP per recuperare e modificare le rappresentazioni dei dati archiviati da Google.

In un sistema RESTful, le risorse vengono archiviate in un datastore. Un client invia una richiesta affinché il server esegua una determinata azione (ad esempio la creazione, il recupero, l'aggiornamento o l'eliminazione di una risorsa) e il server esegue l'azione e invia una risposta, spesso sotto forma di rappresentazione della risorsa specificata.

Nelle API RESTful di Google, il client specifica un'azione utilizzando un verbo HTTP, come POST, GETPUT o DELETE. Specifica una risorsa mediante un URI globalmente univoco nel seguente formato:

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

Poiché tutte le risorse dell'API dispongono di URI univoci accessibili tramite HTTP, REST consente la memorizzazione dei dati nella cache ed è ottimizzato per operare con l'infrastruttura distribuita del Web.

Potrebbero esserti utili le definizioni dei metodi riportate nella documentazione sugli standard HTTP 1.1, che includono specifiche per GET, POST, PUT e DELETE.

REST nell'API Compute Engine

Le operazioni dell'API Compute Engine vengono mappate direttamente ai verbi HTTP REST.

I formati specifici per gli URI dell'API Compute Engine sono:

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

Il set completo di URI utilizzati per ogni operazione supportata nell'API è riepilogato nel documento di riferimento sull'API Compute Engine.

Scopri di più sul formato dei dati JSON

L'API Compute Engine restituisce i dati in formato JSON.

JSON (JavaScript Object Notation) è un formato dati comune, indipendente dal linguaggio, che fornisce una semplice rappresentazione testuale di strutture di dati arbitrarie. Per ulteriori informazioni, visita il sito json.org.