Uwierzytelnianie i autoryzacja jako użytkownik Google Chat

Java

• Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
• Utwórz projekt Google Cloud.
• Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
• JDK w wersji 1.7 lub nowszej
• Narzędzie do zarządzania pakietami Maven
• Zainicjowany projekt Maven. Aby zainicjować nowy projekt, uruchom to polecenie w interfejsie wiersza poleceń:

  mvn archetype:generate -DgroupId=com.google.chat.app.authsample -DartifactId=auth-sample-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

Python

• Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
• Utwórz projekt Google Cloud.
• Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
• Python 3.6 lub nowszy
• Narzędzie do zarządzania pakietami pip

Node.js

• Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
• Utwórz projekt Google Cloud.
• Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
• Node.js w wersji 14 lub nowszej
• Narzędzie do zarządzania pakietami npm
• Zainicjowany projekt Node.js. Aby zainicjować nowy projekt, utwórz nowy folder i przejdź do niego, a potem uruchom to polecenie w interfejsie wiersza poleceń:

  npm init

Google Apps Script

• Konto Google Workspace w wersji Business lub Enterprise z dostępem do Google Chat.
• Utwórz projekt Google Cloud.
• Włącz i skonfiguruj interfejs Google Chat API, podając nazwę, ikonę i opis aplikacji do obsługi czatu.
• Utwórz samodzielny projekt Apps Script i włącz zaawansowaną usługę czatu.

Java

Aby dodać biblioteki klienta Google i inne wymagane zależności do projektu Maven, zmień plik pom.xml w katalogu projektu i dodaj te zależności:

<dependencies>   <!-- ... existing dependencies ... -->   <dependency>     <groupId>com.google.apis</groupId>     <artifactId>google-api-services-chat</artifactId>     <version>v1-rev20230905-2.0.0</version>   </dependency>   <dependency>     <groupId>com.google.auth</groupId>     <artifactId>google-auth-library-oauth2-http</artifactId>     <version>1.19.0</version>   </dependency>   <dependency>     <groupId>com.google.oauth-client</groupId>     <artifactId>google-oauth-client-jetty</artifactId>     <version>1.34.1</version>   </dependency>   <dependency>       <groupId>com.google.code.gson</groupId>       <artifactId>gson</artifactId>       <version>2.10.1</version>   </dependency> </dependencies> 

Python

Jeśli nie masz jeszcze zainstalowanych bibliotek klienta Google dla Pythona, uruchom w interfejsie wiersza poleceń to polecenie:

pip3 install --upgrade google-api-python-client google-auth-oauthlib

Node.js

Aby dodać biblioteki klienta Google i inne wymagane zależności do projektu Node.js, przejdź do katalogu projektu i uruchom w interfejsie wiersza poleceń to polecenie:

npm install "@googleapis/chat" open server-destroy

Google Apps Script

W tym przykładzie do wywoływania interfejsu Google Chat API używana jest zaawansowana usługa Chat. Aby włączyć usługę w projekcie Apps Script:

1. Po lewej stronie kliknij Edytor code.
2. Po lewej stronie obok pozycji Usługi kliknij Dodaj usługę add.
3. Wybierz Google Chat API.
4. W polu Wersja wybierz v1.
5. Kliknij Dodaj.

Java

1. W katalogu projektu otwórz plik src/main/java/com/google/chat/app/authsample/App.java.

