Method: customers.uploadUserData

上传指定的用户数据。

抛出的错误的列表：AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP 请求

POST https://googleads.googleapis.com/v17/customers/{customerId}:uploadUserData

网址采用 gRPC 转码语法。

路径参数

参数
customerId

string

必需。要为其更新用户数据的客户 ID。

请求正文

请求正文中包含结构如下的数据：

JSON 表示法 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
字段
operations[]

object (UserDataOperation)

必需。要执行的操作的列表。
联合字段 metadata。请求的元数据。metadata 只能是下列其中一项：
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

目标客户匹配用户名单数据更新的元数据。

响应正文

对“UserDataService.UploadUserData”的响应消息通过此服务上传的内容将不会显示在“细分受众群成员”下“目标客户匹配名单”部分。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
字段
uploadDateTime

string

API 收到请求的日期时间，格式为“yyyy-mm-dd hh:mm:ss+|-hh:mm”，例如“2019-01-01 12:32:45-08:00”。
receivedOperationsCount

integer

API 接收的上传数据操作数量。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/adwords

如需了解详情，请参阅 OAuth 2.0 概览。

UserDataOperation

要针对 UploadUserDataRequest 执行的操作。

JSON 表示法 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
字段
联合字段 operation。要针对 UploadUserDataRequest 执行的操作。operation 只能是下列其中一项：
create

object (UserData)

要附加到用户列表的用户数据列表。
remove

object (UserData)

要从用户列表中移除的用户数据的列表。