Method: users.list

বর্তমান ব্যবহারকারীর অ্যাক্সেস আছে এমন ব্যবহারকারীদের তালিকা দেখায়। একই পার্টনার বা বিজ্ঞাপনদাতার ক্ষেত্রে দু'জন ব্যবহারকারীর ভূমিকা থাকলে, তারা একে অপরের অ্যাক্সেস করতে পারবেন।

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

"এই পদ্ধতি ব্যবহার করে দেখুন" ফিচারটি এই পদ্ধতির জন্য কাজ করে না।

HTTP অনুরোধ

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

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

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

প্যারামিটারগুলি
pageSize

integer

অনুরোধ করা পৃষ্ঠার সাইজ। 1 থেকে 200-এর মধ্যে হতে হবে। উল্লেখ না করা থাকলে, ডিফল্ট হিসেবে 100 হবে।
pageToken

string

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

string

যে ফিল্ড অনুযায়ী তালিকা সাজানো হবে। গ্রহণযোগ্য ভ্যালু হল:

  • displayName (ডিফল্ট)

ক্রমানুসারে সাজানোর ডিফল্ট সেটিংস হল ছোট থেকে বড়। কোনও ফিল্ডের জন্য নিম্নক্রম নির্দিষ্ট করতে, ফিল্ডের নামের শেষে "desc" যোগ করতে হবে। যেমন, 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)

উদাহরণ:

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

এই ফিল্ডে ৫০০টির বেশি অক্ষর লেখা যাবে না।

আরও তথ্যের জন্য আমাদের ফিল্টার 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 Overview দেখুন।