上传指定的用户数据。
抛出的错误列表:AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError
HTTP 请求
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadUserData
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。要为其更新用户数据的客户的 ID。 |
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
---|
{ "operations": [ { object ( |
字段 | |
---|---|
operations[] |
必需。要执行的操作的列表。 |
联合字段 metadata 。请求的元数据。metadata 只能是下列其中一项: |
|
customerMatchUserListMetadata |
用于对目标客户匹配用户名单进行数据更新的元数据。 |
响应正文
针对 UserDataService.UploadUserData
的响应消息不会显示在 Google Ads 界面中目标客户匹配名单的“细分受众群成员”部分下。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{ "uploadDateTime": string, "receivedOperationsCount": integer } |
字段 | |
---|---|
uploadDateTime |
API 收到请求的日期时间,格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”,例如“2019-01-01 12:32:45-08:00”。 |
receivedOperationsCount |
API 收到的上传数据操作次数。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
UserDataOperation
要为 UploadUserDataRequest 执行的操作。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段 operation 。要为 UploadUserDataRequest 执行的操作。operation 只能是下列其中一项: |
|
create |
要附加到用户名单的用户数据列表。 |
remove |
要从用户列表中移除的用户数据的列表。 |