Method: users.ingest

指定された宛先にユーザーのリストをアップロードします。audienceMembers.ingest（ターゲティングのために特定の広告主のオーディエンス リストにユーザーを追加する）とは異なり、users.ingest は特定のオーディエンス セグメントとは無関係にアカウント レベルの ID リンクデータ（モバイル ID にリンクされたユーザー ID など）を取り込みます。

この機能は、許可リストに登録されているアカウントでのみ利用できます。

HTTP リクエスト

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

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

リクエストの本文

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

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)

必須。ユーザー識別子のエンコード タイプ。暗号化されたユーザー ID の場合、これは外部エンコードにのみ適用されます。

レスポンスの本文

IngestUsersRequest からのレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "requestId": string
}
フィールド
requestId

string

取り込みリクエストの生成されたリクエスト ID。

認可スコープ

次の OAuth スコープが必要です。

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

ユーザー

単一のユーザーを表します。PII やモバイル デバイス ID など、すべて同じユーザーを参照する ID が含まれます。

JSON 表現 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
フィールド
userData

object (UserData)

必須。ユーザーを特定する手段として使用される、ユーザー提供データの複数の要素。
mobileData

object (MobileData)

必須。1 人のユーザーを表す複数のモバイル デバイス ID 文字列。