Prima di iniziare a scrivere il codice della tua prima applicazione di budget di fatturazione Cloud, se non l'hai già fatto, devi completare alcune operazioni.
Prova le funzionalità di Fatturazione Cloud nella console Google Cloud
Questa documentazione dell'API presuppone che tu abbia utilizzato Google Cloud e che tu abbia familiarità con le funzionalità e i concetti di fatturazione cloud nella console Google Cloud. Se non hai familiarità con concetti come account di fatturazione Cloud, progetti Google Cloud, prodotti Google Cloud, budget e avvisi di fatturazione Cloud, leggi quanto segue prima di iniziare a scrivere codice:
- Panoramica dei concetti della fatturazione Cloud
- Gestire l'account di fatturazione Cloud
- Visualizzare i progetti collegati a un account di fatturazione Cloud
- Budget e regole di avviso relativo al budget
- Controllo degli accessi per l'API Cloud Billing Budget
Dopo aver acquisito familiarità con le funzionalità e i concetti di Fatturazione Cloud, prova la interfaccia utente della console Google Cloud.
Concetti chiave della fatturazione Cloud
- A ogni account di fatturazione Cloud singolo possono essere associati contemporaneamente diversi migliaia di budget. Per i limiti attuali e ulteriori informazioni, consulta Quote e limiti.
- Un budget è collegato a un solo account di fatturazione Cloud alla volta.
- Un singolo account di fatturazione Cloud è collegato a uno o più progetti Google Cloud e ne paga i costi.
- Un progetto Google Cloud è collegato a un solo account di fatturazione Cloud alla volta.
- Puoi creare un budget per monitorare i costi di un intero account di fatturazione Cloud, inclusi tutti i progetti Google Cloud pagati da quell'account di fatturazione. Puoi anche definire l'ambito del budget utilizzando filtri di budget granulari per monitorare sezioni specifiche dei costi. I filtri includono progetti, servizi Google Cloud, il periodo di tempo del bilancio e altri filtri applicabili al tuo account di fatturazione Cloud.
Apprendere le nozioni di base di REST
Esistono due modi per richiamare l'API Cloud Billing Budget:
- Inviare richieste HTTP e analizzarne le risposte.
- Utilizzo delle librerie client (opzione consigliata).
Se decidi di non utilizzare le librerie client, devi conoscere le nozioni di base su 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 mediante un verbo HTTP come POST
, GET
, PUT
o DELETE
. La risorsa viene specificata tramite un URI globalmente univoco con il 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.
Potresti trovare utili le definizioni dei metodi nella documentazione degli standard HTTP 1.1; includono le specifiche per GET
, POST
, PUT
e DELETE
.
REST nell'API Cloud Billing Budget
Le operazioni dell'API Cloud Billing Budget mappano direttamente ai verbi HTTP REST.
I formati specifici per gli URI dell'API Cloud Billing Budget sono:
https://billingbudgets.googleapis.com/v1/resourcePath?parameters
L'insieme completo di URI utilizzati per ogni operazione supportata nell'API è riassunto nei documenti di riferimento dell'API Cloud Billing Budget (REST, RPC).
Apprendere le nozioni di base di JSON
L'API Cloud Billing Budget restituisce i dati in formato JSON.
JSON (JavaScript Object Notation) è un formato di dati comune e indipendente dal linguaggio che fornisce una semplice rappresentazione di testo di strutture di dati arbitrarie. Per ulteriori informazioni, visita il sito json.org.