Method: audienceMembers.ingest

Mengupload daftar resource AudienceMember ke Destination yang diberikan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "audienceMembers": [
    {
      object (AudienceMember)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  },
  "termsOfService": {
    object (TermsOfService)
  }
}
Kolom
destinations[]

object (Destination)

Wajib. Daftar tujuan untuk mengarahkan anggota audiens.
audienceMembers[]

object (AudienceMember)

Wajib. Daftar pengguna yang akan dikirim ke tujuan yang ditentukan. Maksimal 10000 resource AudienceMember dapat dikirim dalam satu permintaan.
consent

object (Consent)

Opsional. Izin tingkat permintaan untuk diterapkan kepada semua pengguna dalam permintaan. Izin tingkat pengguna menggantikan izin tingkat permintaan, dan dapat ditentukan di setiap AudienceMember.
validateOnly

boolean

Opsional. Untuk tujuan pengujian. Jika true, permintaan divalidasi tetapi tidak dieksekusi. Hanya error yang ditampilkan, bukan hasil.
encoding

enum (Encoding)

Opsional. Diperlukan untuk upload UserData. Jenis encoding ID pengguna. Untuk ID pengguna yang di-hash, ini adalah jenis encoding string yang di-hash. Untuk ID pengguna yang di-hash dan dienkripsi, ini adalah jenis encoding string terenkripsi luar, tetapi tidak harus string yang di-hash dalam, yang berarti string yang di-hash dalam dapat dienkode dengan cara yang berbeda dari string terenkripsi luar. Untuk upload non-UserData, kolom ini diabaikan.
encryptionInfo

object (EncryptionInfo)

Opsional. Informasi enkripsi untuk upload UserData. Jika tidak disetel, diasumsikan bahwa informasi identitas yang diupload di-hash, tetapi tidak dienkripsi. Untuk upload non-UserData, kolom ini diabaikan.
termsOfService

object (TermsOfService)

Opsional. Persyaratan layanan yang telah disetujui/ditolak pengguna.

Isi respons

Respons dari IngestAudienceMembersRequest.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "requestId": string
}
Kolom
requestId

string

ID permintaan yang dibuat otomatis.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

TermsOfService

Persyaratan layanan yang telah disetujui/ditolak pengguna.

Representasi JSON 
{
  "customerMatchTermsOfServiceStatus": enum (TermsOfServiceStatus)
}
Kolom
customerMatchTermsOfServiceStatus

enum (TermsOfServiceStatus)

Opsional. Persyaratan layanan Customer Match: https://support.google.com/adspolicy/answer/6299717. Persyaratan ini harus disetujui untuk semua upload ke daftar pengguna Customer Match.

TermsOfServiceStatus

Mewakili keputusan penelepon untuk menyetujui atau menolak persyaratan layanan.

Enum
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Tidak ditentukan.
ACCEPTED Status yang menunjukkan bahwa pemanggil telah memilih untuk menyetujui persyaratan layanan.
REJECTED Status yang menunjukkan bahwa pemanggil telah memilih untuk menolak persyaratan layanan.