Method: sellers.adUnits.list

يسرد الوحدات الإعلانية.

  • على سبيل المثال GET /v1/sellers/seller111/adUnits
  • تعرض قائمة بالوحدات الإعلانية ورمزًا مميزًا لاسترداد الصفحة التالية في حال نجاحها.
  • تعرض رمز الخطأ PERMISSION_DENIED إذا لم يكن لدى المستخدم إذن الوصول إلى البائع أو رقم تعريف البائع غير متوفّر.
  • تعرض رمز الخطأ INVALID_ARGUMENT إذا قدم البائعون حجم صفحة أو رمزًا غير صالح للصفحة.

طلب HTTP

GET https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adUnits

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
parent

string

مطلوب. البائع الذي يملك هذه المجموعة من الوحدات الإعلانية. التنسيق: seller/{seller}

معامِلات طلب البحث

المعلمات
pageSize

integer

تمثّل هذه السمة الحد الأقصى لعدد السلع المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. الحد الأقصى المسموح به لعدد الوحدات الإعلانية هو 1,000. ستتغير القيم الأعلى من 1000 إلى 1000. وفي حال عدم تحديد ذلك، سيتم عرض 1000 وحدة إعلانية كحدّ أقصى.
pageToken

string

قيمة NextPageToken التي يتم عرضها من طلب قائمة سابق، إن وجد.
filter

string

فلتر القائمة. تتيح هذه السياسة حاليًا الفلترة مع المعرِّفات الخارجية والحالة، باستخدام البنية: "externalId = [EXTERNAL_ID]". و"الولاية = [state]". يمكن استخدام العوامل المنطقية AND وOR لسلسلة الفلاتر. لا يمكن استخدام AD_UNIT_state_DELETED لعرض الوحدات الإعلانية المحذوفة، يُرجى استخدام showDeleted بدلاً من ذلك.
orderBy

string

الترتيب حسب السلسلة المستخدم لتحديد نظام ترتيب النتائج. يمكن حاليًا إجراء الطلب حسب updateTime. يجب إدخال قيمة "updateTime". لترتيب النتائج تصاعديًا حسب updateTime، أو "updateTime desc" بترتيب تنازلي.
showDeleted

boolean

تحديد ما إذا كان سيتم عرض وحدات إعلانية محذوفة بشكلٍ مبدئي.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

رسالة ردّ لـ InventoryService.ListAdUnits.

تمثيل JSON 
{
  "adUnits": [
    {
      object (AdUnit)
    }
  ],
  "nextPageToken": string
}
الحقول
adUnits[]

object (AdUnit)

قائمة بالوحدات الإعلانية.
nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في طريقة الاستدعاء التالية إلى adUnits.list لاسترداد الصفحة التالية من النتائج.

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/doubleclickbidmanager

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.