Method: customBiddingAlgorithms.rules.list

يسرد موارد القواعد التي تنتمي إلى الخوارزمية المحدّدة.

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

طلب HTTP

GET https://displayvideo.googleapis.com/v3/customBiddingAlgorithms/{customBiddingAlgorithmId}/rules

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

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

المَعلمات
customBiddingAlgorithmId

string (int64 format)

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

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

المَعلمات
pageSize

integer

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

string

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

string

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

  • createTime desc (تلقائي)

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

string (int64 format)

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

string (int64 format)

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

نص الطلب

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

نص الاستجابة

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

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

object (CustomBiddingAlgorithmRules)

قائمة موارد Custom BiddingAlgorithmالقواعدs.

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

string

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

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

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

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

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