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.BulkEdit negativeKeyword.

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

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

object (NegativeKeyword)

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

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

نطاقات الأذونات

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

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

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