Method: customers.uploadUserData

Belirtilen kullanıcı verilerini yükler.

Atılan hataların listesi: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Kullanıcı verilerinin güncelleneceği müşterinin kimliği.

İstek içeriği

İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "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.
}
Alanlar
operations[]

object (UserDataOperation)

Zorunlu. Yapılacak işlemlerin listesi.
Birleştirme alanı metadata. İsteğin meta verileri. metadata şunlardan yalnızca biri olabilir:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Müşteri Eşleştirme kullanıcı listesinde yapılan veri güncellemelerinin meta verileri.

Yanıt gövdesi

UserDataService.UploadUserData Bu hizmet aracılığıyla yapılan yüklemelerin yanıt mesajı, Google Ads kullanıcı arayüzünde Müşteri Eşleştirme Listesi'nin "Segment üyeleri" bölümünde görünmeyecek.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Alanlar
uploadDateTime

string

İsteğin API tarafından alındığı, "yyyy-aa-gg ss:dd:ss+|-ss:dd" biçiminde belirtilen tarih, ör. "2019-01-01 12:32:45-08:00".
receivedOperationsCount

integer

API tarafından alınan veri yükleme işlemlerinin sayısı.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

UserDataOperation

UploadUserDataRequest için yapılacak işlem.

JSON gösterimi 
{

  // 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.
}
Alanlar
Birleştirme alanı operation. UploadUserDataRequest için yapılacak işlem. operation şunlardan yalnızca biri olabilir:
create

object (UserData)

Kullanıcı listesine eklenecek kullanıcı verilerinin listesi.
remove

object (UserData)

Kullanıcı listesinden kaldırılacak kullanıcı verilerinin listesi.