Google Workspace সাবস্ক্রিপশন আপডেট বা রিনিউ করুন

এই পৃষ্ঠায় subscriptions.update() পদ্ধতি ব্যবহার করে Google Workspace সাবস্ক্রিপশন কীভাবে নবায়ন করবেন তা ব্যাখ্যা করা হয়েছে। সাবস্ক্রিপশনের মেয়াদ শেষ হওয়ার সময় আপডেট করতে এই পদ্ধতিটি ব্যবহার করুন, যার মধ্যে সর্বোচ্চ মেয়াদ শেষ হওয়ার সময়ের জন্য সাবস্ক্রিপশন পুনর্নবীকরণ করা অন্তর্ভুক্ত, অথবা লক্ষ্য রিসোর্স সম্পর্কে প্রাপ্ত ইভেন্টের ধরণের তালিকা আপডেট করা অন্তর্ভুক্ত।

অ্যাপস স্ক্রিপ্ট

• একটি Google Workspace সাবস্ক্রিপশন। একটি তৈরি করতে, একটি সাবস্ক্রিপশন তৈরি করুন দেখুন।

• একটি অ্যাপস স্ক্রিপ্ট প্রকল্প:
  • অ্যাপস স্ক্রিপ্ট দ্বারা স্বয়ংক্রিয়ভাবে তৈরি ডিফল্ট প্রোজেক্টের পরিবর্তে আপনার গুগল ক্লাউড প্রোজেক্ট ব্যবহার করুন।
  • OAuth সম্মতি স্ক্রিন কনফিগার করার জন্য আপনি যে সমস্ত স্কোপ যোগ করেছেন, তার জন্য আপনাকে আপনার Apps Script প্রজেক্টের appsscript.json ফাইলেও স্কোপ যোগ করতে হবে। উদাহরণস্বরূপ, যদি আপনি chat.messages স্কোপ নির্দিষ্ট করে থাকেন, তাহলে নিম্নলিখিতগুলি যোগ করুন:

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

  • Google Workspace Events অ্যাডভান্সড পরিষেবা সক্ষম করুন ।

• সাবস্ক্রিপশনে প্রতিটি ইভেন্টের ধরণের জন্য প্রমাণীকরণ এবং একটি উপযুক্ত অনুমোদনের সুযোগ প্রয়োজন:

  • ব্যবহারকারী প্রমাণীকরণের জন্য, সাবস্ক্রিপশনের জন্য কমপক্ষে একটি ইভেন্ট প্রকার সমর্থন করে এমন এক বা একাধিক স্কোপ প্রয়োজন। একটি স্কোপ সনাক্ত করতে, ইভেন্ট প্রকার অনুসারে স্কোপ দেখুন।
    দ্রষ্টব্য: এই নির্দেশিকায় কোড নমুনা চালানোর জন্য, আপনাকে অবশ্যই সাবস্ক্রিপশন তৈরি করতে ব্যবহৃত OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলি ব্যবহার করতে হবে।
  • চ্যাট অ্যাপ হিসেবে চ্যাট ইভেন্টে সাবস্ক্রাইব করার জন্য, এককালীন প্রশাসকের অনুমোদন সহ অ্যাপ প্রমাণীকরণ প্রয়োজন। চ্যাট অ্যাপ হিসেবে চ্যাট ইভেন্টে সাবস্ক্রাইব করার সুবিধা ডেভেলপার প্রিভিউতে উপলব্ধ।

পাইথন

• পাইথন ৩.৬ বা তার বেশি
• পিপ প্যাকেজ ম্যানেজমেন্ট টুল
• পাইথনের জন্য সর্বশেষ গুগল ক্লায়েন্ট লাইব্রেরি। এগুলি ইনস্টল বা আপডেট করতে, আপনার কমান্ড-লাইন ইন্টারফেসে নিম্নলিখিত কমান্ডটি চালান:

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

