একটি স্থান আপডেট করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে একটি স্পেস আপডেট করতে Google Chat API-এর Space রিসোর্সে patch() পদ্ধতি ব্যবহার করতে হয়। একটি স্পেস সম্পর্কে বৈশিষ্ট্য পরিবর্তন করতে একটি স্থান আপডেট করুন, যেমন তার ব্যবহারকারী-দৃশ্যমান প্রদর্শন নাম, বিবরণ এবং নির্দেশিকা।

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

Space রিসোর্স এমন একটি জায়গাকে প্রতিনিধিত্ব করে যেখানে লোকেরা এবং চ্যাট অ্যাপ মেসেজ পাঠাতে, ফাইল শেয়ার করতে এবং সহযোগিতা করতে পারে। বিভিন্ন ধরনের স্পেস আছে:

  • ডাইরেক্ট মেসেজ (DMs) হল দুই ব্যবহারকারী বা একজন ব্যবহারকারী এবং একটি চ্যাট অ্যাপের মধ্যে কথোপকথন।
  • গ্রুপ চ্যাট হল তিন বা ততোধিক ব্যবহারকারী এবং চ্যাট অ্যাপের মধ্যে কথোপকথন।
  • নামযুক্ত স্থানগুলি স্থায়ী স্থান যেখানে লোকেরা বার্তা পাঠায়, ফাইলগুলি ভাগ করে এবং সহযোগিতা করে৷

পূর্বশর্ত

পাইথন

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

Node.js

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

একটি স্থান আপডেট করুন

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

  • chat.spaces অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • Space রিসোর্সে patch() পদ্ধতিতে কল করুন। আপনার অনুরোধে, আপনি স্পেস name ক্ষেত্র, আপডেট করার জন্য এক বা একাধিক ক্ষেত্র সহ updateMask ক্ষেত্র এবং আপডেট করা স্থান তথ্য সহ একটি body নির্দিষ্ট করুন।

আপনি প্রদর্শনের নাম, স্থানের ধরন, ইতিহাসের অবস্থা এবং আরও অনেক কিছু আপডেট করতে পারেন। আপনি আপডেট করতে পারেন এমন সমস্ত ক্ষেত্র দেখতে, রেফারেন্স ডকুমেন্টেশন দেখুন।

বিদ্যমান স্থানের spaceDetails ক্ষেত্রটি কীভাবে আপডেট করবেন তা এখানে রয়েছে:

পাইথন

  1. আপনার কাজের ডিরেক্টরিতে, chat_space_update.py নামে একটি ফাইল তৈরি করুন।
  2. chat_space_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.spaces"]
    
    def main():
        '''
        Authenticates with Chat API via user credentials,
        then updates the specified space description and guidelines.
        '''
    
        # 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.spaces().patch(
    
          # The space to update, and the updated space details.
          #
          # Replace {space} with a space name.
          # Obtain the space name from the spaces resource of Chat API,
          # or from a space's URL.
          name='spaces/SPACE',
          updateMask='spaceDetails',
          body={
    
            'spaceDetails': {
              'description': 'This description was updated with Chat API!',
              'guidelines': 'These guidelines were updated with Chat API!'
            }
    
          }
    
        ).execute()
    
        # Prints details about the updated space.
        print(result)
    
    if __name__ == '__main__':
        main()
    
  3. কোডে, একটি স্পেস নাম দিয়ে SPACE প্রতিস্থাপন করুন, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্পেস এর URL থেকে পেতে পারেন।

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

    python3 chat_space_update.py

Node.js

  1. আপনার কাজের ডিরেক্টরিতে, update-space.js নামে একটি ফাইল তৈরি করুন।
  2. update-space.js এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

    const chat = require('@googleapis/chat');
    const {authenticate} = require('@google-cloud/local-auth');
    
    /**
    * Updates a Chat space with the description and guidelines.
    * @return {!Promise<!Object>}
    */
    async function updateSpace() {
      const scopes = [
        'https://www.googleapis.com/auth/chat.spaces',
      ];
    
      const authClient =
          await authenticate({scopes, keyfilePath: 'client_secrets.json'});
    
      const chatClient = await chat.chat({version: 'v1', auth: authClient});
    
      return await chatClient.spaces.patch({
        name: 'spaces/SPACE',
        updateMask: 'spaceDetails',
        requestBody: {
          spaceDetails: {
            description: 'This description was updated with Chat API!',
            guidelines: 'These guidelines were updated with Chat API!'
          },
        }
      });
    }
    
    updateSpace().then(console.log);
    
  3. কোডে, একটি স্পেস নাম দিয়ে SPACE প্রতিস্থাপন করুন, যা আপনি Chat API-এর spaces.list পদ্ধতি থেকে বা একটি স্পেস এর URL থেকে পেতে পারেন।

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

    node update-space.js

Google Chat API Space রিসোর্সের একটি উদাহরণ প্রদান করে যা আপডেটগুলিকে প্রতিফলিত করে।

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

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

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

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

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