Krótkie wprowadzenie do Google Apps Script

Krótkie wprowadzenie wyjaśnia, jak skonfigurować i uruchomić aplikację, która wywołuje Interfejs Google Workspace API.

Szybkie porady dotyczące Google Workspace korzystają z bibliotek klienta interfejsu API do obsługi niektórych szczegółów procesu uwierzytelniania i autoryzacji. Zalecamy używasz bibliotek klienta we własnych aplikacjach. W tym krótkim wprowadzeniu użyjemy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z informacjami na temat uwierzytelniania i autoryzacji, zanim wybierzesz odpowiednie dla swojej aplikacji poświadczenia dostępu.

Utwórz skrypt Google Apps Script, który wysyła żądania do interfejsu Google Chat API.

Cele

  • Skonfiguruj środowisko.
  • Utwórz i skonfiguruj skrypt.
  • Uruchom skrypt.

Wymagania wstępne

Konfigurowanie projektu Cloud

Jeśli korzystasz z nowego projektu Google Cloud, aby ukończyć to krótkie wprowadzenie, musisz wykonać te czynności: skonfiguruj go i dodaj siebie jako użytkownika testowego. Jeśli te czynności zostały już przez Ciebie wykonane w przypadku Twojego projektu Cloud, przejdź do następnej sekcji.

Otwieranie projektu Cloud w konsoli Google Cloud

Jeśli nie jest jeszcze otwarty, otwórz projekt Cloud, którego chcesz użyć w przykładzie:

  1. W konsoli Google Cloud otwórz stronę Wybierz projekt.

    Wybierz projekt Cloud

  2. Wybierz projekt Google Cloud, którego chcesz użyć. Możesz też kliknąć Utwórz projekt i postępować zgodnie z instrukcjami wyświetlanymi na ekranie. Jeśli tworzysz projekt Google Cloud, konieczne może być włączenie płatności.

Włączanie interfejsu Chat API

Zanim zaczniesz używać interfejsów API Google, musisz je włączyć w projekcie Google Cloud. W jednym projekcie Google Cloud możesz włączyć 1 lub więcej interfejsów API.
  1. W konsoli Google Cloud otwórz menu . > Interfejsy API i Usługi > Ekran zgody OAuth.

    Otwórz ekran zgody OAuth

  2. Jako Typ użytkownika wybierz Wewnętrzny i kliknij Utwórz.
  3. Wypełnij formularz rejestracji aplikacji, a potem kliknij Zapisz i kontynuuj.

  4. Na razie możesz pominąć dodawanie zakresów i kliknąć Zapisz i kontynuuj. Gdy w przyszłości będziesz tworzyć aplikację do użytku poza organizacją Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie dodać zakresy autoryzacji wymagane przez aplikację.

  5. Sprawdź podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli rejestracja aplikacji wygląda dobrze, kliknij Powrót do panelu.

Konfigurowanie aplikacji Google Chat

Aby wywołać interfejs Google Chat API, musisz skonfigurować aplikację Google Chat. W przypadku żądań zapisu Google Chat przypisuje aplikację Google Chat w interfejsie użytkownika za pomocą tych informacji:

  1. W konsoli Google Cloud otwórz stronę Konfiguracja interfejsu API Chat:

    Otwórz stronę konfiguracji interfejsu Chat API

  2. W sekcji Informacje o aplikacji podaj te dane:

    1. W polu Nazwa aplikacji wpisz Chat API quickstart app.
    2. W polu URL awatara wpisz https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. W polu Opis wpisz Quickstart for calling the Chat API.

  3. W sekcji Funkcje interaktywne kliknij przełącznik Włącz funkcje interaktywne, aby wyłączyć funkcje interaktywne w aplikacji Google Chat.

  4. Kliknij Zapisz.

Tworzenie skryptu

  1. Utwórz nowy skrypt na stronie script.google.com/create.
  2. Zastąp zawartość edytora skryptów tym kodem:

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. Kliknij Zapisz .
  2. Kliknij Projekt bez tytułu, wpisz Szybki start i kliknij Zmień nazwę.

Konfigurowanie skryptu

Kopiuj numer projektu Cloud

  1. W konsoli Google Cloud kliknij Menu  > Administracja > Ustawienia.

    Otwórz stronę Administracja Ustawienia administratora

  2. W polu Numer projektu skopiuj wartość.
  1. Otwórz projekt Apps Script.
  2. Kliknij Ustawienia projektu .
  3. W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
  4. W polu Numer projektu GCP wklej numer projektu Google Cloud.
  5. Kliknij Ustaw projekt.

Włączanie interfejsu Google Chat API

  1. Otwórz projekt Apps Script.
  1. Kliknij Ustawienia projektu .
  2. W sekcji Ustawienia ogólne włącz opcję Pokaż plik „appsscript.json” plik manifestu w edytorze.
  3. Kliknij Edytor , wybierz appscript.json i zastąp zawartość następującym kodem:

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"
    }]
  }
}

Uruchamianie przykładu

W edytorze Apps Script kliknij Uruchom.

Przy pierwszym uruchomieniu przykładu pojawi się prośba o autoryzację dostępu:

  1. Kliknij Przejrzyj uprawnienia.
  2. Wybierz konto.
  3. Kliknij Zezwól.

U dołu okna pojawi się dziennik wykonania skryptu.

Dalsze kroki