একটি স্পেসে সদস্যদের তালিকা করুন

এই গাইডটি ব্যাখ্যা করে যে কীভাবে Google Chat API-এর membership সংস্থানে list() পদ্ধতি ব্যবহার করে একটি স্পেসে মেম্বারশিপের পেজিনেটেড, ফিল্টারযোগ্য তালিকা হিসেবে মেম্বারদের তালিকাভুক্ত করতে হয়।

  • অ্যাপ প্রমাণীকরণের মাধ্যমে মেম্বারশিপ তালিকাভুক্ত করা হলে Chat অ্যাপের অ্যাক্সেস আছে এমন জায়গায় মেম্বারশিপ তালিকাভুক্ত করা হয়, কিন্তু Chat অ্যাপ মেম্বারশিপ বাদ দেওয়া হয়, যার মধ্যে নিজস্ব।
  • ব্যবহারকারীর প্রমাণীকরণের সাথে সদস্যতা তালিকাভুক্ত করা স্পেসগুলিতে সদস্যপদগুলিকে তালিকাভুক্ত করে যেখানে প্রমাণীকৃত ব্যবহারকারীর অ্যাক্সেস রয়েছে৷
  • অ্যাডমিনিস্ট্রেটর বিশেষাধিকার ব্যবহার করে ব্যবহারকারীর প্রমাণীকরণ সহ Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে মেম্বারশিপের তালিকা করা আপনার Google Workspace সংস্থার সমস্ত স্পেসে মেম্বারশিপ তালিকাভুক্ত করে।

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

পূর্বশর্ত

পাইথন

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

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

প্রমাণীকৃত ব্যবহারকারীর অ্যাক্সেস আছে এমন জায়গায় ব্যবহারকারী, Google গ্রুপ এবং চ্যাট অ্যাপ তালিকাভুক্ত করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

নিম্নলিখিত উদাহরণে প্রমাণীকৃত ব্যবহারকারীর কাছে দৃশ্যমান Google গ্রুপ, মানব এবং অ্যাপ সদস্যদের তালিকা রয়েছে।

পাইথন

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

  2. chat_member_list_user.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.memberships.readonly"]

