مطلوبة. معرّف القناة الرئيسية التي تنتمي إليها المواقع الإلكترونية المطلوبة.
معلمة الاتحاد owner. مطلوبة. تحدّد كيان "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. قد يكون إما شريكًا أو معلنًا. يمكن أن يكون الحقل "owner" واحدًا فقط مما يلي:
حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1 و10000. وفي حال عدم تحديد نوع السياسة، سيتم ضبط القيمة التلقائية على 100. لعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد قيمة غير صالحة.
pageToken
string
يشير هذا المصطلح إلى رمز مميّز يحدّد صفحة من النتائج التي يجب أن يعرضها الخادم.
عادةً ما تكون هذه هي قيمة nextPageToken التي تم عرضها من الاستدعاء السابق إلى طريقة sites.list. في حال عدم تحديد أي خيار، سيتم عرض الصفحة الأولى من النتائج.
orderBy
string
الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:
urlOrAppId (تلقائي)
يكون ترتيب الترتيب التلقائي تصاعديًا. لتحديد ترتيب تنازلي لأحد الحقول، يجب إضافة اللاحقة " الوصف" إلى اسم الحقل. مثال: urlOrAppId desc
filter
string
تسمح بالفلترة حسب حقول الموقع الإلكتروني.
البنية المتوافقة:
لا يمكن أن تحتوي تعبيرات الفلاتر لاسترداد المواقع الإلكترونية إلا على قيد واحد على الأكثر.
يكون نوع القيود كالآتي {field} {operator} {value}.
يجب أن تستخدم جميع الحقول عامل التشغيل HAS (:).
الحقول المتاحة:
urlOrAppId
أمثلة:
جميع المواقع الإلكترونية التي يحتوي عنوان URL أو رقم تعريف التطبيق لها على "google": urlOrAppId : "google"
معلمة الاتحاد owner. مطلوبة. تحدّد كيان "مساحة العرض والفيديو 360" الذي يملك القناة الرئيسية. قد يكون إما شريكًا أو معلنًا. يمكن أن يكون الحقل "owner" واحدًا فقط مما يلي:
تاريخ التعديل الأخير: 2024-06-11 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2024-06-11 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Lists sites associated with a given channel within a Display & Video 360 advertiser or partner."],["Allows filtering and sorting of sites based on criteria like URL or app ID."],["Supports pagination to retrieve large lists of sites efficiently."],["Requires authorization with the `https://www.googleapis.com/auth/display-video` scope."]]],["This document outlines the process for listing sites within a channel using the Display & Video 360 API. Key actions include sending a `GET` request to a specified URL, which requires the `channelId` and either `advertiserId` or `partnerId` as path parameters. Optional query parameters, such as `pageSize`, `pageToken`, `orderBy`, and `filter`, refine the list results. The request body must be empty, and successful responses contain a `ListSitesResponse`. API authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"]]