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.