• একটি Google Workspace সাবস্ক্রিপশন। একটি তৈরি করতে, একটি সাবস্ক্রিপশন তৈরি করুন দেখুন।

• সাবস্ক্রিপশনে প্রতিটি ইভেন্টের ধরণের জন্য প্রমাণীকরণ এবং একটি উপযুক্ত অনুমোদনের সুযোগ প্রয়োজন:

  • ব্যবহারকারী প্রমাণীকরণের জন্য, সাবস্ক্রিপশনের জন্য কমপক্ষে একটি ইভেন্ট প্রকার সমর্থন করে এমন এক বা একাধিক স্কোপ প্রয়োজন। একটি স্কোপ সনাক্ত করতে, ইভেন্ট প্রকার অনুসারে স্কোপ দেখুন।
    দ্রষ্টব্য: এই নির্দেশিকায় কোড নমুনা চালানোর জন্য, আপনাকে অবশ্যই সাবস্ক্রিপশন তৈরি করতে ব্যবহৃত OAuth ক্লায়েন্ট আইডি শংসাপত্রগুলি ব্যবহার করতে হবে।
  • চ্যাট অ্যাপ হিসেবে চ্যাট ইভেন্টে সাবস্ক্রাইব করার জন্য, এককালীন প্রশাসকের অনুমোদন সহ অ্যাপ প্রমাণীকরণ প্রয়োজন। চ্যাট অ্যাপ হিসেবে চ্যাট ইভেন্টে সাবস্ক্রাইব করার সুবিধা ডেভেলপার প্রিভিউতে উপলব্ধ।

দ্রষ্টব্য: আপনার সাবস্ক্রিপশনের মেয়াদ শেষ না হওয়ার জন্য, Google আপনাকে মেয়াদ শেষ হওয়ার রিমাইন্ডার ইভেন্টের উপর নির্ভর না করার পরামর্শ দেয়। পরিবর্তে, আপনার সাবস্ক্রিপশনের মেয়াদ শেষ হওয়ার সময় ট্র্যাক করুন এবং প্রয়োজনে এটি পুনর্নবীকরণ করুন।

Google Workspace সাবস্ক্রিপশন রিনিউ করুন

এই বিভাগে, Google Workspace Events API এর subscriptions.update() পদ্ধতি ব্যবহার করে একটি সাবস্ক্রিপশনকে তার সর্বোচ্চ মেয়াদোত্তীর্ণ সময়ে পুনর্নবীকরণ করুন। সর্বোচ্চ মেয়াদোত্তীর্ণ সময় নির্দিষ্ট করতে, Subscription রিসোর্সের ttl ক্ষেত্রটি 0 এ আপডেট করুন।

ইভেন্ট পেলোডে কোন রিসোর্স ডেটা অন্তর্ভুক্ত করা হয়েছে তার উপর সর্বোচ্চ মেয়াদ শেষ হওয়ার সময় নির্ভর করে। মেয়াদ শেষ হওয়ার সময় সম্পর্কে আরও জানতে, Google Workspace ইভেন্টের জন্য ইভেন্ট ডেটা দেখুন।

Google Workspace সাবস্ক্রিপশন পুনর্নবীকরণ করতে:

অ্যাপস স্ক্রিপ্ট

1. আপনার অ্যাপস স্ক্রিপ্ট প্রজেক্টে, 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 সাবস্ক্রিপশন আপডেট করতে, আপনার Apps Script প্রজেক্টে updateSubscription ফাংশনটি চালান।

পাইথন

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 দিয়ে প্রমাণীকরণ করতে এবং ব্যবহারকারীর ক্রেডেনশিয়াল পেতে। নির্দেশাবলীর জন্য, Create OAuth ক্লায়েন্ট আইডি ক্রেডেনশিয়াল দেখুন।

3. Google Workspace সাবস্ক্রিপশন আপডেট করতে, আপনার টার্মিনালে নিম্নলিখিতগুলি চালান:

   python3 update_subscription.py

