Method: audienceMembers.ingest

AudienceMember リソースのリストを指定された Destination にアップロードします。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

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)

必須。指定されたリンク先に送信するユーザーのリスト。1 回のリクエストで送信できる AudienceMember リソースは最大 10,000 個です。
consent

object (Consent)

省略可。リクエスト内のすべてのユーザーに適用されるリクエスト レベルの同意。ユーザーレベルの同意はリクエストレベルの同意をオーバーライドし、各 AudienceMember で指定できます。
validateOnly

boolean

省略可。テスト目的。true の場合、リクエストは検証されますが実行されません。結果ではなく、エラーのみが返されます。
encoding

enum (Encoding)

省略可。UserData のアップロードに必要です。ユーザー識別子のエンコード タイプ。ハッシュ化されたユーザー識別子の場合、これはハッシュ化された文字列のエンコード タイプです。暗号化されたハッシュ化ユーザー ID の場合、これは外側の暗号化された文字列のエンコード タイプですが、必ずしも内側のハッシュ化された文字列のエンコード タイプではありません。つまり、内側のハッシュ化された文字列は、外側の暗号化された文字列とは異なる方法でエンコードされる可能性があります。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。UserData または MobileData を取り込む場合は、これに同意する必要があります。このフィールドは、パートナー マッチのユーザーリストでは必須ではありません。

TermsOfServiceStatus

利用規約に同意するか拒否するかという発信者の決定を表します。

列挙型
TERMS_OF_SERVICE_STATUS_UNSPECIFIED 指定されていません。
ACCEPTED 発信者が利用規約に同意することを選択したことを示すステータス。
REJECTED 発信者が利用規約を拒否したことを示すステータス。