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)

必需。要发送到指定目的地的用户列表。单个请求中最多可以发送 10,000 个 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
}
字段
requestId

string

请求的自动生成的 ID。

授权范围

需要以下 OAuth 范围：

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

TermsOfService

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

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

enum (TermsOfServiceStatus)

可选。目标客户匹配服务条款：https://support.google.com/adspolicy/answer/6299717。必须接受此条款才能将数据上传到目标客户匹配用户名单。

TermsOfServiceStatus

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

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