Method: users.ingest

将用户列表上传到指定目的地。与 audienceMembers.ingest（将用户添加到特定的广告客户受众群体名单以进行定位）不同，users.ingest 会提取账号级身份关联数据（例如，与移动设备 ID 关联的用户标识符），而与特定的受众群体细分无关。

此功能仅适用于已列入许可名单的账号。

HTTP 请求

POST https://datamanager.googleapis.com/v1/users:ingest

网址采用 gRPC 转码语法。

请求正文

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

JSON 表示法 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
字段
destinations[]

object (Destination)

必需。可能的提取目的地列表。
users[]

object (User)

必需。要提取的用户列表。
encryptionInfo

object (EncryptionInfo)

可选。用于加密数据的加密密钥的相关加密信息。
validateOnly

boolean

可选。如果值为 true，则系统会验证请求，但不会执行请求。
encoding

enum (Encoding)

必需。用户标识符的编码类型。对于加密的用户标识符，这仅适用于外部编码。

响应正文

来自 IngestUsersRequest 的响应。

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

JSON 表示法 
{
  "requestId": string
}
字段
requestId

string

提取请求的生成的请求 ID。

授权范围

需要以下 OAuth 范围：

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

用户

表示单个用户，包含 PII 和移动设备 ID 等标识符，这些标识符都指向同一用户。

JSON 表示法 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
字段
userData

object (UserData)

必需。多条用户提供的数据，用作识别用户的方式。
mobileData

object (MobileData)

必需。多个移动设备 ID 字符串，用于表示单个用户。