Method: audienceMembers.ingest

将 AudienceMember 资源列表上传到提供的 Destination。

HTTP 请求

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

网址采用 gRPC 转码语法。

请求正文

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

JSON 表示法 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
字段
destinations[]

object (Destination)

必需。要将受众群体成员发送到的目标列表。
audienceMembers[]

object (AudienceMember)

必需。要发送到指定目标的用户列表。在单个请求中，最多可以发送 10000 个 AudienceMember 资源。
consent

object (Consent)

可选。要应用于请求中所有用户的请求级同意声明。用户级同意声明会替换请求级同意声明，并且可以在每个 AudienceMember 中指定。
validateOnly

boolean

可选。用于测试。如果为 true，则系统会验证请求，但不会执行请求。系统只会返回错误，而不会返回结果。
encoding

enum (Encoding)

可选。必须为 UserData 上传提供此字段。用户标识符的编码类型。对于哈希处理后的用户标识符，这是哈希处理后的字符串的编码类型。对于加密的哈希处理后的用户标识符，这是外部加密字符串的编码类型，但不一定是内部哈希处理后的字符串的编码类型，这意味着内部哈希处理后的字符串可以采用与外部加密字符串不同的方式进行编码。对于非 UserData 上传，系统会忽略此字段。
encryptionInfo

object (EncryptionInfo)

可选。用于 UserData 上传的加密信息。如果未设置，则假定上传的身份信息已进行哈希处理，但未加密。对于非 UserData 上传，系统会忽略此字段。
termsOfService

object (TermsOfService)

可选。用户已接受/拒绝的服务条款。

响应正文

来自 IngestAudienceMembersRequest 的响应。

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

JSON 表示法 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
字段
requestId

string

系统自动生成的请求 ID。
fieldWarnings[]

object (FieldWarning)

包含字段路径的详细行级警告。

授权范围

需要以下 OAuth 范围：

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

TermsOfService

用户已接受/拒绝的服务条款。

JSON 表示法 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
字段
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

可选。目标客户匹配服务条款：https://support.google.com/adspolicy/answer/6299717。在注入 UserData 或 MobileData 时，必须接受此条款。对于合作伙伴匹配用户名单，此字段不是必需的。

TermsOfServiceStatus

表示调用方接受或拒绝服务条款的决定。

枚举
TERMS_OF_SERVICE_STATUS_UNSPECIFIED 未指定。
ACCEPTED 表示调用方已选择接受服务条款的状态。
REJECTED 表示调用方已选择拒绝服务条款的状态。