Method: advertisers.negativeKeywordLists.list

يسرد قوائم الكلمات الرئيسية السلبية بناءً على رقم تعريفي محدد للمعلِن.

طلب HTTP

GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/negativeKeywordLists

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

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

المعلمات
advertiserId

string (int64 format)

مطلوب. رقم تعريف المعلِن في "مساحة العرض والفيديو 360" الذي تنتمي إليه قوائم الكلمات الرئيسية السلبية التي تم جلبها.

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

المعلمات
pageSize

integer

حجم الصفحة المطلوب يجب أن تتراوح بين 1 و200. يتم ضبط القيمة تلقائيًا على 100 في حال عدم ضبطها. تُعرِض رمز الخطأ INVALID_ARGUMENT في حال تحديد قيمة غير صالحة.

pageToken

string

رمز مميّز لصفحة من النتائج التي يجب أن يعرضها الخادم

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

نص الطلب

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

نص الاستجابة

رسالة الاستجابة لخدمة NegativeKeywordListService.ListNegativeKeywordLists

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

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

object (NegativeKeywordList)

قائمة قوائم الكلمات الرئيسية السلبية

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

nextPageToken

string

رمز مميّز لاسترداد الصفحة التالية من النتائج

نقْل هذه القيمة في حقل pageToken في الطلب اللاحق لطريقة negativeKeywordLists.list لاسترداد الصفحة التالية من النتائج.

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

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

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

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