Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

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

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

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

طلب HTTP

POST https://displayvideo.googleapis.com/v1/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.