একটি Google চ্যাট স্পেসে একটি ব্যবহারকারীর সদস্যতা আপডেট করুন, একটি Google চ্যাট স্পেসে একটি ব্যবহারকারীর সদস্যতা আপডেট করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে Google Chat API-এর Membership রিসোর্সে update() পদ্ধতিটি কীভাবে মেম্বারশিপ সম্পর্কে অ্যাট্রিবিউট পরিবর্তন করতে হয়, যেমন স্পেস মেম্বারকে স্পেস ম্যানেজারে পরিবর্তন করা বা স্পেস ম্যানেজারকে স্পেস মেম্বারে পরিবর্তন করা।

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনো স্পেস মেম্বারশিপ আপডেট করতে update() পদ্ধতিতে কল করতে পারেন।

Membership রিসোর্স প্রতিনিধিত্ব করে যে একজন মানব ব্যবহারকারী বা Google চ্যাট অ্যাপকে আমন্ত্রণ জানানো হয়েছে কিনা, এর অংশ বা কোনো স্থান থেকে অনুপস্থিত।

পূর্বশর্ত

Node.js

  • Google Chat অ্যাক্সেস সহ একটি ব্যবসা বা এন্টারপ্রাইজ Google Workspace অ্যাকাউন্ট।

একটি সদস্যপদ আপডেট করুন

একটি স্থান সদস্যতা আপডেট করতে, আপনার অনুরোধে নিম্নলিখিত পাস করুন:

  • একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন:
  • UpdateMembership() পদ্ধতিতে কল করুন।
  • নিম্নলিখিতগুলির সাথে Membership উদাহরণ হিসাবে membership পাস করুন:
    • name ক্ষেত্রটি আপডেট করার জন্য সদস্যপদে সেট করা হয়েছে, যার মধ্যে একটি স্পেস আইডি এবং একটি সদস্য আইডি রয়েছে৷
    • আপডেট করার জন্য সদস্যতা ক্ষেত্রগুলি নতুন মানগুলিতে সেট করা হয়েছে৷
  • আপডেট করার জন্য সদস্যতার দিকগুলি নির্দিষ্ট করতে updateMask পাস করুন, এতে নিম্নলিখিতগুলি অন্তর্ভুক্ত রয়েছে:
    • role : একটি চ্যাট স্পেসের মধ্যে ব্যবহারকারীর ভূমিকা, যা স্পেসে তাদের অনুমোদিত ক্রিয়াগুলি নির্ধারণ করে৷ সম্ভাব্য মান হল:
      • ROLE_MEMBER : স্থানের একজন সদস্য। ব্যবহারকারীর মৌলিক অনুমতি রয়েছে, যেমন স্পেসে বার্তা পাঠানো। 1:1 এবং নামহীন গোষ্ঠী কথোপকথনে, প্রত্যেকেরই এই ভূমিকা রয়েছে৷
      • ROLE_MANAGER : একজন স্পেস ম্যানেজার। ব্যবহারকারীর কাছে সমস্ত মৌলিক অনুমতি এবং প্রশাসনিক অনুমতি রয়েছে যা তাদের স্থান পরিচালনা করতে দেয়, যেমন সদস্য যোগ করা বা সরানো। শুধুমাত্র স্পেসগুলিতে সমর্থিত যেখানে spaceType হল SPACE (নামযুক্ত স্থান)।

একজন নিয়মিত স্পেস সদস্যকে একজন ব্যবহারকারী হিসেবে স্পেস ম্যানেজার করুন

নিম্নলিখিত উদাহরণটি ROLE_MANAGER হিসাবে role নির্দিষ্ট করে একজন নিয়মিত স্পেস সদস্যকে স্পেস ম্যানেজার করার জন্য ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে চ্যাট API-কে কল করে:

Node.js

chat/client-libraries/cloud/update-membership-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.memberships'];

