ব্যবহারকারীর থ্রেড পড়ার অবস্থা সম্পর্কে বিশদ বিবরণ পান

এই নির্দেশিকাটি ব্যাখ্যা করে যে Google Chat API-এর ThreadReadState রিসোর্সে getThreadReadState পদ্ধতিটি কীভাবে ব্যবহার করতে হয় একটি মেসেজ থ্রেডের মধ্যে ব্যবহারকারীর পড়ার অবস্থা সম্পর্কে বিশদ পেতে। একটি স্পেসে একটি বার্তার পঠিত অবস্থা পেতে, একটি ব্যবহারকারীর স্থান পড়ার অবস্থা সম্পর্কে বিশদ বিবরণ পান দেখুন৷

ThreadReadState রিসোর্স হল একটি সিঙ্গলটন রিসোর্স যা Google Chat মেসেজ থ্রেডে নির্দিষ্ট ব্যবহারকারীর শেষ পঠিত বার্তার বিবরণ উপস্থাপন করে।

পূর্বশর্ত

পাইথন

  • পাইথন 3.6 বা তার বেশি
  • পাইপ প্যাকেজ ম্যানেজমেন্ট টুল

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

    pip3 install --upgrade google-api-python-client google-auth-oauthlib
  • Google Chat API সক্ষম এবং কনফিগার করা একটি Google ক্লাউড প্রকল্প। ধাপগুলির জন্য, একটি Google Chat অ্যাপ তৈরি করুন দেখুন।

  • চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে। একটি স্থানের মধ্যে একটি ব্যবহারকারীর পঠিত অবস্থা সম্পর্কে বিশদ তথ্য পাওয়ার জন্য chat.users.readstate বা chat.users.readstate.readonly অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন৷

Node.js

  • Node.js এবং npm

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

    npm install @google-cloud/local-auth @googleapis/chat
  • Google Chat API সক্ষম এবং কনফিগার করা একটি Google ক্লাউড প্রকল্প। ধাপগুলির জন্য, একটি Google Chat অ্যাপ তৈরি করুন দেখুন।

  • চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে। একটি স্থানের মধ্যে একটি ব্যবহারকারীর পঠিত অবস্থা সম্পর্কে বিশদ তথ্য পাওয়ার জন্য chat.users.readstate বা chat.users.readstate.readonly অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন৷

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

  • Google Chat- এ অ্যাক্সেস সহ একটি Google Workspace অ্যাকাউন্ট।
  • একটি প্রকাশিত চ্যাট অ্যাপ। একটি চ্যাট অ্যাপ তৈরি করতে, এই কুইকস্টার্টটি অনুসরণ করুন।
  • চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে। একটি স্থানের মধ্যে একটি ব্যবহারকারীর পঠিত অবস্থা সম্পর্কে বিশদ তথ্য পাওয়ার জন্য chat.users.readstate বা chat.users.readstate.readonly অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন৷

কলিং ব্যবহারকারীর থ্রেড পড়ার অবস্থা পান

একটি বার্তা থ্রেডের মধ্যে একজন ব্যবহারকারীর পঠিত অবস্থা সম্পর্কে বিশদ বিবরণ পেতে, আপনার অনুরোধে নিম্নলিখিতগুলি অন্তর্ভুক্ত করুন:

  • chat.users.readstate বা chat.users.readstate.readonly অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • ThreadReadState রিসোর্সে getThreadReadState পদ্ধতিতে কল করুন।
  • পেতে থ্রেড রিড স্টেটের name পাস করুন, যার মধ্যে একটি ইউজার আইডি বা উপনাম এবং একটি স্পেস আইডি রয়েছে। থ্রেড রিড স্টেট পাওয়া শুধুমাত্র কলিং ইউজারের রিড স্টেট পাওয়াকে সমর্থন করে, যা নিম্নলিখিতগুলির একটি সেট করে নির্দিষ্ট করা যেতে পারে:
    • me উপনাম. উদাহরণস্বরূপ, users/me/spaces/ SPACE /threads/ THREAD /threadReadState ।
    • কলিং ব্যবহারকারীর ওয়ার্কস্পেস ইমেল ঠিকানা। উদাহরণস্বরূপ, users/user@example.com/spaces/ SPACE threads/ THREAD /threadReadState ।
    • কলিং ব্যবহারকারীর ব্যবহারকারী আইডি। উদাহরণস্বরূপ, users/ USER /spaces/ SPACE /threads/ THREAD /threadReadState ।

