החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשת HTTP
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit
כתובת ה-URL משתמשת בתחביר של Transcoding של 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.
אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:
| שדות |
negativeKeywords[] |
object (NegativeKeyword)
רשימת מילות המפתח השליליות שנוצרו בהצלחה. אם הרשימה הזו ריקה, היא לא תופיע.
|
היקפי הרשאה
נדרשת הרשאת OAuth ברמה הבאה:
https://www.googleapis.com/auth/display-video
מידע נוסף זמין בOAuth 2.0 Overview.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[],[],null,["# Method: advertisers.negativeKeywordLists.negativeKeywords.bulkEdit\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BulkEditNegativeKeywordsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nBulk edits negative keywords in a single negative keyword list.\n\nThe operation will delete the negative keywords provided in [BulkEditNegativeKeywordsRequest.deleted_negative_keywords](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords/bulkEdit#body.request_body.FIELDS.deleted_negative_keywords) and then create the negative keywords provided in [BulkEditNegativeKeywordsRequest.created_negative_keywords](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords/bulkEdit#body.request_body.FIELDS.created_negative_keywords).\n\nThis operation is guaranteed to be atomic and will never result in a partial success or partial failure.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:bulkEdit`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the DV360 advertiser to which the parent negative keyword list belongs. |\n| `negativeKeywordListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the parent negative keyword list to which the negative keywords belong. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deletedNegativeKeywords\": [ string ], \"createdNegativeKeywords\": [ { object (/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword) } ] } ``` |\n\n| Fields ||\n|-----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deletedNegativeKeywords[]` | `string` The negative keywords to delete in batch, specified as a list of [keyword_values](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword.FIELDS.keyword_value). |\n| `createdNegativeKeywords[]` | `object (`[NegativeKeyword](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword)`)` The negative keywords to create in batch, specified as a list of [NegativeKeywords](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword). |\n\n### Response body\n\nResponse message for NegativeKeywordService.BulkEditNegativeKeywords.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"negativeKeywords\": [ { object (/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword) } ] } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `negativeKeywords[]` | `object (`[NegativeKeyword](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword)`)` The list of negative keywords that have been successfully created. This list will be absent if empty. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
