Le librerie client ottimizzano l'esperienza degli sviluppatori per le chiamate all'API Google Chat riducendo il codice boilerplate da scrivere. Questa guida introduce librerie client e spiega come installarle.
L'API Chat ha gRPC e REST interfacce librerie client che supportano entrambi. Le librerie client di Cloud supportano gRPC e REST interfacce client delle API di Google, le librerie client delle API di Google supportano solo l'interfaccia REST, possono utilizzare entrambe le librerie client nello stesso progetto. Facoltativamente, se le librerie client fornite non soddisfano le tue esigenze, puoi scrivere librerie client che utilizzano l'interfaccia gRPC o REST.
Per scoprire di più su i tipi di librerie client supportati da Google, consulta Spiegazione delle librerie client.
Installa le librerie client di Cloud (consigliato)
Librerie client di Cloud sono le librerie client più recenti e consigliate per chiamare API Chat. Le librerie client di Cloud supportano sia gRPC sia REST interfacce.
L'API Chat fornisce librerie client di Cloud per le lingue seguenti. Seleziona la lingua che vuoi utilizzare:
Node.js
Per installare la libreria client:
npm install @google-apps/chat
Scopri di più:
Java
Seleziona il tuo ambiente di build dalle schede seguenti. Qualsiasi cosa tu voglia usa, ricordati di aggiornare la versione alla release più recente disponibile su GitHub.
Maven con BOM
Se utilizzi Maven con
BOM
aggiungi questo al tuo file pom.xml
:
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>libraries-bom</artifactId>
<version>26.42.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
</dependency>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.10.0</version>
</dependency>
Maven senza BOM
Se utilizzi Maven senza BOM aggiungi questo alle tue dipendenze:
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-chat</artifactId>
<version>0.9.0</version>
</dependency>
Gradle
Se utilizzi Gradle senza BOM aggiungi questo alle tue dipendenze:
implementation 'com.google.cloud:google-cloud-chat:0.10.0'
SBT
Se utilizzi SBT, aggiungi questo alle dipendenze:
libraryDependencies += "com.google.cloud" % "google-cloud-chat" % "0.10.0"
Scopri di più:
Python
Su Mac o Linux, esegui:
python3 -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat
Su Windows, dall'interfaccia a riga di comando, esegui:
py -m venv <your-env>
.\<your-env>\Scripts\activate
pip install google-apps-chat
Scopri di più:
Vai
Importa i pacchetti Go per i servizi Google Cloud.
import "cloud.google.com/go"
Per installare il pacchetto nel sistema:
- Passa alla directory del progetto:
cd /my/cloud/project
. - Prendi il pacchetto che vuoi utilizzare:
go get cloud.google.com/go/chat
Scopri di più:
Ruby
Per installare la libreria client:
gem install google-apps-chat
Scopri di più:
PHP
Per installare la libreria client:
- Se necessario, installa il gestore delle dipendenze Composer.
- Dall'interfaccia a riga di comando, esegui:
composer require google/apps-chat
Scopri di più:
.NET
Per installare la libreria client:
Installa il pacchetto Google.Apps.Chat.V1
da NuGet. Aggiungila a
progetto nel modo consueto (ad esempio, facendo clic con il tasto destro del mouse sul progetto
Visual Studio e scegliendo "Gestisci pacchetti NuGet..."). Assicurati di
abilitare pacchetti di pre-release (ad esempio, nel prompt dei comandi
dell'interfaccia, seleziona la casella "Includi pre-release" ).
Per installare il pacchetto NuGet, visita Google.Apis su NuGet.org.
Scopri di più:
Installa le librerie client delle API di Google
Un'alternativa alle librerie client di Cloud, Librerie client delle API di Google fornire accesso programmatico all'API Chat utilizzando risorse REST di classificazione. Potresti preferire utilizzare Librerie client delle API di Google se utilizzi un linguaggio che non ha un dalla libreria client di Cloud o se stai estendendo un progetto che le utilizza già.
L'API Chat fornisce librerie client delle API di Google per: lingue diverse. Seleziona la lingua che vuoi utilizzare:
Vai
Scarica la libreria client dell'API Google Chat per Go (alpha). Leggi la guida per gli sviluppatori della libreria client.
Java
Questa pagina contiene informazioni su come iniziare a utilizzare l'API Google Chat tramite la libreria client dell'API di Google per Java. Per ulteriori informazioni, leggi la seguenti documentazione:
Aggiungere la libreria client al tuo progetto
Seleziona il tuo ambiente di build (Maven o Gradle) dalle seguenti schede:
Aggiungi quanto segue al tuo file pom.xml
:
Vedi tutte le versioni disponibili in Maven Central Repository.
Aggiungi quanto segue al tuo file build.gradle
:
Vedi tutte le versioni disponibili in Maven Central Repository.
JavaScript
Leggi la guida per gli sviluppatori della libreria client.
.NET
Questa pagina contiene informazioni su come iniziare a utilizzare l'API Google Chat tramite la libreria client dell'API di Google per .NET. Per saperne di più, consulta la seguente documentazione:
Scaricare la libreria
Installa il pacchetto NuGet: Google.Apis.
Node.js
Scarica la più recente libreria client dell'API Google Chat per Node.js. Leggi la guida per gli sviluppatori della libreria client.
Obj-C
Scarica la più recente libreria client dell'API Google Chat per Objective-C. Leggi la guida per gli sviluppatori della libreria client.
PHP
Scarica la più recente libreria client dell'API Google Chat per PHP. Leggi la guida per gli sviluppatori della libreria client.
Python
Questa pagina contiene informazioni su come iniziare a utilizzare l'API Google Chat tramite la libreria client dell'API di Google per Python. Per ulteriori informazioni, leggi la seguenti documentazione:
Requisiti di sistema
- Sistemi operativi:
- Linux
- macOS X
- Windows
- Python 2.7, o 3.4 o versioni successive
Installare la libreria client
Puoi utilizzare un gestore di pacchetti o scaricare e installare manualmente la libreria client Python:
Installazione gestita
Utilizza pip o setuptools per gestire l'installazione (potrebbe essere necessario eseguire prima sudo
):
- pip (scelta preferenziale):
pip install --upgrade google-api-python-client
- Setuptools:
easy_install --upgrade google-api-python-client
Installazione manuale
- Scarica il client più recente per Python.
- Estrai il codice dal pacchetto.
- Installa:
python setup.py install
App Engine
Poiché le librerie client per Python non sono installate nell'ambiente runtime Python di App Engine, devi copiarle nella tua applicazione proprio come le librerie di terze parti.
Ruby
Questa pagina contiene informazioni su come iniziare a utilizzare l'API Google Chat tramite la libreria client dell'API di Google per Ruby. Per ulteriori informazioni, leggi la seguenti documentazione:
Installare il gem google-api-client
A seconda del sistema, potrebbe essere necessario anteporre sudo
a questi comandi.
Se non hai ancora installato la libreria client delle API di Google per Ruby, esegui l'installazione utilizzando RubyGems
:
gem install google-api-client
Se hai già installato il gem, esegui l'aggiornamento alla versione più recente:
gem update -y google-api-client
Iniziare a utilizzare la libreria client delle API di Google per Ruby
Per scoprire come effettuare la tua prima richiesta, consulta le Guida introduttiva.
Apps Script e librerie client
Il metodo consigliato per la maggior parte degli sviluppatori di chiamare l'API Google Chat è con il nostro supporto ufficiale Librerie client di Cloud per il tuo linguaggio preferito, come Python, Java o Node.js.
Se scrivi codice con Google Apps Script, utilizza la Servizio Chat avanzato anziché installare una libreria client.
Autenticazione
La chiamata all'API Chat richiede l'autenticazione. Ciascuna Il metodo API Chat richiede autenticazione degli utenti (per eseguire azioni o accedere per conto di un utente) o autenticazione app (per eseguire azioni o accedere ai dati come app di Chat). Alcune supportano sia l'autenticazione utente sia quella delle app.
Per scoprire di più sull'autenticazione in Chat, vedi Panoramica dell'autenticazione.