Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit

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

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

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

طلب HTTP

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