// This sample shows how to update a membership with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    membership: {
      // Replace SPACE_NAME and MEMBER_NAME here
      name: 'spaces/SPACE_NAME/members/MEMBER_NAME',
      // Replace ROLE_NAME here with ROLE_MEMBER or ROLE_MANAGER
      role: 'ROLE_NAME'
    },
    updateMask: {
      // The field paths to update.
      paths: ['role']
    }
  };

  // Make the request
  const response = await chatClient.updateMembership(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • MEMBER_NAME : সদস্যতার name থেকে আইডি। আপনি ListMemberships() পদ্ধতিতে কল করে আইডি পেতে পারেন, অথবা Chat API-এর সাথে অ্যাসিঙ্ক্রোনাসভাবে সদস্যপদ তৈরি করার পরে ফিরে আসা প্রতিক্রিয়া বডি থেকে।
  • ROLE_NAME : আপডেট করা ভূমিকা, ROLE_MANAGER ।

Google Chat API একটি স্পেস ম্যানেজারের কাছে নির্দিষ্ট সদস্যপদ আপডেট করে এবং Membership একটি উদাহরণ প্রদান করে।

একজন স্পেস ম্যানেজারকে একজন ব্যবহারকারী হিসেবে নিয়মিত সদস্য করুন

নিম্নলিখিত উদাহরণটি ROLE_MEMBER হিসাবে role নির্দিষ্ট করে স্পেস ম্যানেজারকে নিয়মিত স্পেস সদস্য করার জন্য ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে চ্যাট API-কে কল করে:

Node.js

chat/client-libraries/cloud/update-membership-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.memberships'];

// This sample shows how to update a membership with user credential
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    membership: {
      // Replace SPACE_NAME and MEMBER_NAME here
      name: 'spaces/SPACE_NAME/members/MEMBER_NAME',
      // Replace ROLE_NAME here with ROLE_MEMBER or ROLE_MANAGER
      role: 'ROLE_NAME'
    },
    updateMask: {
      // The field paths to update.
      paths: ['role']
    }
  };

  // Make the request
  const response = await chatClient.updateMembership(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

নমুনা চালানোর জন্য, নিম্নলিখিত প্রতিস্থাপন করুন:

  • SPACE_NAME : স্পেসের name থেকে আইডি। আপনি ListSpaces() পদ্ধতিতে কল করে বা স্পেস এর URL থেকে আইডি পেতে পারেন।
  • MEMBER_NAME : সদস্যতার name থেকে আইডি। আপনি ListMemberships() পদ্ধতিতে কল করে আইডি পেতে পারেন, অথবা Chat API-এর সাথে অ্যাসিঙ্ক্রোনাসভাবে সদস্যপদ তৈরি করার পরে ফিরে আসা প্রতিক্রিয়া বডি থেকে।
  • ROLE_NAME : আপডেট করা ভূমিকা, ROLE_MEMBER ।

Google Chat API একটি স্পেস ম্যানেজারের কাছে নির্দিষ্ট সদস্যপদ আপডেট করে এবং Membership একটি উদাহরণ প্রদান করে।

একটি চ্যাট অ্যাপ হিসাবে একজন নিয়মিত স্পেস সদস্যকে স্পেস ম্যানেজার করুন

অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।

একটি API কী তৈরি করুন

একটি বিকাশকারী পূর্বরূপ API পদ্ধতিতে কল করতে, আপনাকে অবশ্যই API আবিষ্কার নথির একটি অ-সর্বজনীন বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে৷ অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি API কী পাস করতে হবে।

API কী তৈরি করতে, আপনার অ্যাপের Google ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

  2. শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
  3. আপনার নতুন API কী প্রদর্শিত হয়৷
    • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে কপি ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API কী" বিভাগেও পাওয়া যাবে।
    • উন্নত সেটিংস আপডেট করতে এবং আপনার API কী ব্যবহার সীমিত করতে সীমাবদ্ধ কী ক্লিক করুন। আরও বিশদ বিবরণের জন্য, API কী সীমাবদ্ধতা প্রয়োগ করা দেখুন।

একটি স্ক্রিপ্ট লিখুন যা চ্যাট API কল করে

নিম্নোক্ত উদাহরণে নিয়মিত স্পেস মেম্বারকে স্পেস ম্যানেজার বানানোর জন্য অ্যাপ প্রমাণীকরণ ব্যবহার করে চ্যাট এপিআইকে কল করা হয়েছে যা body ROLE_MANAGER হিসাবে role নির্দিষ্ট করে যা আপডেট করা সদস্যতা বৈশিষ্ট্যগুলি নির্দিষ্ট করে:

পাইথন

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

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

    from google.oauth2 import service_account
from apiclient.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.app.memberships"]

def main():
    '''
    Authenticates with Chat API using app authentication,
    then updates a specified space member to change
    it from a regular member to a space manager.
    '''

    # Specify service account details.
    creds = (
        service_account.Credentials.from_service_account_file('credentials.json')
        .with_scopes(SCOPES)
    )

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')

    # Use the service endpoint to call Chat API.
    result = chat.spaces().members().patch(

        # The membership to update, and the updated role.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBERSHIP with a membership name.
        # Obtain the membership name from the membership of Chat API.
        name='spaces/SPACE/members/MEMBERSHIP',
        updateMask='role',
        body={'role': 'ROLE_MANAGER'}

      ).execute()

    # Prints details about the updated membership.
    print(result)

if __name__ == '__main__':
    main()

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

    • API_KEY : চ্যাট API-এর জন্য পরিষেবার শেষ পয়েন্ট তৈরি করতে আপনি যে API কী তৈরি করেছেন।

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

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

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

    python3 chat_membership_update_to_manager_app.py

একটি স্পেস ম্যানেজারকে একটি চ্যাট অ্যাপ হিসাবে নিয়মিত সদস্য করুন

অ্যাপ প্রমাণীকরণের জন্য এককালীন প্রশাসকের অনুমোদন প্রয়োজন।

একটি API কী তৈরি করুন

একটি বিকাশকারী পূর্বরূপ API পদ্ধতিতে কল করতে, আপনাকে অবশ্যই API আবিষ্কার নথির একটি অ-সর্বজনীন বিকাশকারী পূর্বরূপ সংস্করণ ব্যবহার করতে হবে৷ অনুরোধটি প্রমাণীকরণ করতে, আপনাকে অবশ্যই একটি API কী পাস করতে হবে।

API কী তৈরি করতে, আপনার অ্যাপের Google ক্লাউড প্রকল্পটি খুলুন এবং নিম্নলিখিতগুলি করুন:

  1. Google ক্লাউড কনসোলে, মেনু > APIs & Services > Credentials- এ যান।

    শংসাপত্রে যান

  2. শংসাপত্র তৈরি করুন > API কী ক্লিক করুন।
  3. আপনার নতুন API কী প্রদর্শিত হয়৷
    • আপনার অ্যাপের কোডে ব্যবহারের জন্য আপনার API কী কপি করতে কপি ক্লিক করুন। API কীটি আপনার প্রকল্পের শংসাপত্রের "API কী" বিভাগেও পাওয়া যাবে।
    • উন্নত সেটিংস আপডেট করতে এবং আপনার API কী ব্যবহার সীমিত করতে সীমাবদ্ধ কী ক্লিক করুন। আরও বিশদ বিবরণের জন্য, API কী সীমাবদ্ধতা প্রয়োগ করা দেখুন।

একটি স্ক্রিপ্ট লিখুন যা চ্যাট API কল করে

নিম্নলিখিত উদাহরণে স্পেস ম্যানেজারকে নিয়মিত স্পেস মেম্বার করার জন্য অ্যাপ প্রমাণীকরণ ব্যবহার করে চ্যাট এপিআইকে কল করা হয়েছে যা ROLE_MEMBER হিসাবে role নির্দিষ্ট করে body আপডেট করা সদস্যতা বৈশিষ্ট্যগুলি নির্দিষ্ট করে:

পাইথন

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

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

    from google.oauth2 import service_account
from apiclient.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.app.memberships"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then updates a specified space member to change
    it from a regular member to a space manager.
    '''

    # Specify service account details.
    creds = (
        service_account.Credentials.from_service_account_file('credentials.json')
        .with_scopes(SCOPES)
    )

    # Build a service endpoint for Chat API.
    chat = build('chat', 'v1', credentials=creds, discoveryServiceUrl='https://chat.googleapis.com/$discovery/rest?version=v1&labels=DEVELOPER_PREVIEW&key=API_KEY')

    # Use the service endpoint to call Chat API.
    result = chat.spaces().members().patch(

        # The membership to update, and the updated role.
        #
        # Replace SPACE with a space name.
        # Obtain the space name from the spaces resource of Chat API,
        # or from a space's URL.
        #
        # Replace MEMBERSHIP with a membership name.
        # Obtain the membership name from the membership of Chat API.
        name='spaces/SPACE/members/MEMBERSHIP',
        updateMask='role',
        body={'role': 'ROLE_MEMBER'}

      ).execute()

    # Prints details about the updated membership.
    print(result)

if __name__ == '__main__':
    main()

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

    • API_KEY : চ্যাট API-এর জন্য পরিষেবার শেষ পয়েন্ট তৈরি করতে আপনি যে API কী তৈরি করেছেন।

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

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

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

    python3 chat_membership_update_to_member_app.py

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

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনও স্পেসের মেম্বারশিপ আপডেট করতে update() পদ্ধতিতে কল করতে পারেন।

এই পদ্ধতিটিকে Google Workspace অ্যাডমিনিস্ট্রেটর হিসাবে কল করতে, নিম্নলিখিতগুলি করুন:

  • ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে পদ্ধতিতে কল করুন এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের বিশেষাধিকার ব্যবহার করে পদ্ধতিটিকে কল করা সমর্থন করে।
  • আপনার অনুরোধে, true ক্যোয়ারী প্যারামিটার useAdminAccess নির্দিষ্ট করুন।

আরও তথ্য এবং উদাহরণের জন্য, Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে Google Chat স্পেস পরিচালনা করুন দেখুন।