Tworzenie subskrypcji Google Workspace

Google Apps Script

• Aby używać poleceń interfejsu wiersza poleceń Google Cloud opisanych w tym przewodniku:
  1. Zainstaluj interfejs wiersza poleceń Google Cloud.
  2. Aby inicjalizować interfejs wiersza poleceń gcloud, uruchom ten kod:

    gcloud init
    

• Projekt Google Cloud z włączonymi płatnościami. W przypadku subskrypcji w Google Chat musisz też włączyć interfejs Chat API w projekcie Cloud i skonfigurować pola Nazwa aplikacji, URL awatara i Opis. Szczegółowe informacje znajdziesz w artykule Tworzenie aplikacji Google Chat.
• Wymaga uwierzytelniania użytkownika na ekranie zgody OAuth skonfigurowanym dla aplikacji. Podczas konfigurowania ekranu zgody musisz określić zakres, aby obsługiwać każdy typ zdarzenia w ramach subskrypcji. Aby skonfigurować ekran zgody i określić wymagane zakresy, przeczytaj artykuł Wybieranie zakresów.

• projekt Apps Script:
  • Zamiast domyślnego projektu utworzonego automatycznie przez Apps Script użyj swojego projektu Google Cloud.
  • W przypadku zakresów, które dodano do skonfigurowania ekranu zgody OAuth, musisz też dodać te zakresy do pliku appsscript.json w projekcie Apps Script. Na przykład:

  "oauthScopes": [
    "https://www.googleapis.com/auth/chat.messages.readonly"
  ]
      

  • Włącz usługę zaawansowaną Google Workspace Events.

Python

• Python 3.6 lub nowszy
• Narzędzie do zarządzania pakietami pip
• najnowsze biblioteki klienta Google dla Pythona; Aby je zainstalować lub zaktualizować, uruchom w interfejsie wiersza poleceń to polecenie:

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

• Aby używać poleceń interfejsu wiersza poleceń Google Cloud opisanych w tym przewodniku:
  1. Zainstaluj interfejs wiersza poleceń Google Cloud.
  2. Aby inicjalizować interfejs wiersza poleceń gcloud, uruchom ten kod:

    gcloud init
    

• Projekt Google Cloud z włączonymi płatnościami. W przypadku subskrypcji w Google Chat musisz też włączyć interfejs Chat API w projekcie Cloud i skonfigurować pola Nazwa aplikacji, URL awatara i Opis. Szczegółowe informacje znajdziesz w artykule Tworzenie aplikacji Google Chat.
• Wymaga uwierzytelniania użytkownika na ekranie zgody OAuth skonfigurowanym dla aplikacji. Podczas konfigurowania ekranu zgody musisz określić zakres, aby obsługiwać każdy typ zdarzenia w ramach subskrypcji. Aby skonfigurować ekran zgody i określić wymagane zakresy, przeczytaj artykuł Wybieranie zakresów.

Google Cloud Console

W konsoli Google Cloud otwórz projekt Google Cloud dla swojej aplikacji i włącz interfejsy Google Workspace Events API i Pub/Sub API:

Włącz interfejsy API

gcloud

1. W katalogu roboczym zaloguj się na konto Google:

   gcloud auth login

2. Ustaw projekt jako projekt Cloud dla aplikacji:

   gcloud config set project PROJECT_ID

   Zastąp PROJECT_ID identyfikatorem projektu projektu Cloud Twojej aplikacji.

3. Włącz interfejsy Google Workspace Events API i Google Cloud Pub/Sub API:

   gcloud services enable pubsub.googleapis.com workspaceevents.googleapis.com

Google Cloud Console

1. W konsoli Google Cloud otwórz stronę Pub/Sub:

   Otwórz Google Cloud Pub/Sub

   Sprawdź, czy wybrany jest projekt Cloud dla Twojej aplikacji.

2. Kliknij add_box Utwórz temat i wykonaj te czynności:

   1. Wpisz nazwę tematu, np. workspace-events-topic.
   2. Pozostaw zaznaczoną opcję Dodaj subskrypcję domyślną. Pub/Sub nadaje tej domyślnej subskrypcji nazwę podobną do nazwy tematu, np. workspace-events-topic-sub.
   3. Opcjonalnie: zaktualizuj lub skonfiguruj dodatkowe właściwości tematu.

3. Kliknij Utwórz. Pełny temat ma format projects/PROJECT_ID/topics/TOPIC_ID. Użyjesz tej pełnej nazwy w jednym z kolejnych kroków.

