رابط برنامهنویسی کاربردی Display & Video 360 اکنون از مدیریت منابع Demand Gen پشتیبانی میکند. برای یادگیری نحوه ساخت و اجرای یک کمپین تبلیغاتی Demand Gen، به راهنمای جدید ما مراجعه کنید.
الزامی. شناسه کانال والد که سایتهای درخواستی به آن تعلق دارند.
الزامی. نهاد DV360 که مالک کانال والد است را مشخص میکند. این نهاد میتواند شریک یا تبلیغکننده باشد. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم میشود:
اندازه صفحه درخواستی. باید بین 1 تا 10000 باشد. اگر مشخص نشود، پیشفرض 100 خواهد بود. اگر مقدار نامعتبر مشخص شود، کد خطای INVALID_ARGUMENT را برمیگرداند.
pageToken
string
یک توکن که صفحهای از نتایج را که سرور باید برگرداند، مشخص میکند.
معمولاً این مقدار nextPageToken است که از فراخوانی قبلی متد sites.list برگردانده میشود. اگر مشخص نشود، صفحه اول نتایج برگردانده خواهد شد.
orderBy
string
فیلدی که لیست بر اساس آن مرتب میشود. مقادیر قابل قبول عبارتند از:
urlOrAppId (پیشفرض)
ترتیب مرتبسازی پیشفرض صعودی است. برای تعیین ترتیب نزولی برای یک فیلد، باید پسوند "desc" به نام فیلد اضافه شود. مثال: urlOrAppId desc .
filter
string
امکان فیلتر کردن بر اساس فیلدهای سایت را فراهم میکند.
سینتکس پشتیبانی شده:
عبارات فیلتر برای بازیابی سایت فقط میتوانند حداکثر شامل یک محدودیت باشند.
یک محدودیت به شکل {field} {operator} {value} است.
همه فیلدها باید از عملگر HAS (:) استفاده کنند.
فیلدهای پشتیبانی شده:
urlOrAppId
مثالها:
همه سایتهایی که URL یا شناسه برنامه آنها شامل "google" است: urlOrAppId : "google"
الزامی. نهاد DV360 که مالک کانال والد است را مشخص میکند. این نهاد میتواند شریک یا تبلیغکننده باشد. در زیر لیستی از فیلدهای ناسازگار آمده است. حداکثر یکی از فیلدها در پاسخ تنظیم میشود:
تاریخ آخرین بهروزرسانی 2026-10-01 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-10-01 بهوقت ساعت هماهنگ جهانی."],[],["The Display & Video 360 API v4, currently in beta, allows listing sites within a channel using a `GET` request. Users must specify `channelId` and the owning entity's ID (`partnerId` or `advertiserId`) in the URL path. Optional query parameters include `pageSize`, `pageToken`, `orderBy`, and `filter` to manage the result set. The request body must be empty, and a successful response returns a `ListSitesResponse` instance. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"]]