API di Google Cloud

Le API Google Cloud sono interfacce programmatiche per i servizi della piattaforma Google Cloud. Sono un componente chiave della piattaforma Google Cloud e ti consentono di aggiungere facilmente alle tue applicazioni la potenza di tutto, dal calcolo alla rete, all'archiviazione e all'analisi dei dati basata sul machine learning.

Informazioni sulle API Cloud

Le API Cloud vengono esposte ai clienti come servizi API di rete, ad esempio l'API Cloud Pub/Sub. In genere, ogni API Cloud viene eseguita su uno o più sottodomini di googleapis.com, ad esempio pubsub.googleapis.com, e fornisce sia interfacce JSON HTTP che gRPC ai client tramite internet pubblico e reti VPC (Virtual Private Cloud). I client possono inviare richieste HTTP e gRPC agli endpoint dell'API Cloud direttamente o utilizzando le librerie client.

Le API cloud fanno parte della categoria API Google Enterprise nella libreria API della console Google Cloud.

Esistono due tipi di Google Cloud API:

• API basate sulle risorse, che utilizzano il progetto associato alle risorse a cui viene eseguito l'accesso per la fatturazione e la quota.

• API basate su client, che utilizzano il progetto associato al client per accedere alle risorse per la fatturazione e la quota.

Accesso alle API Cloud

Puoi accedere alle API Cloud dalle applicazioni server con le nostre librerie client in molti linguaggi di programmazione comuni, dalle app mobile tramite gli SDK Firebase o utilizzando client di terze parti. Puoi anche accedere alle API Cloud con Google Cloud CLI o la console Google Cloud.

Se non hai dimestichezza con le API Cloud, consulta la guida introduttiva su come utilizzarle.

Supporto di HTTP e gRPC

Tutte le API Cloud forniscono una semplice interfaccia HTTP JSON che puoi chiamare direttamente o tramite le librerie client delle API di Google. La maggior parte delle API Cloud fornisce anche un'interfaccia gRPC che puoi chiamare tramite le librerie client di Google Cloud, che offrono prestazioni e usabilità migliori. Puoi anche utilizzare client di terze parti.

Per ulteriori informazioni sulle nostre librerie client, consulta Descrizione delle librerie client.

Per ulteriori informazioni sull'autenticazione per l'utilizzo delle API di Google, consulta Metodi di autenticazione di Google e Autenticazione per l'utilizzo delle librerie client.

Crittografia TLS

Tutte le API Cloud accettano solo richieste sicure che utilizzano la crittografia TLS.

• Se utilizzi una delle nostre librerie client, la crittografia in transito viene gestita dalla libreria.
• Se utilizzi il tuo client gRPC, devi autenticarti con Google (che richiede TLS) seguendo le istruzioni riportate nella guida all'autenticazione gRPC.
• Se stai creando il tuo client HTTP, consulta le nostre linee guida HTTP.

Puoi scoprire di più su come viene protetto il traffico verso i Google Cloud servizi nella nostra guida alla sicurezza sulla crittografia in transito.

Private Service Connect

I clienti aziendali spesso vogliono accedere alle API Cloud in privato per motivi di sicurezza e conformità. Puoi utilizzare Private Service Connect per configurare e gestire questo tipo di accesso all'interno delle tue reti VPC.

Per ulteriori informazioni, consulta la pagina sulla configurazione di Private Service Connect.

Esempi dettagliati

Consulta le seguenti guide passo passo che utilizzano le librerie client per alcune API di uso comune:

• API Cloud Billing Budget con Node.js.
• API Cloud Billing Budget con Python.
• Cloud Logging con Node.js.
• Cloud Logging con Python.
• Cloud Logging con Go.
• Cloud Logging con Java.
• Speech-to-Text con Node.js.
• Speech-to-Text con Python.
• Speech-to-Text con Go.
• Speech-to-Text con Java.

Guida alla progettazione delle API

Indipendentemente dal tipo di interfaccia, tutte le API Cloud utilizzano principi di progettazione orientati alle risorse, come descritto nella nostra guida alla progettazione delle API, che garantisce un'esperienza dello sviluppatore semplice e coerente. Per comprendere meglio le API Cloud, puoi consultare la nostra guida alla progettazione delle API.

Se vuoi studiare la definizione dell'interfaccia delle API Cloud, puoi visitare il repository API di Google su GitHub.

Impostare un limite di utilizzo

Le API cloud sono condivise tra milioni di sviluppatori e utenti. Per garantire un utilizzo corretto e ridurre al minimo i rischi di abuso, tutte le API Cloud applicano limiti di frequenza e quote di risorse sull'utilizzo, comunemente note come quote. Puoi anche utilizzare queste quote per controllare la tua spesa per i prodotti Google Cloud riducendo i tuoi limiti di quota. Se hai bisogno di più quote rispetto ai limiti predefiniti, devi inviare richieste di aumento delle quote.

Per ulteriori informazioni, consulta la sezione Limitazione dell'utilizzo delle API.

Monitoraggio dell'utilizzo

La maggior parte delle API Cloud fornisce informazioni dettagliate su come il progetto utilizza l'API, tra cui i livelli di traffico, la frequenza degli errori e le latenze. Ti aiuta a valutare rapidamente la priorità dei problemi relativi alle applicazioni che utilizzano le API Cloud. Puoi visualizzare queste informazioni nella dashboard API di Google Cloud nella console Google Cloud. Puoi anche creare dashboard e avvisi personalizzati in Cloud Monitoring.

Per saperne di più, consulta Monitoraggio dell'utilizzo delle API.

API Google Enterprise

Le API Google Enterprise sono API ad alta stabilità, pronte per l'uso aziendale con opzioni di assistenza disponibili.

Per saperne di più, consulta API Google Enterprise.