এই পৃষ্ঠাটি ব্যাখ্যা করে যে কীভাবে subscriptions.update()
পদ্ধতি ব্যবহার করে Google Workspace সাবস্ক্রিপশন রিনিউ করা যায়। আপনি সাবস্ক্রিপশনের মেয়াদ শেষ হওয়ার সময় আপডেট করতে এই পদ্ধতিটি ব্যবহার করতে পারেন, যার মধ্যে সর্বোচ্চ মেয়াদ শেষ হওয়ার সম্ভাব্য সময়ের জন্য সাবস্ক্রিপশন পুনর্নবীকরণ করা বা লক্ষ্য সংস্থান সম্পর্কে প্রাপ্ত করার জন্য ইভেন্ট প্রকারের তালিকা আপডেট করা সহ।
অ্যাপস স্ক্রিপ্ট
- একটি Google Workspace সদস্যতা। একটি তৈরি করতে, একটি সদস্যতা তৈরি করুন দেখুন।
- একটি অ্যাপস স্ক্রিপ্ট প্রকল্প:
- অ্যাপস স্ক্রিপ্ট দ্বারা স্বয়ংক্রিয়ভাবে তৈরি ডিফল্টের পরিবর্তে আপনার Google ক্লাউড প্রকল্প ব্যবহার করুন।
- OAuth সম্মতি স্ক্রীন কনফিগার করার জন্য আপনি যে সমস্ত স্কোপ যোগ করেছেন তার জন্য, আপনাকে অবশ্যই আপনার Apps Script প্রোজেক্টের
appsscript.json
ফাইলে স্কোপ যোগ করতে হবে। উদাহরণস্বরূপ, আপনি যদিchat.messages
স্কোপ নির্দিষ্ট করেন, তাহলে নিম্নলিখিত যোগ করুন: Google Workspace Events
উন্নত পরিষেবা চালু করুন ।
"oauthScopes": [ "https://www.googleapis.com/auth/chat.messages" ]
সাবস্ক্রিপশনে প্রতিটি ইভেন্ট প্রকারের জন্য প্রমাণীকরণ এবং উপযুক্ত অনুমোদনের সুযোগ প্রয়োজন:
- ব্যবহারকারীর প্রমাণীকরণের জন্য, সাবস্ক্রিপশনের জন্য অন্তত একটি ইভেন্ট প্রকারকে সমর্থন করে এমন এক বা একাধিক স্কোপের প্রয়োজন৷ একটি সুযোগ শনাক্ত করতে, ইভেন্টের ধরন অনুসারে স্কোপগুলি দেখুন।
- চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়ার জন্য, এককালীন প্রশাসকের অনুমোদন সহ অ্যাপ প্রমাণীকরণ প্রয়োজন৷ একটি চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়া ডেভেলপার প্রিভিউতে উপলব্ধ৷
পাইথন
- পাইথন 3.6 বা তার বেশি
- পাইপ প্যাকেজ ম্যানেজমেন্ট টুল
- পাইথনের জন্য সর্বশেষ Google ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:
pip3 install --upgrade google-api-python-client google-auth-oauthlib
- একটি Google Workspace সদস্যতা। একটি তৈরি করতে, একটি সদস্যতা তৈরি করুন দেখুন।
সাবস্ক্রিপশনে প্রতিটি ইভেন্ট প্রকারের জন্য প্রমাণীকরণ এবং উপযুক্ত অনুমোদনের সুযোগ প্রয়োজন:
- ব্যবহারকারীর প্রমাণীকরণের জন্য, সাবস্ক্রিপশনের জন্য অন্তত একটি ইভেন্ট প্রকারকে সমর্থন করে এমন এক বা একাধিক স্কোপের প্রয়োজন৷ একটি সুযোগ শনাক্ত করতে, ইভেন্টের ধরন অনুসারে স্কোপগুলি দেখুন।
- চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়ার জন্য, এককালীন প্রশাসকের অনুমোদন সহ অ্যাপ প্রমাণীকরণ প্রয়োজন৷ একটি চ্যাট অ্যাপ হিসাবে একটি চ্যাট ইভেন্টে সদস্যতা নেওয়া ডেভেলপার প্রিভিউতে উপলব্ধ৷
Google Workspace সাবস্ক্রিপশন রিনিউ করুন
এই বিভাগে, আপনি Google Workspace Events API-এর subscriptions.update()
পদ্ধতি ব্যবহার করে সাবস্ক্রিপশনের সর্বোচ্চ মেয়াদ শেষ হওয়ার সময় রিনিউ করেন। সর্বোচ্চ মেয়াদ শেষ হওয়ার সময় নির্দিষ্ট করতে, আপনি Subscription
রিসোর্সের ttl
ক্ষেত্রটি 0
এ আপডেট করুন।
ইভেন্ট পেলোডে কোন রিসোর্স ডেটা অন্তর্ভুক্ত করা হয়েছে তার উপর সর্বোচ্চ মেয়াদ শেষ হওয়ার সময় নির্ভর করে। মেয়াদ শেষ হওয়ার সময় সম্পর্কে আরও জানতে, Google Workspace ইভেন্টের ইভেন্ট ডেটা দেখুন।
Google Workspace সাবস্ক্রিপশন রিনিউ করতে:
অ্যাপস স্ক্রিপ্ট
আপনার Apps স্ক্রিপ্ট প্রকল্পে,
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 সাবস্ক্রিপশন আপডেট করতে, আপনার Apps Script প্রোজেক্টে ফাংশন
updateSubscription
চালান।
পাইথন
আপনার কাজের ডিরেক্টরিতে,
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
: সদস্যতার আইডি। আইডি পেতে, আপনি নিম্নলিখিত যে কোনো একটি ব্যবহার করতে পারেন:
-
আপনার কাজের ডিরেক্টরিতে, নিশ্চিত করুন যে আপনি আপনার OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলি সংরক্ষণ করেছেন এবং ফাইলটির নাম দিয়েছেন
credentials.json
। কোড নমুনা এই JSON ফাইলটি Google Workspace-এর সাথে প্রমাণীকরণ করতে এবং ব্যবহারকারীর শংসাপত্র পেতে ব্যবহার করে। নির্দেশাবলীর জন্য, OAuth ক্লায়েন্ট আইডি শংসাপত্র তৈরি করুন দেখুন।Google Workspace সাবস্ক্রিপশন আপডেট করতে, আপনার টার্মিনালে নিম্নলিখিতটি চালান:
python3 update_subscription.py
Subscription
রিসোর্সের উদাহরণ থাকে। আপডেট করা Subscription
রিসোর্স সম্পর্কে বিশদ পেতে, operations.get()
পদ্ধতি ব্যবহার করুন এবং আপনার subscriptions.update()
অনুরোধ থেকে ফিরে আসা Operation
রিসোর্স উল্লেখ করুন। অন্যথায়, আপনি সাবস্ক্রিপশনের পূর্ববর্তী সংস্করণ থেকে একটি Operation
রিসোর্স উল্লেখ করলে, প্রতিক্রিয়া খালি থাকে।
Google Chat অ্যাপ হিসেবে সাবস্ক্রিপশন আপডেট বা রিনিউ করুন
আপনি ব্যবহারকারী হিসাবে পরিবর্তে চ্যাট অ্যাপ হিসাবে চ্যাট ইভেন্টগুলির সদস্যতা আপডেট বা পুনর্নবীকরণ করতে পারেন। প্রক্রিয়া অনুরূপ, ছাড়া:
ব্যবহারকারী প্রমাণীকরণের পরিবর্তে, এককালীন প্রশাসকের অনুমোদন সহ একটি চ্যাট অ্যাপ হিসাবে প্রমাণীকরণ করুন ৷
অনুমোদনের সুযোগগুলি নির্দিষ্ট করুন যা চ্যাট অ্যাপকে চ্যাট ইভেন্টগুলিতে সদস্যতা নেওয়ার অনুমতি দেয়। এই অনুমোদনের সুযোগগুলি সর্বদা
chat.app
দিয়ে শুরু হয় এবং নিম্নলিখিতগুলি অন্তর্ভুক্ত করে:-
https://www.googleapis.com/auth/chat.app.memberships
: চ্যাট স্পেস সদস্য ইভেন্টগুলিতে সদস্যতা নিন। -
https://www.googleapis.com/auth/chat.app.messages.readonly
: চ্যাট স্পেস মেসেজ ইভেন্টগুলিতে সদস্যতা নিন। -
https://www.googleapis.com/auth/chat.app.spaces
: চ্যাট স্পেস ইভেন্টগুলিতে সদস্যতা নিন।
-
একটি API কী তৈরি করুন
একটি বিকাশকারী পূর্বরূপ API পদ্ধতিতে কল করতে, আপনাকে অবশ্যই API আবিষ্কার নথির একটি অ-সর্বজনীন বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে৷ অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি API কী পাস করতে হবে।
API কী তৈরি করতে, আপনার অ্যাপের Google ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:
- Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।
- শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
- আপনার নতুন API কী প্রদর্শিত হয়৷
- আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে কপি ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API কী" বিভাগেও পাওয়া যাবে।
- অননুমোদিত ব্যবহার রোধ করতে, আমরা কোথায় এবং কোন API-এর জন্য API কী ব্যবহার করা যেতে পারে তা সীমাবদ্ধ করার পরামর্শ দিই। আরও বিশদ বিবরণের জন্য, API সীমাবদ্ধতা যুক্ত করুন দেখুন।
Google Workspace Events API কল করে এমন একটি স্ক্রিপ্ট লিখুন
নিম্নলিখিত কোড নমুনা একটি Chat অ্যাপের Google Workspace সদস্যতা আপডেট করে:
পাইথন
"""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)
নিম্নলিখিতগুলি প্রতিস্থাপন করুন:
SCOPES
: অনুমোদনের সুযোগগুলি নির্দিষ্ট করুন যা চ্যাট অ্যাপকে চ্যাট ইভেন্টগুলিতে সদস্যতা নেওয়ার অনুমতি দেয়। এই অনুমোদনের সুযোগগুলি সর্বদাchat.app
দিয়ে শুরু হয় এবং নিম্নলিখিতগুলি অন্তর্ভুক্ত করে:-
https://www.googleapis.com/auth/chat.app.memberships
: চ্যাট স্পেস সদস্য ইভেন্টগুলিতে সদস্যতা নিন। -
https://www.googleapis.com/auth/chat.app.messages.readonly
: চ্যাট স্পেস বার্তা এবং প্রতিক্রিয়া ইভেন্টগুলিতে সদস্যতা নিন। -
https://www.googleapis.com/auth/chat.app.spaces
: চ্যাট স্পেস ইভেন্টগুলিতে সদস্যতা নিন।
-
API_KEY
: এপিআই কী যা আপনি Google Workspace ইভেন্ট এপিআই-এর জন্য সার্ভিস এন্ডপয়েন্ট তৈরি করতে তৈরি করেছেন।SUBSCRIPTION_ID
: সদস্যতার আইডি। আইডি পেতে, আপনি নিম্নলিখিত যে কোনো একটি ব্যবহার করতে পারেন: