اشتراک 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 را فعال کنید .

• برای هر نوع رویداد در اشتراک به احراز هویت و محدوده مجوز مناسب نیاز دارد:

  • برای احراز هویت کاربر، به یک یا چند محدوده نیاز دارد که حداقل یکی از انواع رویداد را برای اشتراک پشتیبانی کند. برای شناسایی یک محدوده، محدوده ها بر اساس نوع رویداد را ببینید.
  • برای اشتراک در یک رویداد گپ به عنوان یک برنامه گپ، به تأیید اعتبار برنامه با تأیید یک بار سرپرست نیاز دارد. اشتراک در یک رویداد گپ به عنوان یک برنامه گپ در پیش‌نمایش برنامه‌نویس موجود است.

پایتون

• پایتون 3.6 یا بالاتر
• ابزار مدیریت بسته پیپ
• جدیدترین کتابخانه های مشتری گوگل برای پایتون. برای نصب یا به روز رسانی آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:

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

• اشتراک Google Workspace. برای ایجاد یک اشتراک، به ایجاد اشتراک مراجعه کنید.

• برای هر نوع رویداد در اشتراک به احراز هویت و محدوده مجوز مناسب نیاز دارد:

  • برای احراز هویت کاربر، به یک یا چند محدوده نیاز دارد که حداقل یکی از انواع رویداد را برای اشتراک پشتیبانی کند. برای شناسایی یک محدوده، محدوده ها بر اساس نوع رویداد را ببینید.
  • برای اشتراک در یک رویداد گپ به عنوان یک برنامه گپ، به تأیید اعتبار برنامه با تأیید یک بار سرپرست نیاز دارد. اشتراک در یک رویداد گپ به عنوان یک برنامه گپ در پیش‌نمایش برنامه‌نویس موجود است.

اسکریپت برنامه ها

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)