این صفحه نحوه تمدید اشتراک Google Workspace را با استفاده از متد subscriptions.update()
توضیح میدهد. شما می توانید از این روش برای به روز رسانی زمان انقضای یک اشتراک، از جمله تمدید اشتراک برای حداکثر زمان انقضای ممکن، یا به روز رسانی لیست انواع رویدادها برای دریافت در مورد منبع هدف استفاده کنید.
اسکریپت برنامه ها
- اشتراک Google Workspace. برای ایجاد یک اشتراک، به ایجاد اشتراک مراجعه کنید.
نیاز به احراز هویت کاربر با یک یا چند حوزه دارد که از همه انواع رویداد برای اشتراک پشتیبانی می کند .
- پروژه Apps Script:
- از پروژه Google Cloud خود به جای پروژه پیشفرض ایجاد شده توسط Apps Script استفاده کنید.
- برای هر دامنهای که برای پیکربندی صفحه رضایت OAuth اضافه کردهاید، باید دامنهها را نیز به فایل
appsscript.json
در پروژه Apps Script خود اضافه کنید. به عنوان مثال:
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages.readonly" ]
- سرویس پیشرفته
Google Workspace Events
را فعال کنید .
پایتون
- پایتون 3.6 یا بالاتر
- ابزار مدیریت بسته پیپ
- جدیدترین کتابخانه های مشتری گوگل برای پایتون. برای نصب یا به روز رسانی آنها، دستور زیر را در رابط خط فرمان خود اجرا کنید:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- اشتراک Google Workspace. برای ایجاد یک اشتراک، به ایجاد اشتراک مراجعه کنید.
نیاز به احراز هویت کاربر با یک یا چند حوزه دارد که از همه انواع رویداد برای اشتراک پشتیبانی می کند .
اشتراک Google Workspace را تمدید کنید
در این بخش، از متد subscriptions.update()
API رویدادهای Google Workspace برای تمدید اشتراک تا حداکثر زمان انقضا استفاده میکنید. برای تعیین حداکثر زمان انقضا، فیلد ttl
منبع Subscription
را به 0
به روز می کنید.
حداکثر زمان انقضا بستگی به داده های منبعی دارد که در بارگذاری رویداد گنجانده شده است. برای کسب اطلاعات بیشتر درباره زمانهای انقضا، به دادههای رویداد برای رویدادهای Google Workspace مراجعه کنید.
برای تمدید اشتراک Google Workspace:
اسکریپت برنامه ها
در پروژه 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); }
موارد زیر را جایگزین کنید:
برای بهروزرسانی اشتراک Google Workspace، تابع
updateSubscription
را در پروژه Apps Script خود اجرا کنید.
پایتون
در پوشه کاری خود، یک فایل به نام
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('client_secrets.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
: شناسه اشتراک. برای دریافت شناسه می توانید از یکی از موارد زیر استفاده کنید:
-
در فهرست کاری خود، مطمئن شوید که اعتبار شناسه مشتری OAuth خود را ذخیره کرده اید و نام فایل را
client_secrets.json
گذاشته اید. نمونه کد از این فایل JSON برای احراز هویت با Google Workspace و دریافت اعتبار کاربر استفاده می کند. برای دستورالعملها، به ایجاد اعتبار شناسه مشتری OAuth مراجعه کنید.برای بهروزرسانی اشتراک Google Workspace، موارد زیر را در ترمینال خود اجرا کنید:
python3 update_subscription.py
Subscription
است. برای دریافت جزئیات در مورد منبع Subscription
به روز شده، از متد operations.get()
استفاده کنید و منبع Operation
را که از درخواست subscriptions.update()
شما برگردانده شده است، مشخص کنید. در غیر این صورت، اگر منبع Operation
را از نسخه قبلی اشتراک مشخص کنید، پاسخ خالی است.