向线下用户数据作业添加操作。
抛出的错误列表:AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError
HTTP 请求
POST https://googleads.googleapis.com/v17/{resourceName=customers/*/offlineUserDataJobs/*}:addOperations
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
resource |
必需。OfflineUserDataJob 的资源名称。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{
"operations": [
{
object ( |
字段 | |
---|---|
operations[] |
必需。要执行的操作列表。 |
validate |
如果为 true,则系统会验证请求,但不会执行该请求。仅返回错误,不返回结果。 |
enable |
设为 true 可允许离线用户数据作业部分失败。 |
enable |
将此值设为 True 可为离线用户数据作业启用警告。启用后,警告不会阻止 OfflineUserDataJobOperation,还会返回有关格式错误的字段值的警告消息。 |
响应正文
OfflineUserDataJobService.AddOfflineUserDataJobOperations
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "partialFailureError": { object ( |
字段 | |
---|---|
partial |
与部分失败模式下的操作失败相关的错误。仅当 partialFailure = true 且所有错误均发生在操作中时才返回。如果操作之外发生任何错误(例如身份验证错误),我们会返回 RPC 级错误。 |
warning |
警告模式下与操作失败相关的非阻塞错误。仅当 enableWarnings = true 时返回。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/adwords
如需了解详情,请参阅 OAuth 2.0 Overview。
OfflineUserDataJobOperation
要针对 AddOfflineUserDataJobOperationsRequest 执行的操作。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 operation 。要针对 AddOfflineUserDataJobOperationsRequest 执行的操作。operation 只能是下列其中一项: |
|
create |
将提供的数据添加到交易中。数据上传后无法检索。 |
remove |
从交易中移除提供的数据。数据上传后无法检索。 |
remove |
移除之前提供的所有数据。仅目标客户匹配受众群体支持此功能。 |