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.

Krótkie wprowadzenie do Google Workspace wykorzystuje biblioteki klienta API do obsługi niektórych szczegóły procesu uwierzytelniania i autoryzacji. Zalecamy używasz bibliotek klienta we własnych aplikacjach. W tym krótkim wprowadzeniu użyto uproszczone metody uwierzytelniania odpowiednie do testowania dla środowiska. W środowisku produkcyjnym zalecamy zapoznanie się z uwierzytelnianie i autoryzacja przed wybór danych logowania odpowiednie dla Twojej aplikacji.

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 masz już konto Google te czynności w Twoim projekcie Cloud zostały wykonane, przejdź do następnej sekcji.

Otwieranie projektu Cloud w konsoli Google Cloud

Jeśli projekt Cloud nie jest jeszcze otwarty, otwórz go, którego chcesz używać. dla tego przykładu:

  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 dla niego płatności.

Włączanie interfejsu Chat API

Zanim zaczniesz korzystać z 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. w przyszłości, gdy utworzysz aplikację do użytku poza swoim Google Workspace, musisz zmienić Typ użytkownika na Zewnętrzny, a następnie: dodaj zakresy autoryzacji wymagane przez aplikację.

  5. Przejrzyj podsumowanie rejestracji aplikacji. Aby wprowadzić zmiany, kliknij Edytuj. Jeśli aplikacja z rejestracji wszystko jest w porządku, kliknij Back to Dashboard (Powrót do panelu).

Konfigurowanie aplikacji Google Chat

Aby wywołać interfejs Google Chat API, musisz skonfigurować aplikacji Google Chat. W przypadku wszelkich żądań zapisu Google Chat atrybut aplikacji Google Chat w interfejsie za pomocą atrybutu poniższe informacje.

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

    Otwórz stronę konfiguracji interfejsu Chat API

  2. W sekcji Application info (Informacje o aplikacji) wpisz te informacje:

    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 Włącz funkcje interaktywne. ustaw w pozycji wyłączonej, aby wyłączyć funkcje interaktywne w aplikacja 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 otwórz menu . > Administracja Administracja > Ustawienia.

    Otwórz stronę Uprawnienia Ustawienia administratora

  2. Skopiuj wartość z pola Numer projektu.
  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 Set project (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 Sprawdź uprawnienia.
  2. Wybierz konto.
  3. Kliknij Zezwól.

Dziennik wykonywania skryptu pojawi się u dołu okna.

Dalsze kroki