Method: inventorySourceGroups.list

گروه‌های منبع موجودی را که برای کاربر فعلی قابل‌دسترسی است فهرست می‌کند.

ترتیب با پارامتر orderBy تعریف می‌شود.

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

پارامترهای پُرسمان

پارامترها
pageSize

integer

اندازه صفحه درخواست‌شده. باید بین 1 و 200 باشد. اگر مشخص نشده باشد، به‌طور پیش‌فرض روی 100 تنظیم می‌شود.
pageToken

string

نشانه‌ای که صفحه‌ای از نتایج را که سرور باید برگرداند شناسایی می‌کند. معمولاً این مقدار nextPageToken است که از تماس قبلی با روش ListInventorySources برگردانده شده است. اگر مشخص نشده باشد، اولین صفحه نتایج برگردانده خواهد شد.
orderBy

string

فیلدی که فهرست براساس آن مرتب می‌شود. مقادیر پذیرفتنی عبارت‌اند از:

  • displayName (پیش‌فرض)
  • inventorySourceGroupId

ترتیب مرتب‌سازی پیش‌فرض صعودی است. برای مشخص کردن ترتیب نزولی برای یک فیلد، باید پسوند «desc» به نام فیلد اضافه شود. به‌عنوان مثال، displayName desc.
filter

string

فیلتر کردن براساس فیلدهای گروه منبع فهرست موجودی را مجاز می‌کند.

نحو پشتیبانی‌شده:

  • عبارت‌های فیلتر از یک یا چند محدودیت تشکیل شده‌اند.
  • محدودیت‌ها را می‌توان با عملگر منطقی OR ترکیب کرد.
  • محدودیت به‌صورت {field} {operator} {value} است.
  • همه فیلدها باید از اپراتور EQUALS (=) استفاده کنند.

فیلدهای پشتیبانی‌شده:

  • inventorySourceGroupId

طول این فیلد نباید بیشتر از ۵۰۰ نویسه باشد.

برای اطلاعات بیشتر، به راهنمای درخواست‌های LIST فیلتر ما مراجعه کنید.
الزامی. مشخص می‌کند که درخواست در کدام نهاد DV360 انجام می‌شود. درخواست LIST فقط موجودیت‌های گروه منبع فضای آگهی را برمی‌گرداند که برای موجودیت DV360 شناسایی‌شده در accessor قابل‌دسترسی هستند. در زیر فهرستی از فیلدهای متقابلاً انحصاری آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم خواهد شد:
partnerId

string (int64 format)

شناسه شریکی که به گروه منبع سیاهه دسترسی دارد.

شریک نمی‌تواند به گروه‌های منبع موجودی تحت مالکیت تبلیغ‌کننده دسترسی داشته باشد.
advertiserId

string (int64 format)

شناسه آگهی‌دهنده‌ای که به گروه منبع موجودی دسترسی دارد.

اگر گروه منبع موجودی متعلق به شریک باشد، فقط تبلیغ‌کنندگانی که گروه صریحاً با آن‌ها هم‌رسانی شده است می‌توانند به گروه دسترسی داشته باشند.
پایان فیلدهای متقابلاً انحصاری.

متن درخواست

بدنه درخواست باید خالی باشد.

بدنه پاسخ

Response message for InventorySourceGroupService.ListInventorySourceGroups.

اگر موفقیت‌آمیز باشد، بدنه پاسخ حاوی داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "inventorySourceGroups": [
    {
      object (InventorySourceGroup)
    }
  ],
  "nextPageToken": string
}
فیلدها
inventorySourceGroups[]

object (InventorySourceGroup)

فهرست گروه‌های منبع سیاهه.

اگر این فهرست خالی باشد، نمایش داده نخواهد شد.
nextPageToken

string

نشانه‌ای برای بازیابی صفحه بعدی نتایج. این مقدار را در فیلد pageToken در تماس بعدی با روش inventorySourceGroups.list ارسال کنید تا صفحه بعدی نتایج بازیابی شود.

دامنه‌های مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به OAuth 2.0 Overview مراجعه کنید.