4. Przyznaj dostęp do publikowania wiadomości Pub/Sub w temacie:

   1. Na stronie tematu otwórz panel boczny i kliknij kartę Uprawnienia.
   2. Kliknij Dodaj podmiot zabezpieczeń.
   3. W polu Dodaj podmioty zabezpieczeń dodaj konto usługi aplikacji Google Workspace, która dostarcza zdarzenia do Twojej subskrypcji:
      1. W przypadku zdarzeń Google Chat: chat-api-push@system.gserviceaccount.com.
      2. W przypadku wydarzeń w Meet: meet-api-event-push@system.gserviceaccount.com.
   4. W menu Przypisz role kliknij Pub/Sub Publisher.
   5. Kliknij Zapisz. Zmiana uprawnień do tematu może potrwać kilka minut.

gcloud

1. W projekcie Cloud utwórz temat, uruchamiając to polecenie:

   gcloud pubsub topics create TOPIC_ID

   Zastąp TOPIC_ID unikalnym identyfikatorem tematu, np. workspace-events-topic.

   Dane wyjściowe zawierają pełną nazwę tematu sformatowaną jako projects/PROJECT_ID/topics/TOPIC_ID. Zapisz nazwę i upewnij się, że wartość w polu PROJECT_ID to identyfikator projektu Cloud Twojej aplikacji. Nazwy tematu użyjesz w następnym kroku i później do utworzenia subskrypcji Google Workspace.

2. Przyznawanie dostępu do publikowania wiadomości w temacie:

   gcloud pubsub topics add-iam-policy-binding TOPIC_NAME --member='serviceAccount:GOOGLE_WORKSPACE_APPLICATION' --role='roles/pubsub.publisher'

   Zastąp następujące elementy:

   • TOPIC_NAME: pełna nazwa tematu, która jest wyjściem z poprzedniego kroku. Format: projects/PROJECT_ID/topics/TOPIC_ID.

   • GOOGLE_WORKSPACE_APPLICATION: aplikacja Google Workspace, która musi przesyłać zdarzenia do Twojej subskrypcji:

     • Aby otrzymywać zdarzenia z Google Chat, użyj elementu chat-api-push@system.gserviceaccount.com.
     • Aby odbierać zdarzenia z Meet, użyj opcji meet-api-event-push@system.gserviceaccount.com.

   Zmiana uprawnień tematu może potrwać kilka minut.

3. Utwórz subskrypcję Pub/Sub dla tematu:

    gcloud pubsub subscriptions create SUBSCRIPTION_NAME --topic=TOPIC_NAME

   Zastąp następujące elementy:

   • SUBSCRIPTION_NAME: nazwa subskrypcji, na przykład workspace-events-subscription.
   • TOPIC_NAME: nazwa tematu utworzonego w poprzednim kroku.

Google Apps Script

1. W projekcie Apps Script utwórz nowy plik skryptu o nazwie createSubscription i dodaj ten kod:

   function createSubscription() {
     // The Google Workspace resource to monitor for events.
     const targetResource = 'TARGET_RESOURCE';
   
     // The types of events to receive.
     const eventTypes = [EVENT_TYPES];
   
     // The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
     const pubsubTopic = 'TOPIC_NAME';
   
     // Whether to include resource data or not.
     const resourceData = RESOURCE_DATA;
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.create({
       targetResource: targetResource,
       eventTypes: eventTypes,
       notificationEndpoint: {
         pubsubTopic: pubsubTopic,
       },
       payloadOptions: {
         includeResource: resourceData
       }
     });
     console.log(response);
   }
   

   Zastąp następujące elementy:

   • TARGET_RESOURCE: Zasoby Google Workspace, do których subskrybujesz dostęp, w formacie pełnej nazwy zasobu. Na przykład, aby zasubskrybować pokój Google Chat z identyfikatorem AAAABBBB, użyj //chat.googleapis.com/spaces/AAAABBBB.
   • EVENT_TYPES: co najmniej 1 typ zdarzenia, na które chcesz się zapisać w zasobie docelowym. Formatuj jako tablicę ciągów znaków, np. 'google.workspace.chat.message.v1.created'.
   • TOPIC_NAME: pełna nazwa tematu Pub/Sub utworzonego w projekcie Cloud. Format: projects/PROJECT_ID/topics/TOPIC_ID.

   • RESOURCE_DATA: wartość logiczna określająca, czy subskrypcja zawiera dane zasobu w ładunku:

     • True: obejmuje wszystkie dane zasobu. Aby ograniczyć liczbę pól, które mają być uwzględnione, dodaj pole fieldMask i określ co najmniej 1 pole dla zmienionego zasobu. Obsługa danych zasobów jest dostępna tylko w przypadku subskrypcji zasobów Google Chat.
     • False: nie zawiera danych o zasobach.

