Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

إجراء تعديلات مجمّعة للكلمات الرئيسية السلبية في قائمة كلمات رئيسية سلبية واحدة

ستؤدي العملية إلى حذف الكلمات الرئيسية السلبية الواردة في BulkEditNegativeKeywordsRequest.deleted_negative_keywords، ثم إنشاء الكلمات الرئيسية السلبية المقدَّمة في BulkEditNegativeKeywordsRequest.created_negative_keywords.

يمكن ضمان إجراء هذه العملية بشكل كامل ولن تؤدي أبدًا إلى نجاح جزئي أو إخفاق جزئي.

طلب HTTP

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit

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

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

المَعلمات
advertiserId

string (int64 format)

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

string (int64 format)

مطلوبة. رقم تعريف قائمة الكلمات الرئيسية السلبية الرئيسية التي تنتمي إليها الكلمات الرئيسية السلبية.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "deletedNegativeKeywords": [
    string
  ],
  "createdNegativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
الحقول
deletedNegativeKeywords[]

string

الكلمات الرئيسية السلبية المطلوب حذفها بشكل مجمّع، المحددة كقائمة من keyword_values.
createdNegativeKeywords[]

object (NegativeKeyword)

الكلمات الرئيسية السلبية المطلوب إنشاؤها دفعة واحدة، المحددة كقائمة من NegativeKeywords.

نص الاستجابة

رسالة الردّ لـ negativeKeywordService.BulkEditNegativeKeywords.

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

تمثيل JSON 
{
  "negativeKeywords": [
    {
      object (NegativeKeyword)
    }
  ]
}
الحقول
negativeKeywords[]

object (NegativeKeyword)

قائمة الكلمات الرئيسية السلبية التي تم إنشاؤها بنجاح.

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

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

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

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

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