每个新订单项都需要声明是否会投放欧盟 (EU) 政治广告。Display & Video 360 API 和未提供声明的 SDF 上传操作将会失败。如需了解详情,请参阅我们的
弃用页面。
Method: guaranteedOrders.patch
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
更新现有有保证订单。如果成功,则返回更新后的有保证订单。
HTTP 请求
PATCH https://displayvideo.googleapis.com/v4/guaranteedOrders/{guaranteedOrder.guaranteedOrderId}
网址采用 gRPC 转码语法。
路径参数
参数 |
guaranteedOrder.guaranteedOrderId |
string
仅限输出。有保证订单的唯一标识符。有保证的订单 ID 采用 {exchange}-{legacyGuaranteedOrderId} 格式。
|
查询参数
参数 |
updateMask |
string (FieldMask format)
必需。用于控制要更新的字段的掩码。 这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo" 。
|
联合参数 accessor 。必填。 用于标识请求是在哪个 DV360 实体中发出的。accessor 只能是下列其中一项: |
partnerId |
string (int64 format)
发出请求时所处合作伙伴的 ID。
|
advertiserId |
string (int64 format)
发出请求的广告客户的 ID。
|
请求正文
请求正文包含一个 GuaranteedOrder
实例。
响应正文
如果成功,则响应正文包含一个 GuaranteedOrder
实例。
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/display-video
如需了解详情,请参阅 OAuth 2.0 Overview。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],["The Display & Video 360 API v4 (beta) allows updating existing guaranteed orders via a PATCH request. The request URL includes the guaranteed order ID as a path parameter. Required query parameters include `updateMask`, to specify fields for updating, and an `accessor` (`partnerId` or `advertiserId`). The request and response bodies use the `GuaranteedOrder` format. The API uses gRPC Transcoding, and requires OAuth scope `https://www.googleapis.com/auth/display-video`. The request returns the updated guaranteed order upon success.\n"],null,[]]