Method: advertisers.channels.sites.bulkEdit
HTTP 请求
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/channels/{channelId}/sites:bulkEdit
网址采用 gRPC 转码语法。
路径参数
参数 |
channelId |
string (int64 format)
必需。网站所属父级渠道的 ID。
|
联合参数 owner 。必需。用于标识父级渠道的 DV360 实体。它可以是合作伙伴,也可以是广告客户。owner 只能是下列其中一项: |
advertiserId |
string (int64 format)
父级频道的所有者广告客户的 ID。
|
请求正文
请求正文中包含结构如下的数据:
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)
拥有父级频道的合作伙伴的 ID。
|
advertiserId |
string (int64 format)
父级频道的所有者广告客户的 ID。
|
响应正文
如果成功,则响应正文包含一个 BulkEditSitesResponse
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/display-video
如需了解详情,请参阅 OAuth 2.0 Overview。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-02-25。
[null,null,["最后更新时间 (UTC):2025-02-25。"],[[["This operation allows for bulk editing of sites under a single channel, enabling deletion and creation of sites in batches."],["It utilizes an HTTP POST request to a specific endpoint with required path parameters, including `channelId` and `advertiserId` or `partnerId`."],["The request body needs to specify the sites to be deleted and created, using their respective `url_or_app_ids` or `Site` objects."],["Authorization is required via the `https://www.googleapis.com/auth/display-video` OAuth scope."],["Successful execution returns a `BulkEditSitesResponse` object in the response body."]]],["This outlines a bulk edit operation for sites within a channel, using a POST request to a specified URL. Key actions involve deleting sites listed in `deletedSites` and creating sites listed in `createdSites`. The request body is in JSON format and requires `channelId` and either `advertiserId` or `partnerId` as path parameters. Authorization requires the `https://www.googleapis.com/auth/display-video` scope. The successful response will include a `BulkEditSitesResponse`.\n"]]