Google Apps Script 빠른 시작

빠른 시작에서는 Google Workspace API를 호출하는 앱을 설정하고 실행하는 방법을 설명합니다.

Google Workspace 빠른 시작에서는 API 클라이언트 라이브러리를 사용하여 인증 및 승인 흐름의 일부 세부정보를 처리합니다. 자체 앱에는 클라이언트 라이브러리를 사용하는 것이 좋습니다. 이 빠른 시작에서는 테스트 환경에 적합한 간소화된 인증 접근 방식을 사용합니다. 프로덕션 환경의 경우 앱에 적합한 액세스 사용자 인증 정보를 선택하기 전에 인증 및 승인에 관해 알아보는 것이 좋습니다.

Google Chat API에 요청을 보내는 Google Apps Script를 만듭니다.

목표

  • 환경을 구성합니다.
  • 스크립트를 만들고 구성합니다.
  • 스크립트를 실행합니다.

기본 요건

클라우드 프로젝트 구성

이 빠른 시작을 완료하기 위해 새 Google Cloud 프로젝트를 사용하는 경우 프로젝트를 구성하고 자신을 테스트 사용자로 추가해야 합니다. Cloud 프로젝트에 대해 이러한 단계를 이미 완료했다면 다음 섹션으로 건너뜁니다.

Google Cloud 콘솔에서 Cloud 프로젝트 열기

아직 열려 있지 않으면 이 샘플에 사용할 Cloud 프로젝트를 엽니다.

  1. Google Cloud 콘솔에서 프로젝트 선택 페이지로 이동합니다.

    Cloud 프로젝트 선택

  2. 사용할 Google Cloud 프로젝트를 선택합니다. 또는 프로젝트 만들기를 클릭하고 화면에 표시된 안내를 따릅니다. Google Cloud 프로젝트를 만드는 경우 프로젝트에 결제를 사용 설정해야 할 수 있습니다.

Chat API 사용 설정

Google API를 사용하려면 먼저 Google Cloud 프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud 프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.

  • Google Cloud 콘솔에서 Google Chat API를 사용 설정합니다.

    API 사용 설정

  1. Google Cloud 콘솔에서 메뉴 > API 및 서비스 > OAuth 동의 화면으로 이동합니다.

    OAuth 동의 화면으로 이동

  2. 사용자 유형으로 내부를 선택한 다음 만들기를 클릭합니다.
  3. 앱 등록 양식을 작성한 후 저장 및 계속을 클릭합니다.

  4. 지금은 범위 추가를 건너뛰고 저장 후 계속을 클릭할 수 있습니다. 향후 Google Workspace 조직 외부에서 사용할 앱을 만드는 경우 사용자 유형을 외부로 변경한 다음 앱에 필요한 승인 범위를 추가해야 합니다.

  5. 앱 등록 요약을 검토합니다. 변경하려면 수정을 클릭합니다. 앱 등록이 올바른 것으로 보이면 대시보드로 돌아가기를 클릭합니다.

Google Chat 앱 구성

Google Chat API를 호출하려면 Google Chat 앱을 구성해야 합니다. 쓰기 요청의 경우 Google Chat은 다음 정보를 사용하여 UI의 Google Chat 앱에 속성을 지정합니다.

  1. Google Cloud 콘솔에서 Chat API 구성 페이지로 이동합니다.

    Chat API 구성 페이지로 이동

  2. 애플리케이션 정보에서 다음 정보를 입력합니다.

    1. 앱 이름 필드에 Chat API quickstart app을 입력합니다.
    2. 아바타 URL 필드에 https://developers.google.com/chat/images/quickstart-app-avatar.png를 입력합니다.
    3. 설명 필드에 Quickstart for calling the Chat API을 입력합니다.

  3. 양방향 기능에서 양방향 기능 사용 설정 전환 버튼을 사용 중지 위치로 클릭하여 채팅 앱의 양방향 기능을 사용 중지합니다.

  4. 저장을 클릭합니다.

스크립트 만들기

  1. script.google.com/create로 이동하여 새 스크립트를 만듭니다.
  2. 스크립트 편집기의 내용을 다음 코드로 바꿉니다.

chat/quickstart/Code.gs
/**
 * This quickstart sample shows how to list spaces with user credential
 *
 * It relies on the OAuth2 scope 'https://www.googleapis.com/auth/chat.spaces.readonly'
 * referenced in the manifest file (appsscript.json).
 */
function listSpaces() {
  // Initialize request argument(s)
  // Filter spaces by space type (SPACE or GROUP_CHAT or DIRECT_MESSAGE)
  const filter = 'space_type = "SPACE"';

  // Iterate through the response pages using page tokens
  let responsePage;
  let pageToken = null;
  do {
    // Request response pages
    responsePage = Chat.Spaces.list({
      filter: filter,
      pageToken: pageToken
    });
    // Handle response pages
    if (responsePage.spaces) {
      responsePage.spaces.forEach((space) => console.log(space));
    }
    // Update the page token to the next one
    pageToken = responsePage.nextPageToken;
  } while (pageToken);
}

  1. 저장 를 클릭합니다.
  2. 제목 없는 프로젝트를 클릭하고 빠른 시작을 입력한 다음 이름 바꾸기를 클릭합니다.

스크립트 구성

Cloud 프로젝트 번호 복사

  1. Google Cloud 콘솔에서 메뉴 > IAM 및 관리자 > 설정으로 이동합니다.

    IAM & 관리자 설정으로 이동

  2. 프로젝트 번호 필드에 값을 복사합니다.
  1. Apps Script 프로젝트를 엽니다.
  2. 프로젝트 설정 를 클릭합니다.
  3. Google Cloud Platform(GCP) 프로젝트에서 프로젝트 변경을 클릭합니다.
  4. GCP 프로젝트 번호에 Google Cloud 프로젝트 번호를 붙여넣습니다.
  5. 프로젝트 설정을 클릭합니다.

Google Chat API 사용 설정

  1. Apps Script 프로젝트를 엽니다.
  1. 프로젝트 설정 를 클릭합니다.
  2. 일반 설정에서 편집기에 'appsscript.json' 매니페스트 파일 표시를 사용 설정합니다.
  3. 편집기 를 클릭하고 appscript.json 파일을 선택한 다음 콘텐츠를 다음 코드로 바꿉니다.

chat/quickstart/appsscript.json
{
  "timeZone": "America/New_York",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.spaces.readonly"
  ],
  "chat": {},
  "dependencies": {
    "enabledAdvancedServices": [{
      "userSymbol": "Chat",
      "version": "v1",
      "serviceId": "chat"
    }]
  }
}

샘플 실행

Apps Script 편집기에서 실행을 클릭합니다.

샘플을 처음 실행하면 액세스를 승인하라는 메시지가 표시됩니다.

  1. 권한 검토를 클릭합니다.
  2. 계정을 선택합니다.
  3. 허용을 클릭합니다.

스크립트의 실행 로그가 창 하단에 표시됩니다.

다음 단계