Обновите или продлите подписку на Google Workspace

Скрипт приложений

• Подписка на Google Workspace. Чтобы создать её, см. раздел Создание подписки .

• Проект Apps Script:
  • Используйте свой проект Google Cloud вместо проекта по умолчанию, созданного автоматически Apps Script.
  • Для всех областей действия, добавленных для настройки экрана согласия OAuth, необходимо также добавить их в файл appsscript.json в проекте Apps Script. Например, если вы указали область действия chat.messages , добавьте следующее:

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

  • Включите расширенную службу Google Workspace Events .

• Требуется аутентификация и соответствующая область авторизации для каждого типа событий в подписке:

  • Для аутентификации пользователя требуется одна или несколько областей действия, поддерживающих хотя бы один из типов событий для подписки. Чтобы определить область действия, см . раздел «Области действия по типу события» .
  • Для подписки на событие чата через приложение чата требуется аутентификация приложения с однократным одобрением администратора . Подписка на событие чата через приложение чата доступна в версии Developer Preview .

Питон

• Python 3.6 или выше
• Инструмент управления пакетами pip
• Последние клиентские библиотеки Google для Python. Чтобы установить или обновить их, выполните следующую команду в командной строке:

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

• Подписка на Google Workspace. Чтобы создать её, см. раздел Создание подписки .

• Требуется аутентификация и соответствующая область авторизации для каждого типа событий в подписке:

  • Для аутентификации пользователя требуется одна или несколько областей действия, поддерживающих хотя бы один из типов событий для подписки. Чтобы определить область действия, см . раздел «Области действия по типу события» .
  • Для подписки на событие чата через приложение чата требуется аутентификация приложения с однократным одобрением администратора . Подписка на событие чата через приложение чата доступна в версии Developer Preview .

Скрипт приложений

1. В проекте Apps Script создайте новый файл скрипта с именем updateSubscription и добавьте следующий код:

   function updateSubscription() {
     // The name of the subscription to update.
     const name = 'subscriptions/SUBSCRIPTION_ID';
   
     // Call the Workspace Events API using the advanced service.
     const response = WorkspaceEvents.Subscriptions.patch({
       ttl: '0s',
     }, name);
     console.log(response);
   }
   

   Заменить следующее:

   • SUBSCRIPTION_ID : Идентификатор подписки. Чтобы получить идентификатор, воспользуйтесь любым из следующих способов:
     • Значение поля uid .
     • Идентификатор имени ресурса, представленный в поле name . Например, если имя ресурса — subscriptions/subscription-123 , используйте subscription-123 .

2. Чтобы обновить подписку Google Workspace, запустите функцию updateSubscription в проекте Apps Script.

Питон

1. В рабочем каталоге создайте файл с именем update_subscription.py и добавьте следующий код:

   """Update 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('credentials.json', SCOPES)
   CREDENTIALS = flow.run_local_server()
   
   # Call the Workspace Events API using the service endpoint.
   service = build(
       'workspaceevents',
       'v1',
       credentials=CREDENTIALS,
   )
   
   BODY = {
       'ttl': {'seconds': 0},
   }
   NAME = 'subscriptions/SUBSCRIPTION_ID'
   response = (
       service.subscriptions()
       .patch(name=NAME, updateMask='ttl', body=BODY)
       .execute()
   )
   print(response)
   

   Заменить следующее:

   • SCOPES : Одна или несколько областей действия OAuth , поддерживающих каждый тип событий для подписки. Форматируется как массив строк. Чтобы перечислить несколько областей действия, разделите их запятыми. Например, 'https://www.googleapis.com/auth/chat.spaces.readonly', 'https://www.googleapis.com/auth/chat.memberships.readonly' .
   • SUBSCRIPTION_ID : Идентификатор подписки. Чтобы получить идентификатор, воспользуйтесь любым из следующих способов:
     • Значение поля uid .
     • Идентификатор имени ресурса, представленный в поле name . Например, если имя ресурса — subscriptions/subscription-123 , используйте subscription-123 .

2. Убедитесь, что вы сохранили учётные данные OAuth-клиента в рабочем каталоге и назвали файл credentials.json . В примере кода этот JSON-файл используется для аутентификации в Google Workspace и получения учётных данных пользователя. Инструкции см. в разделе Создание учётных данных OAuth-клиента .

3. Чтобы обновить подписку Google Workspace, выполните в терминале следующее:

   python3 update_subscription.py

Питон

  """Update subscription."""

  from google.oauth2 import service_account
  from apiclient.discovery import build

  # Specify required scopes.
  SCOPES = [SCOPES]

  # Specify service account details.
  CREDENTIALS = (
      service_account.Credentials.from_service_account_file('credentials.json')
      .with_scopes(SCOPES)
  )

  # Call the Workspace Events API using the service endpoint.
  service = build(
      'workspaceevents',
      'v1beta',
      credentials=CREDENTIALS,
      discoveryServiceUrl='https://workspaceevents.googleapis.com/$discovery/rest?version=v1beta&labels=DEVELOPER_PREVIEW&key=API_KEY',
  )

  BODY = {
      'ttl': {'seconds': 0},
  }
  NAME = 'subscriptions/SUBSCRIPTION_ID'
  response = (
      service.subscriptions()
      .patch(name=NAME, updateMask='ttl', body=BODY)
      .execute()
  )
  print(response)