Dowiedz się więcej o subskrypcji Google Workspace

Google Apps Script

• Abonament Google Workspace. Aby ją utworzyć, zapoznaj się z artykułem Tworzenie subskrypcji.

• Wymaga uwierzytelniania użytkownika za pomocą co najmniej 1 zakresu, który obsługuje wszystkie typy zdarzeń w ramach subskrypcji.

• 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
    

• Abonament Google Workspace. Aby ją utworzyć, zapoznaj się z artykułem Tworzenie subskrypcji.

• Wymaga uwierzytelnienia:

  • W przypadku uwierzytelniania użytkownika wymagany jest zakres, który obsługuje co najmniej 1 z typów zdarzeń w ramach subskrypcji. Aby określić zakres, zapoznaj się z artykułem Zakresy według typu zdarzenia.
  • Uwierzytelnianie aplikacji wymaga zakresu chat.bot (dotyczy tylko aplikacji Google Chat).

Google Apps Script

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

   function getSubscription() {
     // The name of the subscription to get.
     const name = 'subscriptions/SUBSCRIPTION_ID';
   
     // Call the Workspace Events API using the advanced service.
     const subscription = WorkspaceEvents.Subscriptions.get(name);
     console.log(subscription);
   }
   

   Zastąp następujące elementy:

   • SUBSCRIPTION_ID: identyfikator subskrypcji. Aby uzyskać identyfikator, możesz użyć jednej z tych opcji:
     • Wartość pola uid.
     • Identyfikator nazwy zasobu w polu name. Jeśli na przykład nazwa zasobu to subscriptions/subscription-123, użyj subscription-123.

2. Aby uzyskać subskrypcję, uruchom funkcję getSubscription w projekcie Apps Script.

Python

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

   """Get subscription."""
   
   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient.discovery import build
   
   # Specify required scopes.
   SCOPES = ['SCOPE']
   
   # Authenticate with Google Workspace and get user authentication.
   flow = InstalledAppFlow.from_client_secrets_file('client_secrets.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   NAME = 'subscriptions/SUBSCRIPTION_ID'
   subscription = service.subscriptions().get(name=NAME).execute()
   print(subscription)
   

   Zastąp następujące elementy:

   • SCOPE: zakres OAuth, który obsługuje co najmniej jeden typ zdarzenia z subskrypcji. Jeśli na przykład Twoja subskrypcja otrzymuje zdarzenia zaktualizowanego pokoju czatu, https://www.googleapis.com/auth/chat.spaces.readonly.
   • SUBSCRIPTION_ID: identyfikator subskrypcji. Aby uzyskać identyfikator, możesz użyć jednej z tych opcji:
     • Wartość pola uid.
     • Identyfikator nazwy zasobu w polu name. Jeśli na przykład nazwa zasobu to subscriptions/subscription-123, użyj subscription-123.

2. Sprawdź, czy w katalogu roboczym masz zapisane dane uwierzytelniające klienta OAuth i czy plik ma nazwę client_secrets.json. Plik ten służy do uwierzytelniania się w Google Workspace i uzyskiwania danych logowania użytkownika. Instrukcje znajdziesz w artykule Tworzenie danych logowania klienta OAuth.

3. Aby uzyskać subskrypcję, uruchom w terminalu to polecenie:

   python3 get_subscription.py