Method: customBiddingAlgorithms.scripts.list

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

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

طلب HTTP

GET https://displayvideo.googleapis.com/v3/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 (تلقائي)

يكون ترتيب الترتيب التلقائي تنازليًا. لتحديد ترتيب تصاعدي للحقل، يجب استخدام اللاحقة "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.