Librerie client dell'API Google Chat

Le librerie client ottimizzano l'esperienza dello sviluppatore per chiamare l'API Google Chat riducendo il codice boilerplate da scrivere. Questa guida illustra le librerie client e spiega come installarle.

L'API Chat ha interfacce gRPC e REST, nonché librerie client che supportano entrambe. Le librerie client di Cloud supportano le interfacce gRPC e REST, mentre le librerie client delle API di Google supportano solo l'interfaccia REST, ma puoi utilizzare entrambe le librerie client nello stesso progetto. Se le librerie client fornite non soddisfano le tue esigenze, puoi scrivere le tue librerie client che utilizzano l'interfaccia gRPC o REST.

Per scoprire di più sui tipi di librerie client supportate da Google, consulta la sezione Descrizione delle librerie client.

Installa le librerie client Cloud (opzione consigliata)

Le librerie client di Cloud sono le librerie client più recenti e consigliate per chiamare l'API Chat. Le librerie client di Cloud supportano sia le interfacce gRPC sia quelle REST.

L'API Chat fornisce librerie client Cloud per i seguenti linguaggi. Seleziona la lingua che vuoi utilizzare:

Node.js

Per installare la libreria client:

npm install @google-apps/chat

Scopri di più:

Python

Per installare la libreria client:

python -m venv <your-env>
source <your-env>/bin/activate
pip install google-apps-chat

Scopri di più:

Java

Seleziona il tuo ambiente di build dalle seguenti schede. Qualsiasi sia la tua scelta, ricordati di aggiornare la versione alla release più recente disponibile su GitHub.

Maven con BOM

Se utilizzi Maven con BOM, aggiungi quanto segue al 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 quanto segue alle 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 quanto segue alle 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ù:

Vai

Importa i pacchetti Go per i servizi Google Cloud.

import "cloud.google.com/go"

Per installare il pacchetto sul sistema:

  1. Vai alla directory del progetto: cd /my/cloud/project.
  2. Scarica 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:

  1. Se necessario, installa il gestore delle dipendenze Composer.
  2. 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. Aggiungilo al progetto nel modo normale (ad esempio facendo clic con il tasto destro del mouse sul progetto in Visual Studio e scegliendo "Gestisci pacchetti NuGet"). Assicurati di attivare i pacchetti pre-release (ad esempio, nell'interfaccia utente di Visual Studio NuGet, seleziona la casella "Includi pre-release").

Per installare il pacchetto NuGet, visita la pagina Google.Apis su NuGet.org.

Scopri di più:

Installare le librerie client delle API di Google

Un'alternativa alle librerie client Cloud, le librerie client delle API di Google forniscono accesso programmatico all'API Chat utilizzando metodi e risorse REST. Ti consigliamo di utilizzare le librerie client delle API di Google se utilizzi un linguaggio che non dispone di una libreria client Cloud o se stai estendendo un progetto che le utilizza già.

L'API Chat fornisce librerie client dell'API di Google per le seguenti lingue. Seleziona la lingua che vuoi utilizzare:

Vai

Scarica la più recente 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 mediante la libreria client delle 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:

JavaScript

Leggi la guida per gli sviluppatori della libreria client.

.NET

Questa pagina contiene informazioni su come iniziare a utilizzare l'API Google Chat mediante la libreria client delle API di Google per .NET. Per scoprire 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 mediante la libreria client delle API di Google per Python. Per ulteriori informazioni, leggi la seguenti documentazione:

Requisiti di sistema

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 (preferito): 
    pip install --upgrade google-api-python-client
  • Setuptools: 
    easy_install --upgrade google-api-python-client

Installazione manuale

  1. Scarica il client più recente per Python.
  2. Estrai il codice dal pacchetto.
  3. 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 mediante la libreria client delle 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 la Guida introduttiva.

Apps Script e librerie client

Il modo consigliato per la maggior parte degli sviluppatori per chiamare l'API Google Chat è tramite le nostre librerie client Cloud supportate ufficialmente per il linguaggio che preferisci, ad esempio Python, Java o Node.js.

Se scrivi codice con Google Apps Script, utilizza il servizio Chat avanzato instead of installing a client library.

Autenticazione

La chiamata all'API Chat richiede l'autenticazione. Ogni metodo dell'API Chat richiede autenticazione utente (per eseguire azioni o accedere ai dati per conto di un utente) o autenticazione dell'app (per eseguire azioni o accedere ai dati come app di Chat). Alcuni metodi supportano sia l'autenticazione utente sia l'autenticazione dell'app.

Per scoprire di più sull'autenticazione in Chat, consulta la Panoramica dell'autenticazione.