Method: customers.uploadUserData

Mengupload data pengguna tertentu.

Daftar error yang ditampilkan: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

Permintaan HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
customerId

string

Wajib. ID pelanggan yang data penggunanya akan diperbarui.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
Kolom
operations[]

object (UserDataOperation)

Wajib. Daftar operasi yang akan dilakukan.
Kolom union metadata. Metadata permintaan. metadata hanya ada berupa salah satu diantara berikut:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Metadata untuk pembaruan data pada daftar pengguna Customer Match.

Isi respons

Pesan respons untuk UserDataService.UploadUserData Upload yang dilakukan melalui layanan ini tidak akan terlihat di bagian 'Anggota segmen' untuk Daftar Customer Match di UI Google Ads.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Kolom
uploadDateTime

string

Tanggal waktu permintaan diterima oleh API, dengan format "yyyy-mm-dd hh:mm:ss+|-hh:mm", misalnya, "2019-01-01 12:32:45-08:00".
receivedOperationsCount

integer

Jumlah operasi data upload yang diterima oleh API.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

UserDataOperation

Operasi yang akan dilakukan untuk UploadUserDataRequest.

Representasi JSON 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
Kolom
Kolom union operation. Operasi yang akan dilakukan untuk UploadUserDataRequest. operation hanya ada berupa salah satu diantara berikut:
create

object (UserData)

Daftar data pengguna yang akan ditambahkan ke daftar pengguna.
remove

object (UserData)

Daftar data pengguna yang akan dihapus dari daftar pengguna.