Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Krótkie wprowadzenie do Node.js

Tworzenie aplikacji wiersza poleceń Node.js, która wysyła żądania do interfejsu Google Apps Script API

Krótkie wprowadzenia wyjaśniają, jak skonfigurować i uruchomić aplikację, która wywołuje interfejs Google Workspace API. W tym krótkim wprowadzeniu używamy uproszczonego podejścia do uwierzytelniania, które jest odpowiednie dla środowiska testowego. W przypadku środowiska produkcyjnego zalecamy zapoznanie się z uwierzytelnianiem i autoryzacją przed wybraniem danych logowania, które są odpowiednie dla Twojej aplikacji.

W tym krótkim wprowadzeniu używamy zalecanych przez Google Workspace bibliotek klienta API, aby obsługiwać niektóre szczegóły przepływu uwierzytelniania i autoryzacji.

Cele

skonfigurować środowisko,
zainstalować bibliotekę klienta,
skonfigurować próbkę,
uruchomić próbkę.

Wymagania wstępne

Aby uruchomić to krótkie wprowadzenie, musisz spełnić te wymagania wstępne:

Zainstalowane środowisko Node.js & npm.
Projekt Google Cloud.

Konto Google z włączonym Dyskiem Google.

Konfigurowanie środowiska

Aby ukończyć to krótkie wprowadzenie, skonfiguruj środowisko.

Włącz API

Zanim zaczniesz korzystać z interfejsów API Google, musisz je włączyć w projekcie w chmurze Google. W jednym projekcie Google Cloud możesz włączyć co najmniej 1 interfejs API.

W konsoli Google Cloud włącz interfejs Google Apps Script API.

Włącz API

Konfigurowanie ekranu zgody OAuth

Jeśli do ukończenia tego krótkiego wprowadzenia używasz nowego projektu w chmurze Google Cloud, skonfiguruj ekran zgody OAuth. Jeśli ten krok został już wykonany w przypadku projektu w chmurze, przejdź do następnej sekcji.

W Konsoli interfejsów API Google otwórz Menu > Platforma uwierzytelniania Google > Branding.
Otwórz Branding
Jeśli platforma uwierzytelniania Google została już skonfigurowana, możesz skonfigurować te ustawienia ekranu zgody OAuth w sekcjach Branding, Odbiorcy i Dostęp do danych. Jeśli zobaczysz komunikat Platforma uwierzytelniania Google nie została jeszcze skonfigurowana, kliknij Rozpocznij:

W sekcji Informacje o aplikacji w polu Nazwa aplikacji wpisz nazwę aplikacji.
W polu Adres e-mail dla użytkowników potrzebujących pomocy wybierz adres e-mail, na który użytkownicy mogą się z Tobą skontaktować, jeśli mają pytania dotyczące zgody.
Kliknij Dalej.
W sekcji Odbiorcy wybierz Wewnętrzni.
Kliknij Dalej.
W sekcji Dane kontaktowe wpisz Adres e-mail, na który będziesz otrzymywać powiadomienia o wszelkich zmianach w projekcie.
Kliknij Dalej.
W sekcji Zakończ zapoznaj się z Zasadami dotyczącymi danych użytkownika w usługach interfejsu API Google. Jeśli się z nimi zgadzasz, zaznacz pole Akceptuję zasady dotyczące danych użytkownika w usługach interfejsu API Google.
Kliknij Dalej.
Kliknij Utwórz.

Na razie możesz pominąć dodawanie zakresów. Gdy w przyszłości utworzysz aplikację do użytku poza organizacją Google Workspace , musisz zmienić Typ użytkownika na Zewnętrzny. Następnie dodaj zakresy autoryzacji wymagane przez aplikację. Więcej informacji znajdziesz w pełnym przewodniku Konfigurowanie ekranu zgody OAuth.

Autoryzowanie danych logowania aplikacji na komputer

Aby uwierzytelniać użytkowników końcowych i uzyskiwać dostęp do danych użytkowników w aplikacji, musisz utworzyć co najmniej 1 identyfikator klienta OAuth 2.0. Identyfikator klienta wskazuje konkretną aplikację na serwerach OAuth Google. Jeśli Twoja aplikacja działa na wielu platformach, musisz utworzyć osobny identyfikator klienta dla każdej z nich.

W Konsoli interfejsów API Google otwórz Menu > Platforma uwierzytelniania Google > Klienci.
Otwórz Klienci
Kliknij Utwórz klienta.
Kliknij Typ aplikacji > Aplikacja na komputer.
W polu Nazwa wpisz nazwę danych logowania. Ta nazwa jest widoczna tylko w Konsoli interfejsów API Google.
Kliknij Utwórz.
Nowo utworzone dane logowania pojawią się w sekcji „Identyfikatory klientów OAuth 2.0”.
Zapisz pobrany plik JSON jako credentials.json i przenieś plik do katalogu roboczego.

Instalowanie biblioteki klienta

Zainstaluj biblioteki za pomocą npm:

npm install googleapis@105 @google-cloud/local-auth@2.1.0 --save

Konfigurowanie próbki

W katalogu roboczym utwórz plik o nazwie index.js.

Wklej do pliku ten kod:

apps-script/quickstart/index.js

Wyświetl w GitHubie

import path from 'node:path';
import process from 'node:process';
import {authenticate} from '@google-cloud/local-auth';
import {google} from 'googleapis';

const SCOPES = ['https://www.googleapis.com/auth/script.projects'];
const CREDENTIALS_PATH = path.join(process.cwd(), 'credentials.json');

/**
 * Creates a new script project, upload a file, and log the script's URL.
 */
async function callAppsScript() {
  const auth = await authenticate({
    scopes: SCOPES,
    keyfilePath: CREDENTIALS_PATH,
  });

  const script = google.script({version: 'v1', auth});
  const project = await script.projects.create({
    requestBody: {
      title: 'My Script',
    },
  });

  if (!project.data.scriptId) {
    throw new Error('Failed to create project');
  }

  await script.projects.updateContent({
    scriptId: project.data.scriptId,
    auth,
    requestBody: {
      files: [
        {
          name: 'hello',
          type: 'SERVER_JS',
          source: 'function helloWorld() {\n  console.log("Hello, world!");\n}',
        },
        {
          name: 'appsscript',
          type: 'JSON',
          source:
            '{"timeZone":"America/New_York","exceptionLogging":' + '"CLOUD"}',
        },
      ],
    },
  });
  console.log(`https://script.google.com/d/${project.data.scriptId}/edit`);
}

await callAppsScript();

Uruchamianie próbki

W katalogu roboczym uruchom próbkę:
```
node .
```

Gdy uruchomisz próbkę po raz pierwszy, pojawi się prośba o autoryzację dostępu:
1. Jeśli nie zalogowano się na konto Google, zaloguj się, gdy pojawi się prośba. Jeśli korzystasz z kilku kont, wybierz jedno, którego chcesz użyć do autoryzacji.
2. Kliknij Akceptuję.
Aplikacja Node.js uruchamia się i wywołuje interfejs Google Apps Script API.

Informacje o autoryzacji są przechowywane w systemie plików, więc gdy następnym razem uruchomisz przykładowy kod, nie zobaczysz prośby o autoryzację.