Аутентификация в приложении Google Chat

Ява

• JDK 1.7 или выше
• Инструмент управления пакетами Maven
• Инициализированный проект Maven. Чтобы инициализировать новый проект, выполните следующую команду в командной строке:

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

• Приложение Google Chat, которое получает и реагирует на события взаимодействия . Чтобы создать интерактивное приложение Chat с использованием HTTP-сервиса, выполните это краткое руководство .
• Добавьте приложение Chat в чат-группу. Чтобы добавить приложение Chat, см. статью Тестирование интерактивных функций для приложений Google Chat .

Питон

• Python 3.6 или выше
• Инструмент управления пакетами pip
• Приложение Google Chat, которое получает и реагирует на события взаимодействия . Чтобы создать интерактивное приложение Chat с использованием HTTP-сервиса, выполните это краткое руководство .
• Добавьте приложение Chat в чат-группу. Чтобы добавить приложение Chat, см. статью Тестирование интерактивных функций для приложений Google Chat .

Node.js

• Node.js 14 или выше
• Инструмент управления пакетами npm
• Инициализированный проект Node.js. Чтобы инициализировать новый проект, создайте и перейдите в новую папку, а затем выполните следующую команду в интерфейсе командной строки:

  npm init

• Приложение Google Chat, которое получает и реагирует на события взаимодействия . Чтобы создать интерактивное приложение Chat с использованием HTTP-сервиса, выполните это краткое руководство .
• Добавьте приложение Chat в чат-группу. Чтобы добавить приложение Chat, см. статью Тестирование интерактивных функций для приложений Google Chat .

Скрипт приложений

• Приложение Google Chat, которое получает и реагирует на события взаимодействия . Чтобы создать интерактивное приложение Chat в Apps Script, выполните это краткое руководство .
• Добавьте приложение Chat в чат-группу. Чтобы добавить приложение Chat, см. статью Тестирование интерактивных функций для приложений Google Chat .

Ява

Чтобы добавить клиентские библиотеки Google и другие необходимые зависимости в ваш проект Maven, отредактируйте файл pom.xml в каталоге вашего проекта и добавьте следующие зависимости:

<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.code.gson</groupId>       <artifactId>gson</artifactId>       <version>2.10.1</version>   </dependency> </dependencies> 

Питон

Если вы еще не установили клиентские библиотеки Google для Python, выполните следующую команду в интерфейсе командной строки:

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

Node.js

Чтобы добавить клиентские библиотеки Google в ваш проект Node.js, перейдите в каталог вашего проекта и выполните следующую команду в интерфейсе командной строки:

npm install "@googleapis/chat"

Скрипт приложений

В этом примере используется библиотека OAuth2 for Apps Script для генерации JWT-токена для аутентификации учётной записи сервиса. Чтобы добавить библиотеку в проект Apps Script:

1. Слева нажмите Редактор code .
2. Слева, рядом с пунктом Библиотеки , нажмите add библиотеку .
3. Введите идентификатор скрипта 1B7FSrk5Zi6L1rSxxTDgDEUsPzlukDsi4KGuTMorsTQHhGBzBkMun4iDF .
4. Нажмите «Поиск» , затем нажмите « Добавить» .

В этом примере используется служба Advanced Chat для вызова API Google Chat. Чтобы включить службу для вашего проекта Apps Script:

1. Слева нажмите Редактор code .
2. Слева, рядом с пунктом Услуги , нажмите add услугу .
3. Выберите API чата Google .
4. В поле Версия выберите v1 .
5. Нажмите «Добавить» .

Ява

1. В каталоге вашего проекта откройте файл src/main/java/com/google/chat/app/authsample/App.java .

