প্রাথমিক সদস্যদের সাথে একটি স্থান সেট আপ করুন

এই গাইডটি ব্যাখ্যা করে যে কিভাবে একটি Google Chat স্পেস সেট আপ করতে Google Chat API এর Space রিসোর্সে setup পদ্ধতি ব্যবহার করতে হয়। একটি স্থান সেট আপ করা একটি স্থান তৈরি করে এবং এটিতে নির্দিষ্ট ব্যবহারকারীদের যোগ করে।

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

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

একটি স্থান সেট আপ করার সময়, নিম্নলিখিত বিবেচনা করুন:

  • কলিং (প্রমাণিত) ব্যবহারকারী স্বয়ংক্রিয়ভাবে স্পেসে যুক্ত হয়, তাই আপনাকে অনুরোধে ব্যবহারকারীর সদস্যতা নির্দিষ্ট করতে হবে না।
  • একটি সরাসরি বার্তা (DM) তৈরি করার সময়, যদি দুটি ব্যবহারকারীর মধ্যে একটি DM বিদ্যমান থাকে, তাহলে DM ফেরত দেওয়া হয়। অন্যথায়, একটি DM তৈরি করা হয়।
  • একটি গ্রুপ চ্যাট তৈরি করার সময়, যদি অনুরোধে প্রদত্ত সদস্যতাগুলির একটিও সফলভাবে গ্রুপ চ্যাটে যোগ করা না হয় (উদাহরণস্বরূপ, অনুমতির সমস্যা), তাহলে একটি খালি গ্রুপ চ্যাট (শুধুমাত্র কলিং ব্যবহারকারী সহ) তৈরি হতে পারে।
  • আপনি থ্রেড করা উত্তর দিয়ে স্পেস সেট-আপ করতে পারবেন না বা আপনার Google Workspace-এর বাইরের লোকদের যোগ করতে পারবেন না।
  • অনুরোধে প্রদত্ত ডুপ্লিকেট সদস্যতা (কলিং ব্যবহারকারী সহ) অনুরোধ ত্রুটির পরিবর্তে ফিল্টার আউট করা হয়।

পূর্বশর্ত

পাইথন

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

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

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

  • চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে। একটি স্থান সেট আপ করার জন্য chat.spaces.create বা chat.spaces অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।

Node.js

  • Node.js এবং npm

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

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

  • চ্যাট অ্যাপের জন্য অনুমোদন কনফিগার করা হয়েছে। একটি স্থান তৈরি করতে chat.spaces.create বা chat.spaces অনুমোদনের সুযোগের সাথে ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন।

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

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

  • chat.spaces.create বা chat.spaces অনুমোদনের সুযোগ নির্দিষ্ট করুন।
  • Space রিসোর্সে setup পদ্ধতিতে কল করুন।
  • একজন মানুষের ব্যবহারকারীকে স্পেস মেম্বার হিসেবে যোগ করতে, users/{user} নির্দিষ্ট করুন, যেখানে {user} হয় People API-এর person জন্য {person_id} , অথবা ডিরেক্টরি API-তে user আইডি। উদাহরণস্বরূপ, যদি People API person resourceName হয় people/123456789 , তাহলে আপনি users/123456789 এর সাথে member.name হিসাবে একটি সদস্যপদ অন্তর্ভুক্ত করে স্পেসে ব্যবহারকারীকে যুক্ত করতে পারেন।
  • কলিং ব্যবহারকারী এবং অন্য মানব ব্যবহারকারীর মধ্যে একটি DM তৈরি করতে, আপনার অনুরোধে মানব ব্যবহারকারীর সদস্যতা নির্দিষ্ট করুন।
  • কলিং ব্যবহারকারী এবং কলিং অ্যাপের মধ্যে একটি DM তৈরি করতে, Space.singleUserBotDm true সেট করুন এবং কোনো সদস্যতা নির্দিষ্ট করবেন না। আপনি শুধুমাত্র কলিং অ্যাপের সাথে একটি DM সেট আপ করতে এই পদ্ধতিটি ব্যবহার করতে পারেন৷ কলিং অ্যাপটিকে একটি স্পেসের সদস্য বা দুটি মানব ব্যবহারকারীর মধ্যে বিদ্যমান DM হিসাবে যোগ করতে, একটি সদস্যতা তৈরি করুন দেখুন।

নিম্নলিখিত উদাহরণটি একটি নামযুক্ত স্থান তৈরি করে এবং তিনজন মানব ব্যবহারকারী, প্রমাণীকৃত ব্যবহারকারী এবং অন্য দুটি নির্দিষ্ট ব্যবহারকারীর জন্য স্থানের সদস্যপদ তৈরি করে:

পাইথন

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

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

def main():
    '''
    Authenticates with Chat API via user credentials,
    then sets up a Chat space by creating a space and adding members.
    '''

    # 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().setup(

      # Details about the space to set up.
      body = {

        # Attributes of the space to set up, like space type and display name.
        'space': {

            # To set up a named space, set spaceType to SPACE.
            'spaceType': 'SPACE',

            # The user-visible name of the space
            'displayName': 'API-setup'
        },

        # The people and app to add to the space.
        #
        # The authenticated user is automatically added to the space,
        # and doesn't need to be specified in the memberships array.
        'memberships': [
            {
              'member': {
                'name':'users/123456789',
                'type': 'HUMAN'
              }
            },
            {
              'member': {
                'name':'users/987654321',
                'type': 'HUMAN'
              }
            }
        ]
      }

      ).execute()

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

if __name__ == '__main__':
    main()

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

    python3 chat_space_setup.py

Node.js

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

  2. setup-space.js এ নিম্নলিখিত কোডটি অন্তর্ভুক্ত করুন:

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

/**
* Sets up a new Chat space with users.
* @return {!Promise<!Object>}
*/
async function setupSpace() {
  const scopes = [
    'https://www.googleapis.com/auth/chat.spaces.create',
  ];

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

  const chatClient = await chat.chat({version: 'v1', auth: authClient});

  return await chatClient.spaces.setup({
    requestBody: {
      space: {
        spaceType: 'SPACE',
        displayName: 'API-made',
      },
      memberships: [
        {member: {name: 'users/123456789', type: 'HUMAN'}},
        {member: {name: 'users/987654321', type: 'HUMAN'}},
      ]
    }
  });
}

setupSpace().then(console.log);

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

    node setup-space.js

প্রমাণীকৃত ব্যবহারকারী সহ তিনজন মানব ব্যবহারকারীর সাথে একটি নামযুক্ত চ্যাট স্পেস সেট আপ করা হয়েছে।

স্পেসে যেতে, স্পেসের ইউআরএল তৈরি করতে স্পেসের রিসোর্স আইডি ব্যবহার করুন। আপনি Google Chat রেসপন্স বডিতে স্পেস name থেকে রিসোর্স আইডি পেতে পারেন। উদাহরণস্বরূপ, যদি আপনার স্থানের name হয় spaces/1234567 , তাহলে আপনি নিম্নলিখিত URL ব্যবহার করে স্পেসটিতে যেতে পারেন: https://mail.google.com/chat/u/0/#chat/space/1234567 ।