2. Aby utworzyć subskrypcję Google Workspace, uruchom funkcję createSubscription w projekcie Apps Script.

Python

1. W katalogu roboczym utwórz plik o nazwie create_subscription.py i dodaj ten kod:

   """Create subscription."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = [SCOPES]
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # The Google Workspace resource to monitor for events.
   TARGET_RESOURCE = 'TARGET_RESOURCE'
   
   # The types of events to receive.
   EVENT_TYPES = [EVENT_TYPES]
   
   # The endpoint to deliver events to, such as a Google Cloud Pub/Sub topic.
   TOPIC = 'TOPIC_NAME'
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   BODY = {
       'target_resource': TARGET_RESOURCE,
       'event_types': EVENT_TYPES,
       'notification_endpoint': {'pubsub_topic': TOPIC},
       'payload_options': {'include_resource': RESOURCE_DATA},
   }
   response = service.subscriptions().create(body=BODY).execute()
   print(response)
   

   Zastąp następujące elementy:

   • SCOPES: co najmniej 1 zakres OAuth obsługujący każdy typ zdarzenia w subskrypcji. Sformatowany jako tablica ciągów znaków. Aby podać wiele zakresów, rozdziel je przecinkami. Na przykład: 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly'.
   • TARGET_RESOURCE: Zasoby Google Workspace, do których się subskrybujesz, w pełnej nazwie. Na przykład, aby zasubskrybować pokój Google Chat z identyfikatorem AAAABBBB, użyj //chat.googleapis.com/spaces/AAAABBBB.
   • EVENT_TYPES: co najmniej 1 typ zdarzenia, na które chcesz się zapisać w zasobie docelowym. Formatuj jako tablicę ciągów znaków, np. 'google.workspace.chat.message.v1.created'.
   • TOPIC_NAME: pełna nazwa tematu Pub/Sub utworzonego w projekcie Cloud. Format: projects/PROJECT_ID/topics/TOPIC_ID.

   • RESOURCE_DATA: wartość logiczna określająca, czy subskrypcja zawiera dane zasobu w ładunku:

     • True: obejmuje wszystkie dane zasobu. Aby ograniczyć liczbę pól, które mają być uwzględnione, dodaj pole fieldMask i określ co najmniej 1 pole dla zmienionego zasobu. Obsługa obejmuje tylko subskrypcje zasobów Google Chat, w tym danych zasobów.
     • False: nie zawiera danych o zasobach.

2. Aby utworzyć subskrypcję Google Workspace, uruchom w terminalu to polecenie:

   python3 create_subscription.py

Google Cloud Console

1. Wywoływanie co najmniej 1 rodzaju zdarzenia w zasobie docelowym w ramach subskrypcji Google Workspace. Jeśli na przykład subskrybujesz nowe wiadomości w pokoju czatu, opublikuj wiadomość w pokoju.

2. W konsoli Google Cloud otwórz stronę Pub/Sub:

   Otwórz stronę Pub/Sub

   Sprawdź, czy wybrany jest projekt Cloud dla Twojej aplikacji.

3. W menu Pub/Sub kliknij Subskrypcje.

4. W tabeli znajdź subskrypcję Pub/Sub dla tematu i kliknij nazwę subskrypcji.

5. Kliknij kartę Wiadomości.

6. Kliknij Pociągnij. Wygenerowanie wiadomości Pub/Sub może potrwać do kilku minut.

gcloud

1. Wywoływanie co najmniej 1 rodzaju zdarzenia w zasobie docelowym w ramach subskrypcji Google Workspace. Jeśli na przykład subskrybujesz nowe wiadomości w pokoju czatu, opublikuj wiadomość w pokoju.

2. Uruchom to polecenie:

   gcloud pubsub subscriptions pull PUBSUB_SUBSCRIPTION_NAME --format=json --limit=MESSAGE_COUNT --auto-ack

   Zastąp następujące elementy:

   • PUBSUB_SUBSCRIPTION_NAME: pełna nazwa subskrypcji Pub/Sub w formacie projects/SUBSCRIPTION_ID/subscriptions/SUBSCRIPTION_ID.
   • MESSAGE_COUNT: maksymalna liczba wiadomości Pub/Sub, które chcesz pobrać.

   Wygenerowanie wiadomości Pub/Sub może potrwać kilka minut.