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

এই নির্দেশিকায় ব্যাখ্যা করা হয়েছে কীভাবে গুগল চ্যাট এপিআই-এর Membership রিসোর্সের update() মেথড ব্যবহার করে কোনো মেম্বারশিপের অ্যাট্রিবিউট পরিবর্তন করা যায়, যেমন—একজন স্পেস মেম্বারকে স্পেস ম্যানেজার বা স্পেস ওনারে পরিবর্তন করা।

আপনি যদি একজন গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের যেকোনো স্পেসের মেম্বারশিপ আপডেট করার জন্য update() মেথডটি কল করতে পারেন।

Membership রিসোর্সটি নির্দেশ করে যে কোনো মানব ব্যবহারকারী বা গুগল চ্যাট অ্যাপ কোনো স্পেসে আমন্ত্রিত, তার অংশ, নাকি অনুপস্থিত।

পূর্বশর্ত

নোড.জেএস

সদস্যপদ হালনাগাদ করুন

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

  • অনুমোদনের পরিধি নির্দিষ্ট করুন:
  • UpdateMembership() মেথডটি কল করুন।
  • নিম্নলিখিত বিষয়গুলো সহ Membership এর একটি ইনস্ট্যান্স হিসেবে membership পাস করুন:
    • আপডেট করার জন্য name ফিল্ডটিতে সদস্যপদটি সেট করা হয়েছে, যার মধ্যে একটি স্পেস আইডি এবং একটি মেম্বার আইডি অন্তর্ভুক্ত রয়েছে।
    • আপডেট করার জন্য সদস্যপদ ফিল্ডগুলো নতুন মানগুলিতে সেট করা হয়েছে।
  • মেম্বারশিপের যে দিকগুলো আপডেট করতে চান, তা নির্দিষ্ট করার জন্য updateMask পাস করুন, এর মধ্যে নিম্নলিখিত বিষয়গুলো অন্তর্ভুক্ত রয়েছে:
    • role : একটি চ্যাট স্পেসের মধ্যে ব্যবহারকারীর ভূমিকা, যা সেই স্পেসে তার অনুমোদিত কার্যকলাপ নির্ধারণ করে। অনুমতির বিস্তারিত ব্যাখ্যার জন্য, চ্যাট এপিআই রেফারেন্স ডকুমেন্টেশনে MembershipRole দেখুন। সম্ভাব্য মানগুলো হলো:
      • ROLE_MEMBER : এই স্পেসের একজন সদস্য। চ্যাট UI-তে এই রোলটিকে Member বলা হয়।
      • ROLE_ASSISTANT_MANAGER : একজন স্পেস ম্যানেজার। চ্যাট UI-তে এই রোলটিকে ম্যানেজার বলা হয়।
      • ROLE_MANAGER : একজন স্পেসের মালিক। চ্যাট UI-তে এই রোলটিকে Owner বলা হয়।

একজন সদস্যকে মালিক হিসেবে পরিবর্তন করুন (ব্যবহারকারীর প্রমাণীকরণ)

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

নোড.জেএস

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);
}

await main();

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

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

গুগল চ্যাট এপিআই নির্দিষ্ট মেম্বারশিপটিকে একজন স্পেস ওনার হিসেবে আপডেট করে এবং Membership এর একটি ইনস্ট্যান্স রিটার্ন করে।

মালিককে সদস্যে পরিবর্তন করুন (ব্যবহারকারীর প্রমাণীকরণ)

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

নোড.জেএস

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);
}

await main();

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

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

গুগল চ্যাট এপিআই নির্দিষ্ট মেম্বারশিপটিকে একজন স্পেস ওনার হিসেবে আপডেট করে এবং Membership এর একটি ইনস্ট্যান্স রিটার্ন করে।

একজন সদস্যকে মালিক হিসেবে পরিবর্তন করুন (চ্যাট অ্যাপ প্রমাণীকরণ)

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

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

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

পাইথন

  1. আপনার ওয়ার্কিং ডিরেক্টরিতে chat_membership_update_to_owner_app.py নামে একটি ফাইল তৈরি করুন।
  2. chat_membership_update_to_owner_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 owner.
        '''
    
        # 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)
    
        # 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',
    
            # Replace ROLE with a MembershipRole value.
            # Obtain the MembershipRole values from the membership of Chat API.
            body={'role': 'ROLE'}
    
          ).execute()
    
        # Prints details about the updated membership.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. কোডে নিম্নলিখিতটি প্রতিস্থাপন করুন:

    • SPACE : একটি স্পেসের নাম, যা আপনি চ্যাট এপিআই-এর spaces.list মেথড থেকে অথবা কোনো স্পেসের ইউআরএল থেকে পেতে পারেন।

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

    • ROLE : হালনাগাদকৃত ভূমিকা, ROLE_MANAGER । আপনি এই মানটি MembershipRole এর যেকোনো মানে সেট করতে পারেন। উদাহরণস্বরূপ, সাধারণ সদস্যকে স্পেস ম্যানেজার বানাতে, ROLE পরিবর্তন করে ROLE_ASSISTANT_MANAGER করুন।

  4. আপনার ওয়ার্কিং ডিরেক্টরিতে, স্যাম্পলটি বিল্ড ও রান করুন:

    python3 chat_membership_update_to_owner_app.py

মালিককে সদস্যে পরিবর্তন করুন (চ্যাট অ্যাপ প্রমাণীকরণ)

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

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

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

পাইথন

  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 owner to change
        it to a regular member.
        '''
    
        # 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)
    
        # 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. কোডে নিম্নলিখিতটি প্রতিস্থাপন করুন:

    • SPACE : একটি স্পেসের নাম, যা আপনি চ্যাট এপিআই-এর spaces.list মেথড থেকে অথবা কোনো স্পেসের ইউআরএল থেকে পেতে পারেন।

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

  4. আপনার ওয়ার্কিং ডিরেক্টরিতে, স্যাম্পলটি বিল্ড ও রান করুন:

    python3 chat_membership_update_to_member_app.py

Google Workspace প্রশাসক হিসেবে সদস্যপদগুলি আপডেট করুন

আপনি যদি একজন গুগল ওয়ার্কস্পেস অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনার গুগল ওয়ার্কস্পেস অর্গানাইজেশনের যেকোনো স্পেসের মেম্বারশিপ আপডেট করার জন্য update() মেথডটি কল করতে পারেন।

গুগল ওয়ার্কস্পেস প্রশাসক হিসেবে এই পদ্ধতিটি কল করতে, নিম্নলিখিতগুলি করুন:

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

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