Method: users.list

বর্তমান ব্যবহারকারীর কাছে অ্যাক্সেসযোগ্য ব্যবহারকারীদের তালিকা করে। যদি একই অংশীদার বা বিজ্ঞাপনদাতার উপর দুই ব্যবহারকারীর ব্যবহারকারীর ভূমিকা থাকে, তাহলে তারা একে অপরকে অ্যাক্সেস করতে পারবে।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v1beta2/users

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

ক্যোয়ারী প্যারামিটার

পরামিতি
pageSize

integer

অনুরোধ পৃষ্ঠা আকার. 1 থেকে 100 এর মধ্যে হতে হবে। অনির্দিষ্ট হলে 100 ডিফল্ট হবে।

pageToken

string

একটি টোকেন ফলাফলের একটি পৃষ্ঠা চিহ্নিত করে যা সার্ভারের ফিরে আসা উচিত। সাধারণত, এটি users.list পদ্ধতিতে আগের কল থেকে ফেরত nextPageToken মান। নির্দিষ্ট না থাকলে, ফলাফলের প্রথম পৃষ্ঠাটি ফেরত দেওয়া হবে।

orderBy

string

ক্ষেত্র যা দ্বারা তালিকা বাছাই. গ্রহণযোগ্য মান হল:

  • displayName (ডিফল্ট)

ডিফল্ট সাজানোর ক্রম ক্রমবর্ধমান। একটি ক্ষেত্রের জন্য অবরোহ ক্রম নির্দিষ্ট করতে, ক্ষেত্রের নামের সাথে একটি প্রত্যয় "ডেস্ক" যোগ করা উচিত। উদাহরণস্বরূপ, displayName desc ।

filter

string

ব্যবহারকারীর বৈশিষ্ট্য দ্বারা ফিল্টার করার অনুমতি দেয়।

সমর্থিত সিনট্যাক্স:

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা নিয়ে গঠিত।
  • লজিক্যাল অপারেটর AND দ্বারা সীমাবদ্ধতা একত্রিত করা যেতে পারে।
  • একটি সীমাবদ্ধতার ফর্ম আছে {field} {operator} {value} ।
  • অপারেটর অবশ্যই CONTAINS (:) বা EQUALS (=) হতে হবে।
  • নিম্নলিখিত ক্ষেত্রগুলির জন্য অপারেটর অবশ্যই CONTAINS (:) হতে হবে:
    • displayName
    • email
  • নিম্নলিখিত ক্ষেত্রগুলির জন্য অপারেটরকে অবশ্যই EQUALS (=) হতে হবে:
    • assignedUserRole.userRole
    • assignedUserRole.partnerId
    • assignedUserRole.advertiserId
    • assignedUserRole.entityType : AssignedUserRole এর একটি সিন্থেটিক ক্ষেত্র যা ফিল্টারিংয়ের জন্য ব্যবহৃত হয়। ব্যবহারকারীর ভূমিকা বরাদ্দ করা হয় এমন সত্তার ধরন সনাক্ত করে। বৈধ মান হল Partner এবং Advertiser ৷
    • assignedUserRole.parentPartnerId : AssignedUserRole এর একটি সিন্থেটিক ক্ষেত্র যা ফিল্টারিংয়ের জন্য ব্যবহৃত হয়। যে সত্তাকে ব্যবহারকারীর ভূমিকা বরাদ্দ করা হয়েছে তার মূল অংশীদারকে সনাক্ত করে৷"

উদাহরণ:

  • ডিসপ্লেনাম সহ ব্যবহারকারীর মধ্যে foo : displayName:"foo" রয়েছে
  • bar ধারণকারী ইমেল ব্যবহারকারী: email:"bar"
  • স্ট্যান্ডার্ড ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: assignedUserRole.userRole="STANDARD"
  • অংশীদার 123 এর জন্য ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: assignedUserRole.partnerId="123"
  • বিজ্ঞাপনদাতা 123-এর জন্য ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: assignedUserRole.advertiserId="123"
  • অংশীদার স্তরের ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: entityType="PARTNER"
  • অংশীদার 123 এর জন্য ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী এবং অংশীদার 123 এর অধীনে বিজ্ঞাপনদাতারা: parentPartnerId="123"

এই ক্ষেত্রের দৈর্ঘ্য 500 অক্ষরের বেশি হওয়া উচিত নয়।

শরীরের অনুরোধ

অনুরোধের বডি খালি হতে হবে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "users": [
    {
      object (User)
    }
  ],
  "nextPageToken": string
}
ক্ষেত্র
users[]

object ( User )

ব্যবহারকারীদের তালিকা.

এই তালিকাটি খালি থাকলে অনুপস্থিত থাকবে।

nextPageToken

string

ফলাফলের পরবর্তী পৃষ্ঠা পুনরুদ্ধার করার জন্য একটি টোকেন। ফলাফলের পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে users.list পদ্ধতিতে পরবর্তী কলে pageToken ক্ষেত্রে এই মানটি পাস করুন। এই টোকেনটি অনুপস্থিত থাকবে যদি ফেরার জন্য আর কোন ফলাফল না থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/display-video-user-management

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।