Google Workspace Events API একটি দীর্ঘমেয়াদী অপারেশন প্রদান করে যাতে Subscription রিসোর্সের উদাহরণ থাকে।

আপডেট করা Subscription রিসোর্স সম্পর্কে বিস্তারিত জানতে, operations.get() পদ্ধতিটি ব্যবহার করুন এবং আপনার subscriptions.update() অনুরোধ থেকে ফিরে আসা Operation রিসোর্সটি নির্দিষ্ট করুন। অন্যথায়, যদি আপনি সাবস্ক্রিপশনের পূর্ববর্তী সংস্করণ থেকে একটি Operation রিসোর্স নির্দিষ্ট করেন, তাহলে প্রতিক্রিয়াটি খালি থাকবে।

Google Chat অ্যাপ হিসেবে সাবস্ক্রিপশন আপডেট বা রিনিউ করুন

ডেভেলপার প্রিভিউ: গুগল ওয়ার্কস্পেস ডেভেলপার প্রিভিউ প্রোগ্রামের অংশ হিসেবে উপলব্ধ, যা নির্দিষ্ট কিছু বৈশিষ্ট্যের প্রাথমিক অ্যাক্সেস প্রদান করে।

আপনি একজন ব্যবহারকারী হিসেবে না হয়ে চ্যাট অ্যাপ হিসেবে চ্যাট ইভেন্টের সাবস্ক্রিপশন আপডেট বা নবায়ন করতে পারেন। প্রক্রিয়াটি একই রকম, তবে:

1. ব্যবহারকারীর প্রমাণীকরণের পরিবর্তে, এককালীন প্রশাসকের অনুমোদনের মাধ্যমে চ্যাট অ্যাপ হিসেবে প্রমাণীকরণ করুন ।

2. চ্যাট অ্যাপকে চ্যাট ইভেন্টগুলিতে সাবস্ক্রাইব করার অনুমতি দেয় এমন অনুমোদনের স্কোপগুলি নির্দিষ্ট করুন। এই অনুমোদনের স্কোপগুলি সর্বদা 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 Cloud Project খুলুন এবং নিম্নলিখিতগুলি করুন:

1. গুগল ক্লাউড কনসোলে, মেনু > API এবং পরিষেবা > শংসাপত্রগুলিতে যান।

   শংসাপত্রগুলিতে যান

2. ক্রেডেনশিয়াল তৈরি করুন > API কী ক্লিক করুন।
3. আপনার নতুন API কী প্রদর্শিত হবে।
   • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে, "Copy এ ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API Keys" বিভাগেও পাওয়া যাবে।
   • অননুমোদিত ব্যবহার রোধ করার জন্য, আমরা সুপারিশ করছি যে API কী কোথায় এবং কোন API-এর জন্য ব্যবহার করা যেতে পারে তা সীমাবদ্ধ করুন। আরও বিস্তারিত জানার জন্য, 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 Events API-এর জন্য পরিষেবার শেষ বিন্দু তৈরি করতে আপনি যে API কীটি তৈরি করেছেন।

• SUBSCRIPTION_ID : সাবস্ক্রিপশনের আইডি। আইডি পেতে, আপনি নিম্নলিখিত যেকোনো একটি ব্যবহার করতে পারেন:

  • uid ক্ষেত্রের মান।
  • name ক্ষেত্রে প্রদর্শিত রিসোর্স নামের আইডি। উদাহরণস্বরূপ, যদি রিসোর্সের নাম subscriptions/subscription-123 হয়, তাহলে subscription-123 ব্যবহার করুন।

সম্পর্কিত বিষয়

• সাবস্ক্রিপশন নিন
• সাবস্ক্রিপশন তালিকাভুক্ত করুন
• একটি সাবস্ক্রিপশন তৈরি করুন
• ত্রুটিগুলি সমাধান করুন এবং একটি সাবস্ক্রিপশন পুনরায় সক্রিয় করুন
• একটি সাবস্ক্রিপশন মুছুন