Create a bucket with the Cloud Storage JSON/REST API
/ 50
Upload a file using the Cloud Storage JSON/REST API
/ 50
Un'API (interfaccia di programmazione di un'applicazione) è un programma software che permette agli sviluppatori di accedere a risorse di elaborazione e dati. Società di diversi settori rendono le loro API disponibili pubblicamente per consentire agli sviluppatori di integrare strumenti, librerie o servizi specializzati nei propri codebase e applicazioni.
In questo lab, esaminerai l'architettura e le funzionalità di base delle API. Potrai anche provare in prima persona a configurare ed eseguire i metodi dell'API Cloud Storage in Google Cloud Shell. Questo lab ti aiuta a comprendere i principi fondamentali della comunicazione, dell'architettura e dell'autenticazione delle API. Grazie alle prove pratiche avrai anche modo di fare esperienza con le API, che potrai applicare ad altri lab e progetti in futuro.
La possibilità di accedere a dati e risorse di elaborazione aumenta notevolmente l'efficienza degli sviluppatori. Usare un'API è molto più facile che creare da zero ciascun programma, metodo o set di dati. Le API si fondano sul principio dell'astrazione: non è necessario capirne i meccanismi o le complessità interne per usarle nel proprio ambiente.
Le API sono progettate per gli sviluppatori e spesso non dispongono di una Graphic User Interface (GUI). Tuttavia, ci sono delle eccezioni. Google ha rilasciato un nuovo strumento chiamato Explorer API, che permette di esplorare diverse API di Google in modo interattivo (per saperne di più, dai un'occhiata al lab Explorer API: Qwik Start).
Google offre API utilizzabili in diversi campi e settori. Le API vengono spesso impiegate per ambiti quali sviluppo web, machine learning, data science e workflow dell'amministrazione di sistema. Ma questi sono solo alcuni esempi di casi d'uso. Esplorando ad esempio AnyAPI, ti renderai conto di quante API sono disponibili.
Quando Qwiklabs esegue il provisioning di un nuovo progetto Google Cloud per l'istanza di un lab, abilita la maggior parte delle API "dietro le quinte", per consentirti di svolgere subito le attività del lab. Se crei progetti all'esterno di Qwiklabs, devi abilitare determinate API.
Familiarizzando con l'uso di Google Cloud, inizierai a usare più API nel tuo workflow. Gli utenti esperti integrano e utilizzano le API Cloud nei loro ambienti in modo quasi esclusivo e raramente ricorrono alla console Cloud per eseguire strumenti e servizi. Sono disponibili decine di lab pratici per sperimentare varie API di Google in diverse lingue.
In questo lab esplorerai la libreria API per scoprire le API di Google disponibili.
Gli argomenti trattati in questo lab sono:
Questo è un lab di livello base. È adatto per chi ha conoscenze scarse o nulle delle API ed esperienza scarsa o nulla nell'utilizzo delle API di Google. Suggeriamo, ma non è obbligatoria, esperienza con gli ambienti shell e gli strumenti di interfaccia a riga di comando. È consigliabile avere familiarità con la console Cloud e Cloud Storage. Quindi, prima di iniziare, ti consigliamo di seguire almeno questi lab:
Quando vuoi iniziare, scorri verso il basso e segui i passaggi indicati di seguito per configurare il tuo ambiente lab.
Leggi le seguenti istruzioni. I lab sono a tempo e non possono essere messi in pausa. Il timer si avvia quando fai clic su Inizia il lab e ti mostra per quanto tempo avrai a disposizione le risorse Google Cloud.
Con questo lab pratico avrai la possibilità di completare le attività in un ambiente cloud reale e non di simulazione o demo. Riceverai delle nuove credenziali temporanee che potrai utilizzare per accedere a Google Cloud per la durata del lab.
Per completare il lab, avrai bisogno di:
Fai clic sul pulsante Avvia lab. Se devi effettuare il pagamento per il lab, si aprirà una finestra di dialogo per permetterti di selezionare il metodo di pagamento. A sinistra, trovi il riquadro Dettagli lab con le seguenti informazioni:
Fai clic su Apri console Google Cloud (o fai clic con il tasto destro del mouse e seleziona Apri link in finestra di navigazione in incognito se utilizzi il browser Chrome).
Il lab avvia le risorse e apre un'altra scheda con la pagina di accesso.
Suggerimento: disponi le schede in finestre separate posizionate fianco a fianco.
Se necessario, copia il Nome utente di seguito e incollalo nella finestra di dialogo di accesso.
Puoi trovare il Nome utente anche nel riquadro Dettagli lab.
Fai clic su Avanti.
Copia la Password di seguito e incollala nella finestra di dialogo di benvenuto.
Puoi trovare la Password anche nel riquadro Dettagli lab.
Fai clic su Avanti.
Fai clic nelle pagine successive:
Dopo qualche istante, la console Google Cloud si apre in questa scheda.
Cloud Shell è una macchina virtuale in cui sono caricati strumenti per sviluppatori. Offre una home directory permanente da 5 GB e viene eseguita su Google Cloud. Cloud Shell fornisce l'accesso da riga di comando alle risorse Google Cloud.
Fai clic su Attiva Cloud Shell 
Fai clic nelle seguenti finestre:
Quando la connessione è attiva, l'autenticazione è già avvenuta e il progetto è impostato sul tuo Project_ID,
gcloud è lo strumento a riga di comando di Google Cloud. È preinstallato su Cloud Shell e supporta il completamento tramite tasto Tab.
Output:
Output:
gcloud, in Google Cloud, fai riferimento alla guida Panoramica dell'interfaccia a riga di comando gcloud.
Esegui questo comando per impostare la regione del tuo progetto:
Le API (interfacce di programmazione delle applicazioni) sono un insieme di metodi che consentono ai programmi di comunicare tra loro. Per comunicare efficacemente, i programmi devono seguire un protocollo chiaro che regoli il trasferimento e l'interpretazione dei dati. Internet è il canale di comunicazione standard che le API usano per trasmettere richieste e risposte tra programmi. Le API basate sul web utilizzano il modello client-server come architettura sottostante per scambiare informazioni. Il client è un dispositivo di elaborazione che invia una richiesta per ottenere una risorsa di elaborazione o dati, mentre il server ospita dati e/o risorse di elaborazione che interpretano ed eseguono la richiesta del client.
Dato che le API usano il web come canale di comunicazione, molte seguono il protocollo HTTP, che definisce regole e metodi per lo scambio di dati tra client e server tramite internet. Le API che utilizzano il protocollo HTTP utilizzano i metodi di richiesta HTTP (noti anche come "verbi HTTP") per trasmettere le richieste dei client ai server. I metodi di richiesta HTTP più comuni sono GET, POST, PUT e DELETE. GET viene usato da un client per recuperare dati da un server, PUT sostituisce i dati esistenti o crea dati se non esistono, POST viene usato principalmente per creare nuove risorse e DELETE rimuove i dati o le risorse specificati dal client su un server.
Le API usano i metodi HTTP per interagire con dati o servizi di elaborazione ospitati su un server. Questi metodi risultano inutili se non è disponibile un modo coerente per accedere a risorse specifiche. Le API sfruttano canali di comunicazione detti endpoint per consentire ai client di accedere alle risorse di cui hanno bisogno senza complicazioni o irregolarità. Gli endpoint sono punti di accesso a dati o risorse di elaborazione ospitati su un server e assumono la forma di URI HTTP. Gli endpoint vengono aggiunti all'URL di base di un'API per creare un percorso a una risorsa specifica o a un container di risorse specifico. Inoltre, è possibile aggiungere stringhe di query agli endpoint per inserire variabili che potrebbero essere necessarie per completare la richiesta di un'API.
Le API che utilizzano il protocollo, i metodi di richiesta e gli endpoint HTTP vengono dette API RESTful. Le API RESTful risiedono sul server, agendo come un "implementatore" delle richieste del client. Questo modello definisce un framework di endpoint (sostantivi) su cui agiscono i metodi HTTP (verbi) e le API utilizzano questo framework per rispondere alle richieste. In sintesi, le API RESTful utilizzano il modello client-server, aderiscono al protocollo HTTP, utilizzano metodi di richiesta HTTP e utilizzano endpoint per accedere a risorse specifiche.
Rispondi alle seguenti domande a scelta multipla per consolidare quanto hai imparato finora.
In questa sezione esplorerai la libreria API e abiliterai un'API. La libreria API è una posizione centralizzata per tutte le API di Google. Puoi utilizzare la libreria API per abilitare, disabilitare e gestire le API nei tuoi progetti.
La libreria API offre accesso rapido, documentazione e opzioni di configurazione per oltre 200 API di Google. Anche se si trova all'interno della console, è importante notare che la libreria ti consente di accedere a tutte le API di Google, non solo a quelle di Google Cloud. Questo evidenzia un concetto importante: le API sono fondamentali per tutti i servizi Google e non tutte le API Cloud fanno parte della categoria Google Cloud.
Adesso proverai ad abilitare un'API nella libreria API. Immagina di essere uno sviluppatore di app mobile e di voler creare un'applicazione per un sito di fitness. Per farlo utilizzerai l'API Google Fitness.
API Fitness e premi Invio.Si apre la pagina API Fitness e lo Stato dell'API è Abilitato.
Nella libreria API trovi link a tutorial, documentazione, termini di servizio e metodi interattivi disponibili in Explorer API. Per visualizzare informazioni sulle metriche e sull'utilizzo, usa la dashboard API e servizi. In questa pagina puoi visualizzare e richiedere quote, controllare l'accesso alle risorse e ai dati e visualizzare le metriche.
Per vedere una di queste funzionalità in azione, seleziona la scheda QUOTE E LIMITI DI SISTEMA.
Qui puoi vedere quante query questa API consente al giorno e al minuto.
Ora hai eseguito il provisioning di un'API non Cloud. Nelle sezioni successive scoprirai l'architettura e le funzionalità di base delle API. Quindi, ti eserciterai a utilizzare l'API Cloud Storage.
Rispondi alle seguenti domande a scelta multipla per consolidare quanto hai imparato finora.
Metti in pratica ciò che hai imparato eseguendo chiamate API REST/JSON Cloud Storage in Cloud Shell per creare bucket e caricare contenuti.
In una nuova scheda, apri l'API JSON di Google Cloud Storage per assicurarti che l'API Cloud Storage sia abilitata. Nota che l'API è abilitata.
In Cloud Shell, esegui questo comando per creare e modificare un file denominato values.json:
nano, copia e incolla il seguente blocco di codice. Poiché il bucket deve avere un nome univoco, nel nome del bucket viene utilizzato l'ID progetto:nano premendo Ctrl+X, Y e infine Invio.Hai appena creato un file JSON che contiene un oggetto con tre coppie chiave-valore: name, location e storageClass. Questi sono gli stessi valori necessari quando crei un bucket con lo strumento a riga di comando gsutil oppure nella console.
Prima di poter creare un bucket nell'API REST/JSON Cloud Storage, dovrai disporre delle policy di autenticazione e autorizzazione necessarie.
Autenticazione e autorizzazione sono due termini spesso usati in modo intercambiabile, ma non sono la stessa cosa.
Il processo di autenticazione identifica chi sei, mentre quello di autorizzazione determina cosa puoi fare.
Le API di Google utilizzano tre tipi di servizi di autenticazione/autorizzazione: "chiavi API", "service account" e "OAuth". Un'API utilizza uno di questi servizi di autenticazione a seconda delle risorse necessarie e da dove l'API viene richiamata.
Le chiavi API sono dei token segreti, solitamente sotto forma di stringhe criptate. Le chiavi API sono facili da creare e usare. Spesso, le API che utilizzano dati o metodi pubblici e che vogliono consentire agli sviluppatori di essere immediatamente operativi usano chiavi API per autenticare rapidamente gli utenti.
Nell'ambito di Google Cloud, le chiavi API identificano il progetto chiamante che esegue la chiamata a un'API. Identificando il progetto chiamante, le chiavi API consentono di associare le informazioni sull'utilizzo a quel progetto. Possono anche rifiutare le chiamate provenienti da progetti a cui non è stato autorizzato l'accesso o che non sono stati abilitati dall'API.
I token OAuth sono simili alle chiavi API dal punto di vista del formato, ma sono più sicuri e possono essere collegati ad account utente o identità. Vengono usati principalmente quando le API offrono a uno sviluppatore i mezzi per accedere ai dati utente.
Mentre le chiavi API concedono agli sviluppatori l'accesso a tutte le funzionalità di un'API, tutti gli ID client OAuth si basano sull'ambito: a identità diverse verranno assegnati privilegi diversi.
Un service account è un tipo speciale di Account Google che appartiene all'applicazione o a una macchina virtuale (VM) invece che a un singolo utente finale. L'applicazione assume l'identità del service account per chiamare le API di Google. In questo modo gli utenti non vengono coinvolti direttamente.
Puoi utilizzare un service account fornendo la relativa chiave privata all'applicazione oppure usando i service account integrati disponibili durante l'esecuzione su Cloud Functions, Google App Engine, Compute Engine o Google Kubernetes Engine.
Se ti interessa un lab specifico sui service account e i ruoli, vedi: Service account e ruoli: concetti fondamentali.
Poiché Cloud Storage è una piattaforma che ospita dati utente e vi fornisce l'accesso, dovrai creare un token OAuth prima di usare i suoi servizi.
Apri OAuth 2.0 Playground in una nuova scheda. Si tratta di un servizio che consente di creare facilmente token OAuth.
Scorri e seleziona Cloud Storage API V1 (API Cloud Storage V1).
Quindi, seleziona l'ambito https://www.googleapis.com/auth/devstorage.full_control.
Fai clic sulla casella blu che riporta Authorize APIs (Autorizza API). Si apre la pagina Accedi con Google.
Seleziona il tuo nome utente, quindi fai clic su Allow (Consenti) quando viene richiesta l'autorizzazione.
Si apre OAuth 2.0 Playground e puoi notare che al Passaggio 2 è stato creato un codice di autorizzazione.
Fai clic su Exchange authorization code for tokens (Scambia codice di autorizzazione per i token). Se la procedura continua al Passaggio 3, fai clic sul riquadro del Passaggio 2.
Copia il token di accesso da utilizzare nel passaggio successivo.
ls e premi Invio. Dovresti visualizzare il file values.json che hai creato in precedenza e un file README-cloudshell.txt:Output:
<YOUR_TOKEN> con il token di accesso che hai creato:values.json e sostituisci il nome del bucket. Questa richiesta rappresenta il culmine di quanto hai appreso finora. Hai utilizzato lo strumento di interfaccia a riga di comando curl per creare una richiesta di metodo POST HTTP. Hai inserito il file values.json nel corpo della richiesta. Hai inserito il token OAuth e una specifica JSON come intestazioni della richiesta. Questa richiesta è stata instradata all'endpoint di Cloud Storage, che contiene un parametro di stringa di query impostato per il tuo ID progetto.
Fai clic su Controlla i miei progressi per verificare l'attività eseguita. Il punteggio di valutazione si aggiorna se hai creato correttamente un bucket con l'API JSON/REST Cloud Storage.
Puoi usare l'API JSON/REST Cloud Storage per caricare i file nei bucket.
Nella sessione di Cloud Shell, fai clic sull'icona del menu con tre puntini nell'angolo in alto a destra, quindi fai clic su Carica > Scegli file. Seleziona e carica il file demo-image.png. In questo modo l'immagine verrà aggiunta alla directory.
Esegui questo comando per visualizzare il percorso del file immagine:
Dovrebbe essere restituito un output simile a questo:
<DEMO_IMAGE_PATH> con l'output del comando precedente:Dovrebbe essere restituito un output simile a questo:
Per visualizzare l'immagine aggiunta al bucket, apri il menu di navigazione e seleziona Cloud Storage > Bucket.
Fai clic sul nome del bucket per vedere che è stato aggiunto il file demo-image:
Fai clic su Controlla i miei progressi per verificare l'attività eseguita. Il punteggio di valutazione si aggiorna se hai caricato correttamente un file con l'API JSON/REST Cloud Storage
In questo lab hai acquisito una solida comprensione delle API e hai provato in prima persona l'API JSON/REST Cloud Storage. Hai scoperto cosa sono le API Cloud, l'architettura delle API, il protocollo e i metodi HTTP, gli endpoint, le API RESTful, il formato JSON e i metodi di autenticazione delle API. Ora hai tutti gli strumenti per partecipare ad altri lab di Qwiklabs sulle API.
Non perderti questi lab per esercitarti ancora con le API:
… per utilizzare al meglio le tecnologie Google Cloud. I nostri corsi ti consentono di sviluppare competenze tecniche e best practice per aiutarti a metterti subito al passo e avanzare nel tuo percorso di apprendimento. Offriamo vari livelli di formazione, dal livello base a quello avanzato, con opzioni di corsi on demand, dal vivo e virtuali, in modo da poter scegliere il più adatto in base ai tuoi impegni. Le certificazioni ti permettono di confermare e dimostrare le tue abilità e competenze relative alle tecnologie Google Cloud.
Ultimo aggiornamento del manuale: 26 febbraio 2024
Ultimo test del lab: 26 febbraio 2024
Copyright 2026 Google LLC. Tutti i diritti riservati. Google e il logo Google sono marchi di Google LLC. Tutti gli altri nomi di società e prodotti sono marchi delle rispettive società a cui sono associati.
Questi contenuti non sono al momento disponibili
Ti invieremo una notifica via email quando sarà disponibile
Bene.
Ti contatteremo via email non appena sarà disponibile
Un lab alla volta
Conferma per terminare tutti i lab esistenti e iniziare questo
