একটি স্থান তৈরি করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে Google Chat API এর Space রিসোর্সে একটি নামযুক্ত স্থান তৈরি করতে কীভাবে create পদ্ধতি ব্যবহার করতে হয়।

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

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

একটি নামযুক্ত স্থান হল এমন একটি স্থান যেখানে লোকেরা বার্তা পাঠায়, ফাইল শেয়ার করে এবং সহযোগিতা করে। নামযুক্ত স্পেসগুলিতে চ্যাট অ্যাপ অন্তর্ভুক্ত থাকতে পারে। নামযুক্ত স্পেসগুলিতে অতিরিক্ত বৈশিষ্ট্য রয়েছে যা নামবিহীন গোষ্ঠী কথোপকথন এবং সরাসরি বার্তাগুলিতে থাকে না, যেমন স্পেস ম্যানেজার যারা প্রশাসনিক সেটিংস, বিবরণ প্রয়োগ করতে এবং লোক এবং অ্যাপগুলিকে যুক্ত বা সরাতে পারেন৷ একটি নামযুক্ত স্থান তৈরি করার পরে, স্থানের একমাত্র সদস্য প্রমাণীকৃত ব্যবহারকারী। স্থান অন্যান্য ব্যক্তি বা অ্যাপ্লিকেশন অন্তর্ভুক্ত করে না; এমনকি চ্যাট অ্যাপটিও নয় যা এটি তৈরি করে। লোকেদের যোগ করতে, Member রিসোর্সে create পদ্ধতিতে কল করে স্পেসে সদস্যপদ তৈরি করুন। কিভাবে জানতে, একটি সদস্যপদ তৈরি করুন দেখুন।

একাধিক সদস্যের সাথে একটি নামযুক্ত স্থান তৈরি করতে—তিন বা ততোধিক লোকের মধ্যে একটি নামবিহীন গ্রুপ চ্যাট, বা দু'জনের মধ্যে সরাসরি বার্তা কথোপকথন, বা একজন ব্যক্তি এবং চ্যাট অ্যাপ যা চ্যাট এপিআইকে কল করছে— পরিবর্তে একটি স্পেস সেট আপ করুন ৷

পূর্বশর্ত

পাইথন

  • পাইথন 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 রিসোর্সে create পদ্ধতিতে কল করুন।
  • spaceType SPACE এ সেট করুন।
  • স্পেসের ব্যবহারকারী-দৃশ্যমান নামের জন্য displayName সেট করুন। নিম্নলিখিত উদাহরণে, displayName API-made সেট করা হয়েছে।
  • ঐচ্ছিকভাবে, অন্যান্য স্থান বৈশিষ্ট্যগুলি সেট করুন, যেমন spaceDetails (একটি ব্যবহারকারী-দৃশ্যমান বিবরণ এবং স্থানের জন্য নির্দেশিকাগুলির সেট)।

একটি নামযুক্ত স্থান কীভাবে তৈরি করবেন তা এখানে:

পাইথন

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

  2. chat_space_create_named.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 creates a Chat space.
    '''

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

      # Details about the space to create.
      body = {

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

        # The user-visible name of the space.
        'displayName': 'API-made'
      }

      ).execute()

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

if __name__ == '__main__':
    main()

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

    python3 chat_space_create_named.py

Node.js

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

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

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

/**
* Creates a new chat space.
* @return {!Promise<!Object>}
*/
async function createSpace() {
  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.create(
      {requestBody: {spaceType: 'SPACE', displayName: 'API-made'}});
}

createSpace().then(console.log);

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

    node create-space.js

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