def main():
    '''
    Authenticates with Chat API via user credentials,
    then lists Google Group, human, and app members in a specified 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().members().list(

        # The space for which to list memberships.
        parent = 'spaces/SPACE',

        # Set this parameter to list Google Groups.
        showGroups = 'true'

    ).execute()

    # Prints the list of memberships.
    print(result)

if __name__ == '__main__':
    main()

  3. কোডে, একটি স্পেস নাম দিয়ে SPACE প্রতিস্থাপন করুন, যা আপনি Chat API-এর spaces.list() পদ্ধতি থেকে বা একটি স্পেস এর URL থেকে পেতে পারেন।

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

    python3 chat_member_list_user.py

Google Chat API নির্দিষ্ট স্থান থেকে Google গ্রুপ, মানব এবং অ্যাপ সদস্যদের একটি তালিকা প্রদান করে।

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

প্রমাণীকৃত অ্যাপের অ্যাক্সেস আছে এমন জায়গায় ব্যবহারকারী এবং চ্যাট অ্যাপ তালিকাভুক্ত করতে, আপনার অনুরোধে নিম্নলিখিতটি পাস করুন:

নিম্নলিখিত উদাহরণে Chat অ্যাপে দৃশ্যমান মানব স্পেস সদস্যদের (স্পেস ম্যানেজার নয়) তালিকা করা হয়েছে:

পাইথন

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

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

    from google.oauth2 import service_account
from apiclient.discovery import build

# Specify required scopes.
SCOPES = ['https://www.googleapis.com/auth/chat.bot']

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

# Build the URI and authenticate with the service account.
chat = build('chat', 'v1', credentials=CREDENTIALS)

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

        # The space for which to list memberships.
        parent = 'spaces/SPACE',

        # An optional filter that returns only human space members.
        filter = 'member.type = "HUMAN" AND role = "ROLE_MEMBER"'

    ).execute()

print(result)

  3. কোডে, একটি স্পেস নাম দিয়ে SPACE প্রতিস্থাপন করুন, যা আপনি Chat API-এর spaces.list() পদ্ধতি থেকে বা একটি স্পেস এর URL থেকে পেতে পারেন।

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

    python3 chat_member_list_app.py

Google Chat API নির্দিষ্ট স্থান থেকে মানব স্পেস সদস্যদের (স্পেস ম্যানেজার ব্যতীত) একটি তালিকা প্রদান করে।

Google Workspace অ্যাডমিনিস্ট্রেটর হিসেবে মেম্বারদের তালিকা করুন

আপনি যদি একজন Google Workspace অ্যাডমিনিস্ট্রেটর হন, তাহলে আপনি আপনার Google Workspace সংস্থার যেকোনও স্পেসের মেম্বারশিপ তালিকাভুক্ত করতে list() পদ্ধতিতে কল করতে পারেন। চ্যাট এপিআই শুধুমাত্র ব্যবহারকারীদের জন্য সদস্যতা ফেরত দেয়—অভ্যন্তরীণ এবং বাহ্যিক—অথবা আপনার সংস্থার Google গোষ্ঠী, এবং তাই যেকোনো চ্যাট অ্যাপের সদস্যতা বাদ দেয়।

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

  • ব্যবহারকারীর প্রমাণীকরণ ব্যবহার করে পদ্ধতিতে কল করুন এবং একটি অনুমোদনের সুযোগ নির্দিষ্ট করুন যা প্রশাসকের বিশেষাধিকার ব্যবহার করে পদ্ধতিটিকে কল করা সমর্থন করে।
  • আপনার অনুরোধে, নিম্নলিখিত ক্যোয়ারী পরামিতিগুলি নির্দিষ্ট করুন:
    • useAdminAccess true সেট করুন।
    • শুধুমাত্র ব্যবহারকারীদের ফেরত দিতে, HUMAN এর সমান member.type এর জন্য filter সেট করুন।
    • ব্যবহারকারী এবং গোষ্ঠীগুলিকে ফেরত দিতে, member.type এর জন্য filter সেট করুন BOT AND showGroups equal to true ।

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

পৃষ্ঠা সংখ্যা কাস্টমাইজ করুন বা তালিকা ফিল্টার করুন

সদস্যতা তালিকাভুক্ত করতে, তালিকাভুক্ত সদস্যপদগুলির পৃষ্ঠা সংখ্যা বা ফিল্টার কাস্টমাইজ করতে নিম্নলিখিত ক্যোয়ারী প্যারামিটারগুলি পাস করুন:

  • pageSize : ফেরত দেওয়ার জন্য সদস্যতার সর্বোচ্চ সংখ্যা। পরিষেবাটি এই মানের থেকে কম ফেরত দিতে পারে। অনির্দিষ্ট থাকলে, সর্বাধিক 100টি স্থান ফেরত দেওয়া হয়। সর্বোচ্চ মান হল 1,000; 1,000-এর বেশি মান স্বয়ংক্রিয়ভাবে 1,000-এ পরিবর্তিত হয়।
  • pageToken : একটি পৃষ্ঠা টোকেন, পূর্ববর্তী তালিকা স্পেস কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন। পেজিনেট করার সময়, ফিল্টারের মানটি সেই কলের সাথে মেলে যা পৃষ্ঠা টোকেন প্রদান করে। একটি ভিন্ন মান পাস অপ্রত্যাশিত ফলাফল হতে পারে.
  • filter : একটি ক্যোয়ারী ফিল্টার। ব্যবহারকারীর প্রমাণীকরণ প্রয়োজন। সমর্থিত ক্যোয়ারী বিশদ বিবরণের জন্য, spaces.members.list() পদ্ধতিটি দেখুন।