החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
Method: advertisers.channels.sites.bulkEdit
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשת HTTP
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים |
channelId |
string (int64 format)
חובה. המזהה של ערוץ ההורה שאליו שייכים האתרים.
|
פרמטר האיחוד owner . חובה. מזהה את הישות ב-DV360 שבבעלותה ערוץ ההורה. זה יכול להיות שותף או מפרסם. הערך של owner יכול להיות רק אחת מהאפשרויות הבאות: |
advertiserId |
string (int64 format)
המזהה של המפרסם שהוא הבעלים של ערוץ ההורה.
|
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג ב-JSON |
{
"deletedSites": [
string
],
"createdSites": [
{
object (Site )
}
],
// Union field owner can be only one of the following:
"partnerId": string
// End of list of possible types for union field owner .
} |
שדות |
deletedSites[] |
string
האתרים שרוצים למחוק בבת אחת, שמצוינים כרשימה של אתר url_or_app_ids .
|
createdSites[] |
object (Site )
האתרים שייווצרו באצווה, שמצוינים כרשימה של Sites .
|
שדה האיחוד owner . חובה. מזהה את הישות ב-DV360 שבבעלותה ערוץ ההורה. זה יכול להיות שותף או מפרסם. הערך של owner יכול להיות רק אחת מהאפשרויות הבאות: |
partnerId |
string (int64 format)
המזהה של השותף שבבעלותו ערוץ ההורה.
|
advertiserId |
string (int64 format)
המזהה של המפרסם שהוא הבעלים של ערוץ ההורה.
|
גוף התשובה
אם הפעולה מצליחה, גוף התגובה מכיל מופע של BulkEditSitesResponse
.
היקפי הרשאה
נדרשת הרשאת 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.channels.sites.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- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nBulk edits sites under a single channel.\n\nThe operation will delete the sites provided in [BulkEditSitesRequest.deleted_sites](/display-video/api/reference/rest/v4/partners.channels.sites/bulkEdit#body.request_body.FIELDS.deleted_sites) and then create the sites provided in [BulkEditSitesRequest.created_sites](/display-video/api/reference/rest/v4/partners.channels.sites/bulkEdit#body.request_body.FIELDS.created_sites).\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `channelId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the parent channel to which the sites belong. |\n| Union parameter `owner`. Required. Identifies the DV360 entity that owns the parent channel. It can be either a partner or an advertiser. `owner` can be only one of the following: ||\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent channel. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deletedSites\": [ string ], \"createdSites\": [ { object (/display-video/api/reference/rest/v4/advertisers.channels.sites#Site) } ], // Union field `owner` can be only one of the following: \"partnerId\": string // End of list of possible types for union field `owner`. } ``` |\n\n| Fields ||\n|------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deletedSites[]` | `string` The sites to delete in batch, specified as a list of site [url_or_app_ids](/display-video/api/reference/rest/v4/advertisers.channels.sites#Site.FIELDS.url_or_app_id). |\n| `createdSites[]` | `object (`[Site](/display-video/api/reference/rest/v4/advertisers.channels.sites#Site)`)` The sites to create in batch, specified as a list of [Sites](/display-video/api/reference/rest/v4/advertisers.channels.sites#Site). |\n| Union field `owner`. Required. Identifies the DV360 entity that owns the parent channel. It can be either a partner or an advertiser. `owner` can be only one of the following: ||\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the partner that owns the parent channel. |\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the advertiser that owns the parent channel. |\n\n### Response body\n\nIf successful, the response body contains an instance of [BulkEditSitesResponse](/display-video/api/reference/rest/v4/BulkEditSitesResponse).\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)."]]