עריכת כמות גדולה של מילות מפתח שליליות ברשימה אחת של מילות מפתח שליליות.
הפעולה תמחק את מילות המפתח השליליות שסופקו ב-BulkEditNegativeKeywordsRequest.deleted_negative_keywords
ולאחר מכן תיצור את מילות המפתח השליליות שסופקו ב-BulkEditNegativeKeywordsRequest.created_negative_keywords
.
מובטח שהפעולה הזו תהיה אטומית ולעולם לא תוביל להצלחה חלקית או לכשל חלקי.
בקשת HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
advertiserId |
חובה. המזהה של המפרסם ב-DV360 שאליו שייכת רשימת מילות המפתח השליליות ברמה העליונה. |
negativeKeywordListId |
חובה. המזהה של רשימת מילות המפתח השליליות ברמה העליונה שאליה שייכות מילות המפתח השליליות. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"deletedNegativeKeywords": [
string
],
"createdNegativeKeywords": [
{
object ( |
שדות | |
---|---|
deletedNegativeKeywords[] |
מילות המפתח השליליות שיש למחוק באצווה, מצוינות כרשימה של |
createdNegativeKeywords[] |
מילות המפתח השליליות ליצירה באצווה, מוגדרות כרשימה של |
גוף התגובה
הודעת תגובה עבור negativeKeywordService.BulkEditNegativeKeywords.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"negativeKeywords": [
{
object ( |
שדות | |
---|---|
negativeKeywords[] |
הרשימה של מילות המפתח השליליות שנוצרו בהצלחה. אם הרשימה ריקה, היא לא תופיע. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.