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.