2. Замените содержимое App.java следующим кодом:

   package com.google.chat.app.authsample;  import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport; import com.google.api.client.http.HttpRequestInitializer; import com.google.api.client.json.gson.GsonFactory; import com.google.api.services.chat.v1.HangoutsChat; import com.google.api.services.chat.v1.model.Message; import com.google.auth.http.HttpCredentialsAdapter; import com.google.auth.oauth2.GoogleCredentials;  /**  * Authenticates with Chat API using service account credentials,  * then creates a Chat message.  */ public class App {     // Specify required scopes.     private static final String CHAT_SCOPE = "https://www.googleapis.com/auth/chat.bot";      // Specify service account details.     private static final String PRIVATE_KEY_RESOURCE_URI = "/credentials.json";      public static void main( String[] args ) {         try {             // Run app.             Message response = App.createChatMessage();             // Print details about the created message.             System.out.println(response);         } catch (Exception e) {             e.printStackTrace();         }     }      private static Message createChatMessage() throws Exception {         // Build the Chat API client and authenticate with the service account.         GoogleCredentials credentials = GoogleCredentials.fromStream(             App.class.getResourceAsStream(PRIVATE_KEY_RESOURCE_URI))             .createScoped(CHAT_SCOPE);         HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(credentials);         HangoutsChat chatService = new HangoutsChat.Builder(             GoogleNetHttpTransport.newTrustedTransport(),             GsonFactory.getDefaultInstance(),             requestInitializer)             .setApplicationName("auth-sample-app")             .build();          // The space to create the message in.         //         // Replace SPACE_NAME with a space name.         // Obtain the space name from the spaces resource of Chat API,         // or from a space's URL.         String spaceName = "spaces/SPACE_NAME";          // Create a Chat message.         Message message = new Message().setText("Hello, world!");         return chatService.spaces().messages().create(spaceName, message).execute();     } } 

3. В коде замените SPACE_NAME на имя пространства, которое можно получить из метода spaces.list в Chat API или из URL-адреса пространства.

4. Создайте новый подкаталог с именем resources в каталоге вашего проекта.

5. Убедитесь, что файл закрытого ключа для вашей учетной записи службы называется credentials.json , и скопируйте его в подкаталог resources .

6. Чтобы настроить Maven для включения файла закрытого ключа в пакет проекта, отредактируйте файл pom.xml в каталоге вашего проекта и добавьте следующую конфигурацию в раздел <build> :

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

7. Чтобы настроить Maven для включения зависимостей в пакет проекта и выполнения основного класса вашего приложения, отредактируйте файл pom.xml в каталоге вашего проекта и добавьте следующую конфигурацию в раздел <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> 

Питон

1. В рабочем каталоге создайте файл с именем chat_app_auth.py .

2. Включите следующий код в chat_app_auth.py :

   from apiclient.discovery import build from google.oauth2 import service_account  # Specify required scopes. SCOPES = ['https://www.googleapis.com/auth/chat.bot']  # Specify service account details. creds = service_account.Credentials.from_service_account_file(     'credentials.json', scopes=SCOPES)  # Build the URI and authenticate with the service account. chat = build('chat', 'v1', credentials=creds)  # Create a Chat message. result = chat.spaces().messages().create(      # The space to create the message in.     #     # Replace SPACE_NAME with a space name.     # Obtain the space name from the spaces resource of Chat API,     # or from a space's URL.     parent='spaces/SPACE_NAME',      # The message to create.     body={'text': 'Hello, world!'}  ).execute()  # Prints details about the created message. print(result) 

3. В коде замените SPACE_NAME на имя пространства, которое можно получить из метода spaces.list в Chat API или из URL пространства. Убедитесь, что файл закрытого ключа для вашей учётной записи сервиса называется credentials.json .

Node.js

1. В каталоге вашего проекта создайте файл с именем chat_app_auth.js .

2. Включите следующий код в chat_app_auth.js :

   const chat = require('@googleapis/chat');  async function createMessage() {   const auth = new chat.auth.GoogleAuth({      // Specify service account details.     keyFilename: 'credentials.json',      // Specify required scopes.     scopes: ['https://www.googleapis.com/auth/chat.bot']    });   const authClient = await auth.getClient();    // Create the Chat API client and authenticate with the service account.   const chatClient = await chat.chat({     version: 'v1',     auth: authClient   });    // Create a Chat message.   const result = await chatClient.spaces.messages.create({      // The space to create the message in.     //     // Replace SPACE_NAME with a space name.     // Obtain the space name from the spaces resource of Chat API,     // or from a space's URL.     parent: 'spaces/SPACE_NAME',      // The message to create.     requestBody: { 'text': 'Hello, world!' }    });   return result; }  // Execute function then print details about the created message. createMessage().then(console.log); 

3. В коде замените SPACE_NAME на имя пространства, которое можно получить из метода spaces.list в Chat API или из URL пространства. Убедитесь, что файл закрытого ключа для вашей учётной записи сервиса называется credentials.json .

Скрипт приложений

1. В редакторе Apps Script отредактируйте файл appsscript.json и добавьте область OAuth, необходимую для выполнения внешних запросов на получение токена OAuth учетной записи службы:

     "oauthScopes": [     "https://www.googleapis.com/auth/script.external_request"   ] 

2. Сохраните следующий код в файле с именем ChatAppAuth.gs в вашем проекте Apps Script:

   // Specify the contents of the file credentials.json. const CREDENTIALS = CREDENTIALS;  const SCOPE = 'https://www.googleapis.com/auth/chat.bot';  // The space to create the message in. // // Replace SPACE_NAME with a space name. // Obtain the space name from the spaces resource of Chat API, // or from a space's URL. const PARENT = 'spaces/SPACE_NAME'  /**  * Authenticates with Chat API using app credentials, then posts a message.  */ function createMessageWithAppCredentials() {   try {     const service = getService_();     if (!service.hasAccess()) {       console.error(service.getLastError());       return;     }      // Specify the message to create.     const message = {'text': 'Hello world!'};      // Call Chat API with a service account to create a message.     const result = Chat.Spaces.Messages.create(         message,         PARENT,         {},         // Authenticate with the service account token.         {'Authorization': 'Bearer ' + service.getAccessToken()});      // Log details about the created message.     console.log(result);    } catch (err) {     // TODO (developer) - Handle exception.     console.log('Failed to create message with error %s', err.message);   } }  /**  * Configures the OAuth library to authenticate with the service account.  */ function getService_() {   return OAuth2.createService(CREDENTIALS.client_email)       .setTokenUrl('https://oauth2.googleapis.com/token')       .setPrivateKey(CREDENTIALS.private_key)       .setIssuer(CREDENTIALS.client_email)       .setSubject(CREDENTIALS.client_email)       .setScope(SCOPE)       .setPropertyStore(PropertiesService.getScriptProperties()); } 

3. В коде замените CREDENTIALS содержимым файла credentials.json .

4. В коде замените SPACE_NAME на имя пространства, которое можно получить из метода spaces.list в Chat API или из URL-адреса пространства.

Ява

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

Питон

python3 chat_app_auth.py

Node.js

node chat_app_auth.js

Скрипт приложений

Откройте файл ChatAppAuth.gs в редакторе скриптов приложений и нажмите «Выполнить» .