2. Zastąp zawartość pliku App.java tym kodem:

   package com.google.chat.app.authsample;  import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp; import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver; import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow; import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets; import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport; import com.google.api.client.http.HttpTransport; import com.google.api.client.json.JsonFactory; import com.google.api.client.json.gson.GsonFactory; import com.google.api.client.util.store.FileDataStoreFactory; import com.google.api.services.chat.v1.HangoutsChat; import com.google.api.services.chat.v1.model.Space;  import java.io.InputStreamReader; import java.util.Collection; import java.util.Collections;  /**  * Authenticates with Chat API via user credentials, then creates a Chat space.  */ public class App {     // Application OAuth credentials.     private static final String KEYS_RESOURCE_URI = "/credentials.json";      // Define your app's authorization scopes.     private static final Collection<String> SCOPES =         Collections.singleton("https://www.googleapis.com/auth/chat.spaces.create");      // Directory to store user credentials.     private static final java.io.File DATA_STORE_DIR =         new java.io.File(System.getProperty("user.home"), ".store/auth-sample-app");      // Global instance of the JSON factory.     private static final JsonFactory JSON_FACTORY = GsonFactory.getDefaultInstance();      // Global instance of the HTTP transport.     private static HttpTransport httpTransport;      // Global instance of the DataStoreFactory. The best practice is to make it a single     // globally shared instance across your application.     private static FileDataStoreFactory dataStoreFactory;      public static void main( String[] args ) {         try {             // Run app.             httpTransport = GoogleNetHttpTransport.newTrustedTransport();             dataStoreFactory = new FileDataStoreFactory(DATA_STORE_DIR);             Credential userCredential = authorize();             Space response = App.createChatSpace(userCredential);             // Print details about the created space.             System.out.println(response);         } catch (Exception e) {             e.printStackTrace();         }     }      /**      * Authorizes the installed application to access user's protected data.      */     private static Credential authorize() throws Exception {         // Load client secrets.         GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(JSON_FACTORY,             new InputStreamReader(App.class.getResourceAsStream("/credentials.json")));         // Set up authorization code flow.         GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(             httpTransport, JSON_FACTORY, clientSecrets, SCOPES)             .setDataStoreFactory(dataStoreFactory)             .build();         // Authorize.         return new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");     }      /**      * Creates a Chat space.      */     private static Space createChatSpace(Credential userCredential) throws Exception {         // Build the Chat API client and authenticate with the user account.         HangoutsChat chatService = new HangoutsChat.Builder(             httpTransport, JSON_FACTORY, userCredential)             .setApplicationName("auth-sample-app")             .build();          // Create a Chat space.         Space space = new Space()             // To create a named space, set spaceType to SPACE.             .setSpaceType("SPACE")             // The user-visible name of the space.             .setDisplayName("API-made");         return chatService.spaces().create(space).execute();     } } 

3. Utwórz nowy podkatalog o nazwie resources w katalogu projektu.

4. Skopiuj plik credentials.json do podkatalogu resources.

5. Aby skonfigurować Maven tak, aby uwzględniał plik z tajnymi danymi klienta w pakiecie projektu, otwórz do edycji plik pom.xml w katalogu projektu i dodaj do sekcji <build> tę konfigurację:

   <build>   <!-- ... existing configurations ... -->   <resources>     <resource>       <directory>resources</directory>     </resource>   </resources> </build> 

6. Aby skonfigurować Maven tak, aby uwzględniał zależności w pakiecie projektu i wykonywał główną klasę aplikacji, edytuj plik pom.xml w katalogu projektu i dodaj tę konfigurację do sekcji <plugins>:

   <plugins>   <!-- ... existing configurations ... -->   <plugin>     <artifactId>maven-assembly-plugin</artifactId>     <configuration>       <archive>         <manifest>           <mainClass>com.google.chat.app.authsample.App</mainClass>         </manifest>       </archive>       <descriptorRefs>         <descriptorRef>jar-with-dependencies</descriptorRef>       </descriptorRefs>     </configuration>   </plugin> </plugins> 

Python

1. Zapisz ten kod w pliku o nazwie chat_space_create_named.py w tym samym katalogu, w którym znajduje się plik credentials.json:

   from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient.discovery import build  # Define your app's authorization scopes. # When modifying these scopes, delete the file token.json, if it exists. SCOPES = ["https://www.googleapis.com/auth/chat.spaces.create"]  def main():   '''   Authenticates with Chat API via user credentials,   then creates a Chat space.   '''    flow = InstalledAppFlow.from_client_secrets_file(                     'credentials.json', SCOPES)   creds = flow.run_local_server()    # Build a service endpoint for Chat API.   service = build('chat', 'v1', credentials=creds)    # Use the service endpoint to call Chat API.   result = service.spaces().create(      # Details about the space to create.     body = {        # To create a named space, set spaceType to SPACE.       'spaceType': 'SPACE',        # The user-visible name of the space.       'displayName': 'API-made'      }    ).execute()    # Prints details about the created space.   print(result)  if __name__ == '__main__':   main() 

Node.js

1. Zapisz ten kod w pliku o nazwie chat_space_create_named.js w tym samym katalogu, w którym znajdują się projekt Node.js i plik credentials.json:

   const fs = require('fs'); const path = require('path'); const http = require('http'); const url = require('url'); const destroyer = require('server-destroy');  const chat = require('@googleapis/chat');  // Application OAuth credentials. const keys = require('./credentials.json').installed;  // Define your app's authorization scopes. // When modifying these scopes, delete the file token.json, if it exists. const scopes = ["https://www.googleapis.com/auth/chat.spaces.create"];  // Create a new OAuth2 client with the configured keys. const oauth2Client = new chat.auth.OAuth2(   keys.client_id,   keys.client_secret,   'http://localhost:3000' );  /**  * Opens an HTTP server to accept the OAuth callback.  * In this simple example, the only request to our webserver is to /?code=<code>.  */ async function authenticate(scopes) {   const opn = (await import('open')).default;    return new Promise((resolve, reject) => {     // Generate the URL for authorization.     const authorizeUrl = oauth2Client.generateAuthUrl({       access_type: 'offline',       scope: scopes.join(' '),     });     // Start the HTTP server to listen for the callback.     const server = http       .createServer(async (req, res) => {         try {           const qs = new url.URL(req.url, 'http://localhost:3000').searchParams;           res.end('Authentication successful! Please return to the console.');           server.destroy();           const { tokens } = await oauth2Client.getToken(qs.get('code'));           oauth2Client.credentials = tokens;           resolve(oauth2Client);         } catch (e) {           reject(e);         }       })       .listen(3000, () => {         // Open the browser to the authorize URL to start the workflow.         opn(authorizeUrl, { wait: false }).then(cp => cp.unref());       });     destroyer(server);   }); }  /**  * Authenticates with Chat API via user credentials, then creates a Chat space.  */ async function createSpace() {   // Create the Chat API client and authenticate with the authorized user.   const chatClient = await chat.chat({     version: 'v1',     auth: oauth2Client   });    // Call the Chat API to create a space.   const result = await chatClient.spaces.create({      // Details about the space to create.     requestBody: {        // To create a named space, set spaceType to SPACE.       'spaceType': 'SPACE',        // The user-visible name of the space.       'displayName': 'API-made'      }    });   return result; }  // Authenticate the user, execute the function, // then print details about the created space. authenticate(scopes)   .then(createSpace)   .then(console.log); 

Google Apps Script

1. W edytorze Apps Script zmień plik appsscript.json i dodaj zakres OAuth niezbędny do wywołania interfejsu API:

     "oauthScopes": [     "https://www.googleapis.com/auth/chat.spaces.create"   ] 

2. Zapisz ten kod w pliku o nazwie ChatSpaceCreateNamed.gs w projekcie Apps Script:

   /**  * Authenticates with Chat API via user credentials, then creates a  * Chat space.  */ function createSpace() {   try {     // Details about the space to create.     // To create a named space, set spaceType to SPACE.     // The user-visible name of the space is displayName.     const space = {'displayName': 'API-made', 'spaceType': 'SPACE'};      // Call Chat API with user credentials to create the space.     const result = Chat.Spaces.create(space);      // Log details about the created space.     console.log(result);   } catch (err) {     // TODO (developer) - Handle exception     console.log('Failed to create space with error %s', err.message);   } } 

Java

mvn compile assembly:single java -jar target/auth-sample-app-1.0-SNAPSHOT-jar-with-dependencies.jar

Python

python3 chat_space_create_named.py

Node.js

node chat_space_create_named.js

Google Apps Script

Otwórz plik ChatSpaceCreateNamed.gs w edytorze Apps Script i kliknij Uruchom.