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)

חובה. המזהה של המפרסם ב-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.