Method: users.ingest

Mengupload daftar pengguna ke tujuan yang ditentukan. Tidak seperti audienceMembers.ingest (yang menambahkan pengguna ke daftar audiens pengiklan tertentu untuk penargetan), users.ingest menyerap data penautan identitas tingkat akun (misalnya, ID pengguna yang ditautkan ke ID seluler) terlepas dari segmen audiens tertentu.

Fitur ini hanya tersedia untuk akun yang masuk dalam daftar yang diizinkan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "users": [
    {
      object (User)
    }
  ],
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding)
}
Kolom
destinations[]

object (Destination)

Wajib. Daftar kemungkinan tujuan penyerapan.
users[]

object (User)

Wajib. Daftar pengguna yang akan di-ingest.
encryptionInfo

object (EncryptionInfo)

Opsional. Informasi enkripsi tentang kunci enkripsi yang digunakan untuk mengenkripsi data.
validateOnly

boolean

Opsional. Jika true, permintaan akan divalidasi tetapi tidak dieksekusi.
encoding

enum (Encoding)

Wajib. Jenis encoding ID pengguna. Untuk ID pengguna terenkripsi, hal ini hanya berlaku untuk encoding luar.

Isi respons

Respons dari IngestUsersRequest.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestId": string
}
Kolom
requestId

string

ID permintaan yang dibuat dari Permintaan Penyerapan.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Pengguna

Mewakili satu pengguna, yang berisi ID seperti PII dan ID perangkat seluler yang semuanya merujuk ke pengguna yang sama.

Representasi JSON 
{
  "userData": {
    object (UserData)
  },
  "mobileData": {
    object (MobileData)
  }
}
Kolom
userData

object (UserData)

Wajib. Beberapa bagian data yang disediakan pengguna, yang digunakan sebagai cara untuk mengidentifikasi pengguna.
mobileData

object (MobileData)

Wajib. Beberapa string ID perangkat seluler untuk merepresentasikan satu pengguna.