নিম্নলিখিত উদাহরণটি কলিং ব্যবহারকারীর থ্রেড পড়ার অবস্থা পায়:

পাইথন

  1. আপনার কাজের ডিরেক্টরিতে, chat_threadReadState_get.py নামে একটি ফাইল তৈরি করুন।

  2. chat_threadReadState_get.py এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build

# Define your app's authorization scopes.
# When modifying these scopes, delete the file token.json, if it exists.
SCOPES = ["https://www.googleapis.com/auth/chat.users.readstate.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then gets the thread read state for the calling user.
    '''

    # Authenticate with Google Workspace
    # and get user authorization.
    flow = InstalledAppFlow.from_client_secrets_file(
                      'client_secrets.json', SCOPES)
    creds = flow.run_local_server()

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds)

    # Use the service endpoint to call Chat API.
    result = chat.users().spaces().threads().getThreadReadState(

        # The thread read state to get.
        #
        # Replace USER with the calling user's ID, Workspace email,
        # or the alias me.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace THREAD with a thread name.
        # Obtain the thread name from the messages resource of Chat API.
        name='users/me/spaces/SPACE/threads/THREAD/threadReadState'

      ).execute()

    # Prints the API's response.
    print(result)

if __name__ == '__main__':
    main()

  3. কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    • SPACE : একটি স্থানের নাম, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।

    • THREAD : একটি থ্রেড নাম, যা আপনি Chat API-এর spaces.messages.get পদ্ধতি থেকে পেতে পারেন।

  4. আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:

    python3 chat_threadReadState_get.py

Node.js

  1. আপনার কাজের ডিরেক্টরিতে, chat_threadReadState_get.js নামে একটি ফাইল তৈরি করুন।

  2. chat_threadReadState_get এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    const chat = require('@googleapis/chat');
const {authenticate} = require('@google-cloud/local-auth');

/**
* Authenticates with Chat API via user credentials,
* then gets the thread read state for the calling user.
* @return {!Promise<!Object>}
*/
async function getThreadReadState() {

  /**
  * Authenticate with Google Workspace
  * and get user authorization.
  */
  const scopes = [
    'https://www.googleapis.com/auth/chat.users.readstate.readonly',
  ];

  const authClient =
      await authenticate({scopes, keyfilePath: 'client_secrets.json'});

  /**
  * Build a service endpoint for Chat API.
  */
  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  /**
  * Use the service endpoint to call Chat API.
  */
  return await chatClient.users.spaces.threads.getThreadReadState({

    /**
    * The thread read state to get.
    *
    * Replace USER with the calling user's ID, Workspace email,
    * or the alias me.
    *
    * Replace SPACE with a space name.
    * Obtain the space name from the spaces resource of Chat API,
    * or from a space's URL.
    */
    name: 'users/me/spaces/SPACE/threads/THREADS/threadReadState'
  });
}

/**
* Use the service endpoint to call Chat API.
*/
getThreadReadState().then(console.log);

  3. কোডে, নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

    • SPACE : একটি স্থানের নাম, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্থানের URL থেকে পেতে পারেন।

    • THREAD : একটি থ্রেড নাম, যা আপনি Chat API-এর spaces.messages.get পদ্ধতি থেকে পেতে পারেন।

  4. আপনার কাজের ডিরেক্টরিতে, নমুনা তৈরি করুন এবং চালান:

    node chat_threadReadState_get.js

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

এই উদাহরণটি উন্নত চ্যাট পরিষেবা ব্যবহার করে চ্যাট API-কে কল করে।

  1. Apps Script প্রকল্পের appsscript.json ফাইলে chat.users.readstate.readonly অনুমোদনের সুযোগ যোগ করুন:

    "oauthScopes": [
  "https://www.googleapis.com/auth/chat.users.readstate.readonly"
]

  2. অ্যাপস স্ক্রিপ্ট প্রকল্পের কোডে এইরকম একটি ফাংশন যোগ করুন:

    /**
* Authenticates with Chat API via user credentials,
* then gets the thread read state for the calling user.
* @param {string} threadReadStateName The resource name of the thread read state.
*/
function getThreadReadState(threadReadStateName) {
  try {
    Chat.Users.Spaces.Threads.getThreadReadState(threadReadStateName);
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed to get read state with error %s', err.message);
  }
}

Google Chat API নির্দিষ্ট থ্রেড রিড স্টেট পায় এবং ThreadReadState রিসোর্সের একটি উদাহরণ প্রদান করে।