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 앱 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
• 스페이스에 채팅 앱을 추가합니다. 이 채팅 앱(참조) Google Chat 앱의 양방향 기능 테스트하기

Python

• Python 3.6 이상
• pip 패키지 관리 도구
• 양방향 기능이 사용 설정된 Google Chat 앱 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
• 스페이스에 채팅 앱을 추가합니다. 이 채팅 앱(참조) Google Chat 앱의 양방향 기능 테스트하기

Node.js

• Node.js 14 이상
• npm 패키지 관리 도구
• 초기화된 Node.js 프로젝트 새 프로젝트를 초기화하려면 새 폴더로 전환한 후 명령줄 인터페이스에서 다음 명령어를 실행합니다.

  npm init
  

• 양방향 기능이 사용 설정된 Google Chat 앱 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
• 스페이스에 채팅 앱을 추가합니다. 이 채팅 앱(참조) Google Chat 앱의 양방향 기능 테스트하기

Apps Script

• 양방향 기능이 사용 설정된 Google Chat 앱 Apps Script에서 대화형 채팅 앱을 사용하려면 이 빠른 시작을 완료하세요.
• 스페이스에 채팅 앱을 추가합니다. 이 채팅 앱(참조) 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>

Python

Python용 Google 클라이언트 라이브러리를 아직 설치하지 않았다면 다음을 실행합니다. 명령줄 인터페이스에서 다음 명령어를 실행합니다.

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

Node.js

Google 클라이언트 라이브러리를 Node.js 프로젝트에 추가하려면 프로젝트 디렉터리를 만들고 명령줄 인터페이스에서 다음 명령어를 실행합니다.

npm install "@googleapis/chat"

Apps Script

이 샘플은 Apps Script 라이브러리용 OAuth2 을 사용하여 서비스 계정 인증을 위한 JWT 토큰을 생성합니다. 라이브러리 추가하기 다음 단계를 따르세요.

1. 왼쪽에서 편집기 code를 클릭합니다.
2. 왼쪽의 라이브러리 옆에 있는 라이브러리 추가를 클릭합니다. add입니다.
3. 스크립트 ID 1B7FSrk5Zi6L1rSxxTDgDEUsPzlukDsi4KGuTMorsTQHhGBzBkMun4iDF을(를) 입력합니다.
4. Look up을 클릭한 다음 Add(추가)를 클릭합니다.

이 샘플은 고급 Chat 서비스 Google Chat API를 호출할 수 있습니다 다음에 대해 서비스를 사용 설정하려면 다음 단계를 따르세요. Apps Script 프로젝트:

1. 왼쪽에서 편집기 code를 클릭합니다.
2. 왼쪽의 서비스 옆에 있는 서비스 추가를 클릭합니다. add입니다.
3. Google Chat API를 선택합니다.
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 via 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에서 가져올 수 있음) 메서드를 사용하거나 스페이스의 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>
   

Python

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.
   CREDENTIALS = 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=CREDENTIALS)
   
   # 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에서 가져올 수 있음) 메서드를 사용하거나 스페이스의 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에서 가져올 수 있음) 메서드를 사용하거나 스페이스의 URL에서 가져올 수 있습니다. 그런 다음 서비스 계정의 비공개 키 파일 이름은 credentials.json입니다.

Apps Script

1. Apps Script 편집기에서 appsscript.json 파일을 수정합니다. 그리고 인증 정보를 얻기 위해 외부 요청을 하는 데 필요한 OAuth 범위를 서비스 계정 OAuth 토큰:

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

2. 다음 코드를 ChatAppAuth.gs이라는 파일에 저장합니다. 다음 안내를 따르세요.

   // 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 via 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에서 가져올 수 있음) 메서드를 사용하거나 스페이스의 URL에서 가져올 수 있습니다.

자바

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

Python

python3 chat_app_auth.py

Node.js

node chat_app_auth.js

Apps Script

Apps Script 편집기에서 ChatAppAuth.gs 파일을 열고 실행을 클릭합니다.