একটি ব্যবহারকারীর স্থান পড়ার অবস্থা আপডেট করুন৷

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে স্পেসকে পঠিত বা অপঠিত হিসাবে চিহ্নিত করতে Google Chat API-এর SpaceReadState রিসোর্সে updateSpaceReadState পদ্ধতি ব্যবহার করতে হয়।

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

পূর্বশর্ত

পাইথন

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

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

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

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

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 অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন৷

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

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

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

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

  • chat.users.readstate অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • SpaceReadState রিসোর্সে updateSpaceReadState পদ্ধতিতে কল করুন।
  • পাওয়ার জন্য স্পেস রিড স্টেটের name পাস করুন, যার মধ্যে একটি ইউজার আইডি বা উপনাম এবং একটি স্পেস আইডি রয়েছে। স্পেস রিড স্টেট পাওয়া শুধুমাত্র কলিং ব্যবহারকারীর রিড স্টেট পাওয়াকে সমর্থন করে, যা নিম্নলিখিতগুলির একটি সেট করে নির্দিষ্ট করা যেতে পারে:
    • me উপনাম. উদাহরণস্বরূপ, users/me/spaces/ SPACE /spaceReadState ।
    • কলিং ব্যবহারকারীর ওয়ার্কস্পেস ইমেল ঠিকানা। উদাহরণস্বরূপ, users/user@example.com/spaces/ SPACE /spaceReadState ।
    • কলিং ব্যবহারকারীর ব্যবহারকারী আইডি। উদাহরণস্বরূপ, users/ USER /spaces/ SPACE /spaceReadState ।
  • updateMask পাস করুন, যা আপডেট করার জন্য স্পেস রিড স্টেটের দিকগুলি নির্দিষ্ট করে, যা নিম্নলিখিত ক্ষেত্রের পথগুলিকে সমর্থন করে:
    • lastReadTime : যে সময় ব্যবহারকারীর স্থান পড়ার অবস্থা আপডেট করা হয়েছিল। সাধারণত এটি শেষ পঠিত বার্তার টাইমস্ট্যাম্পের সাথে মিলে যায়, অথবা একটি স্পেসে শেষ পঠিত অবস্থান চিহ্নিত করার জন্য ব্যবহারকারীর দ্বারা নির্দিষ্ট করা একটি টাইমস্ট্যাম্প। যখন lastReadTime সর্বশেষ বার্তা তৈরির সময়ের আগে হয়, তখন স্থানটি UI-তে অপঠিত হিসাবে উপস্থিত হয়। স্পেসটিকে পঠিত হিসাবে চিহ্নিত করতে, সর্বশেষ বার্তা তৈরির সময়ের চেয়ে যে lastReadTime মান পরবর্তীতে (বড়) সেট করুন। lastReadTime সর্বশেষ বার্তা তৈরির সময়ের সাথে মেলে জোর করে। মনে রাখবেন যে স্পেস রিড স্টেট শুধুমাত্র স্পেস এর টপ-লেভেল কথোপকথনে দৃশ্যমান বার্তাগুলির পড়ার অবস্থাকে প্রভাবিত করে। থ্রেডের উত্তরগুলি এই টাইমস্ট্যাম্প দ্বারা প্রভাবিত হয় না এবং পরিবর্তে থ্রেড পড়ার অবস্থার উপর নির্ভর করে।

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

পাইথন

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

  2. chat_spaceReadState_update.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"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then updates the space 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().updateSpaceReadState(

        # The space read state to update.
        #
        # 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/spaceReadState',
        updateMask='lastReadTime',
        body={'lastReadTime': f'{datetime.datetime(2000, 1, 3).isoformat()}Z'}

      ).execute()

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

if __name__ == '__main__':
    main()

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

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

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

    python3 chat_spaceReadState_update.py

Node.js

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

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

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

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

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

  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.updateSpaceReadState({

    /**
    * The space read state to update.
    *
    * 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/spaceReadState',
    updateMask: 'lastReadTime',
    requestBody: {
      lastReadTime: '{datetime.datetime(2000, 1, 3).isoformat()}Z'
    }
  });
}

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

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

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

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

    node chat_spaceReadState_update.js

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

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

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

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

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

    /**
* Authenticates with Chat API via user credentials,
* then updates the space read state for the calling user.
* @param {string} spaceReadStateName The resource name of the space read state.
*/
function updateSpaceReadState(spaceReadStateName) {
  try {
    const time = new Date('January 1, 2000')).toJSON();
    const body = {'lastReadTime': time};
    Chat.Users.Spaces.updateSpaceReadState(spaceReadStateName, body);
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log('Failed to update read state with error %s', err.message);
  }
}

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