از 8 سپتامبر 2025 ، هر مورد خط جدید باید اعلام کند که آیا تبلیغات سیاسی اتحادیه اروپا (EU) را ارائه می دهد یا خیر. Display & Video 360 API و بارگذاری‌های SDF که اعلان‌ها را ارائه نمی‌کنند با شکست مواجه می‌شوند. برای جزئیات بیشتر در مورد نحوه به روز رسانی یکپارچه سازی خود برای ایجاد این اعلامیه، به صفحه لغو اعتبار ما مراجعه کنید.
مورد نیاز. شناسه شریکی که تبلیغ‌کنندگان واکشی شده همه باید متعلق به آن باشند. این سیستم تنها از فهرست کردن تبلیغ‌کنندگان برای یک شریک در یک زمان پشتیبانی می‌کند.
pageSize
integer
اندازه صفحه درخواستی باید بین 1 تا 200 باشد. اگر نامشخص باشد به طور پیش فرض 100 خواهد بود.
pageToken
string
نشانه ای که صفحه ای از نتایجی را که سرور باید برگرداند، شناسایی کند. به طور معمول، این مقدار nextPageToken است که از تماس قبلی با روش advertisers.list بازگردانده می شود. اگر مشخص نشده باشد، صفحه اول نتایج برگردانده خواهد شد.
orderBy
string
فیلدی که بر اساس آن لیست مرتب می شود. مقادیر قابل قبول عبارتند از:
displayName (پیش‌فرض)
entityStatus
updateTime
ترتیب مرتب سازی پیش فرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، پسوند "desc" باید به نام فیلد اضافه شود. برای مثال displayName desc .
filter
string
امکان فیلتر کردن بر اساس فیلدهای تبلیغ کننده را می دهد.
نحو پشتیبانی شده:
عبارات فیلتر از یک یا چند محدودیت تشکیل شده اند.
محدودیت ها را می توان با عملگرهای منطقی AND یا OR ترکیب کرد.
یک محدودیت به شکل {field} {operator} {value} است.
فیلد updateTime باید از عملگرهای GREATER THAN OR EQUAL TO (>=) یا LESS THAN OR EQUAL TO (<=) استفاده کند.
تمام فیلدهای دیگر باید از عملگر EQUALS (=) استفاده کنند.
زمینه های پشتیبانی شده:
advertiserId
displayName
entityStatus
updateTime (ورودی در قالب ISO 8601 یا YYYY-MM-DDTHH:MM:SSZ )
مثال ها:
همه تبلیغ‌کنندگان فعال تحت یک شریک: entityStatus="ENTITY_STATUS_ACTIVE"
همه تبلیغ‌کنندگان با زمان به‌روزرسانی کمتر یا مساوی 2020-11-04T18:54:47Z (قالب ISO 8601): updateTime<="2020-11-04T18:54:47Z"
همه تبلیغ‌کنندگان با زمان به‌روزرسانی بیشتر یا مساوی 2020-11-04T18:54:47Z (قالب ISO 8601): updateTime>="2020-11-04T18:54:47Z"
نشانه ای برای بازیابی صفحه بعدی نتایج. این مقدار را در قسمت pageToken در روش تماس بعدی با advertisers.list ارسال کنید تا صفحه بعدی نتایج را بازیابی کنید.
تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis page documents the \u003ccode\u003eadvertisers.list\u003c/code\u003e method, which retrieves a list of advertisers accessible to the current user within Display & Video 360 API.\u003c/p\u003e\n"],["\u003cp\u003eAdvertisers are filtered by a required \u003ccode\u003epartnerId\u003c/code\u003e, allowing retrieval of advertisers belonging to a specific partner.\u003c/p\u003e\n"],["\u003cp\u003eResults can be sorted and paginated using query parameters such as \u003ccode\u003eorderBy\u003c/code\u003e, \u003ccode\u003epageSize\u003c/code\u003e, and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of \u003ccode\u003eAdvertiser\u003c/code\u003e objects and a \u003ccode\u003enextPageToken\u003c/code\u003e for accessing subsequent result pages.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],["This document details how to list advertisers accessible to a user via the Display & Video 360 API. The core action is sending a `GET` request to `https://displayvideo.googleapis.com/v2/advertisers`. A required `partnerId` parameter specifies the relevant partner. Optional parameters include `pageSize`, `pageToken`, `orderBy` (for sorting), and `filter` for filtering results. The response returns a list of advertisers and a `nextPageToken` for pagination. The request body must be empty, and OAuth 2.0 is used for authorization.\n"],null,[]]
