Method: users.list

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

এই পদ্ধতিতে অনন্য প্রমাণীকরণের প্রয়োজনীয়তা রয়েছে। এই পদ্ধতিটি ব্যবহার করার আগে আমাদের ব্যবস্থাপনা ব্যবহারকারী নির্দেশিকাতে পূর্বশর্তগুলি পড়ুন।

"এই পদ্ধতিটি চেষ্টা করুন" বৈশিষ্ট্যটি এই পদ্ধতির জন্য কাজ করে না।

HTTP অনুরোধ

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

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

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

পরামিতি
pageSize

integer

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

pageToken

string

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

orderBy

string

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

  • displayName (ডিফল্ট)

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

filter

string

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

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

  • ফিল্টার এক্সপ্রেশন এক বা একাধিক সীমাবদ্ধতা নিয়ে গঠিত।
  • লজিক্যাল অপারেটর AND দ্বারা সীমাবদ্ধতা একত্রিত করা যেতে পারে।
  • একটি সীমাবদ্ধতার ফর্ম আছে {field} {operator} {value} ।
  • displayName এবং email ক্ষেত্রগুলি অবশ্যই HAS (:) অপারেটর ব্যবহার করবে৷
  • lastLoginTime ক্ষেত্রটি অবশ্যই LESS THAN OR EQUAL TO (<=) বা GREATER THAN OR EQUAL TO (>=) অপারেটর ব্যবহার করতে হবে।
  • অন্য সব ক্ষেত্র অবশ্যই EQUALS (=) অপারেটর ব্যবহার করতে হবে।

সমর্থিত ক্ষেত্র:

  • assignedUserRole.advertiserId
  • assignedUserRole.entityType : এটি AssignedUserRole এর সিন্থেটিক ক্ষেত্র যা ফিল্টারিংয়ের জন্য ব্যবহৃত হয়। ব্যবহারকারীর ভূমিকা বরাদ্দ করা হয় এমন সত্তার ধরন সনাক্ত করে। বৈধ মান হল Partner এবং Advertiser ৷
  • assignedUserRole.parentPartnerId : এটি AssignedUserRole এর একটি সিন্থেটিক ক্ষেত্র যা ফিল্টারিংয়ের জন্য ব্যবহৃত হয়। সত্তার মূল অংশীদারকে সনাক্ত করে যাকে ব্যবহারকারীর ভূমিকা বরাদ্দ করা হয়েছে৷
  • assignedUserRole.partnerId
  • assignedUserRole.userRole
  • displayName
  • email
  • lastLoginTime (ISO 8601 ফর্ম্যাটে ইনপুট, বা YYYY-MM-DDTHH:MM:SSZ )

উদাহরণ:

  • displayName সহ ব্যবহারকারী যার মধ্যে "foo" রয়েছে: displayName:"foo"
  • "বার" ধারণকারী email সহ ব্যবহারকারী: email:"bar"
  • স্ট্যান্ডার্ড ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: assignedUserRole.userRole="STANDARD"
  • অংশীদার 123 এর জন্য ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: assignedUserRole.partnerId="123"
  • বিজ্ঞাপনদাতা 123-এর জন্য ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: assignedUserRole.advertiserId="123"
  • অংশীদার স্তরের ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী: entityType="PARTNER"
  • অংশীদার 123 এর জন্য ব্যবহারকারীর ভূমিকা সহ সমস্ত ব্যবহারকারী এবং অংশীদার 123 এর অধীনে বিজ্ঞাপনদাতারা: parentPartnerId="123"
  • 2023-01-01T00:00:00Z (ISO 8601 ফরম্যাট): lastLoginTime>="2023-01-01T00:00:00Z" এ বা তার পরে শেষবার লগ ইন করা সমস্ত ব্যবহারকারী

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

আরো তথ্যের জন্য আমাদের ফিল্টার LIST অনুরোধ নির্দেশিকা উল্লেখ করুন.

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

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

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

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

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 ওভারভিউ দেখুন।