Method: audienceMembers.ingest

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

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 のアップロードには指定する必要があります。ユーザー識別子のエンコード タイプ。ハッシュ化されたユーザー識別子の場合は、ハッシュ化された文字列のエンコード タイプです。暗号化されたハッシュ化ユーザー識別子の場合は、外側の暗号化された文字列のエンコード タイプです。内側のハッシュ化された文字列のエンコード タイプとは限りません。つまり、内側のハッシュ化された文字列は、外側の暗号化された文字列とは異なる方法でエンコードされる可能性があります。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 呼び出し元が利用規約を拒否することを選択したことを示すステータス。