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)

חובה. המזהה של המפרסם ב-DV360 שאליו שייכת רשימת מילות המפתח השליליות שברמה העליונה.
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.