Method: customBiddingAlgorithms.scripts.list

يسرد النصوص البرمجية لعروض الأسعار المخصّصة التي تنتمي إلى الخوارزمية المحدّدة.

ويتم تحديد الترتيب من خلال المَعلمة orderBy.

طلب HTTP

GET https://displayvideo.googleapis.com/v2/customBiddingAlgorithms/{customBiddingAlgorithmId}/scripts

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

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

المَعلمات
customBiddingAlgorithmId

string (int64 format)

مطلوبة. يمتلك رقم تعريف خوارزمية عروض الأسعار المخصّصة النص البرمجي.

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

المَعلمات
pageSize

integer

حجم الصفحة المطلوب. يجب أن تتراوح القيمة بين 1 و200. وفي حال عدم تحديد نوع السياسة، سيتم ضبط القيمة التلقائية على 100. لعرض رمز الخطأ INVALID_ARGUMENT إذا تم تحديد قيمة غير صالحة.
pageToken

string

يشير هذا المصطلح إلى رمز مميّز يحدّد صفحة من النتائج التي يجب أن يعرضها الخادم. عادةً ما تكون هذه هي قيمة nextPageToken التي تم عرضها من الاستدعاء السابق إلى طريقة scripts.list. في حال عدم تحديد أي خيار، سيتم عرض الصفحة الأولى من النتائج.
orderBy

string

الحقل الذي سيتم ترتيب القائمة وفقًا له. القيم المقبولة هي:

  • createTime desc (تلقائي)

يكون ترتيب الترتيب التلقائي تنازليًا. لتحديد ترتيب تصاعدي حسب حقل، يجب إزالة اللاحقة "تنازلي". مثال: createTime
معلمة الاتحاد accessor. مطلوبة. تحدّد كيان "مساحة العرض والفيديو 360" الذي يملك خوارزمية عروض الأسعار المخصّصة الرئيسية. قد يكون إما شريكًا أو معلنًا. يمكن أن يكون الحقل "accessor" واحدًا فقط مما يلي:
partnerId

string (int64 format)

رقم تعريف الشريك الذي يملك خوارزمية عروض الأسعار المخصّصة الرئيسية.

سيتمكّن هذا الشريك فقط من الوصول للكتابة إلى هذا النص البرمجي لعروض الأسعار المخصّصة.
advertiserId

string (int64 format)

رقم تعريف المعلِن الذي يملك خوارزمية عروض الأسعار المخصّصة الرئيسية.

نص الطلب

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

نص الاستجابة

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

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

object (CustomBiddingScript)

قائمة النصوص البرمجية لعروض الأسعار المخصّصة.

لن يتم إدخال هذه القائمة إذا كانت فارغة.
nextPageToken

string

رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل pageToken في الاستدعاء التالي إلى طريقة ListCustomBiddingScriptsRequest لاسترداد الصفحة التالية من النتائج. إذا كان هذا الحقل خاليًا، فهذا يعني أن هذه هي الصفحة الأخيرة.

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

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

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

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