Package google.ads.datamanager.v1

Dizin

IngestionService

Kitle verilerini desteklenen hedeflere gönderme hizmeti.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

Belirtilen Destination konumuna AudienceMember kaynak listesi yükler.

Yetkilendirme kapsamları

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

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

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

Sağlanan Destination içindeki Event kaynakların listesini yükler.

Yetkilendirme kapsamları

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

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

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

Belirtilen Destination öğesinden AudienceMember kaynak listesini kaldırır.

Yetkilendirme kapsamları

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

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

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

Belirli bir istek kimliğine sahip isteğin durumunu alır.

Yetkilendirme kapsamları

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

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

MarketingDataInsightsService

Pazarlama verileriyle ilgili analizler döndürme hizmeti.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse)

Belirli bir kullanıcı listesi için pazarlama verileri analizlerini alır.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme üstbilgileri:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üst bilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak isteğin hesabını kullanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

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

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

PartnerLinkService

İş ortağı bağlantılarını yönetme hizmeti.

UserListDirectLicenseService

Kullanıcı listesi doğrudan lisanslarını yönetme hizmeti. Silme, UserListDirectLicenses için desteklenen bir işlem değildir. Arayanlar, lisansı devre dışı bırakmak için lisans durumunu DEVRE DIŞI olarak güncellemelidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

CreateUserListDirectLicense

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Doğrudan lisanslı bir kullanıcı listesi oluşturur.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

Doğrudan kullanıcı listesi lisansını alır.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

Üst hesaba ait tüm kullanıcı listesi doğrudan lisanslarını listeler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Doğrudan kullanıcı listesi lisansını günceller.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

UserListGlobalLicenseService

Kullanıcı listesi genel lisanslarını yönetme hizmeti. Silme, UserListGlobalLicenses için desteklenen bir işlem değildir. Arayanlar, lisansı devre dışı bırakmak için lisans durumunu DEVRE DIŞI olarak güncellemelidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

CreateUserListGlobalLicense

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Genel kullanıcı listesi lisansı oluşturur.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Genel kullanıcı listesi lisansını alır.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

Bir kullanıcı listesi genel lisansıyla ilgili tüm müşteri bilgilerini listeler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

Ebeveyn hesabına ait tüm kullanıcı listesi genel lisanslarını listeler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Kullanıcı listesi genel lisansını günceller.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

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

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

UserListService

UserList kaynaklarını yönetme hizmeti.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

UserList oluşturur.

Yetkilendirme üstbilgileri:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üst bilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak isteğin hesabını kullanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

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

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

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

Bir UserList'i siler.

Yetkilendirme üstbilgileri:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üst bilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak isteğin hesabını kullanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

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

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

rpc GetUserList(GetUserListRequest) returns (UserList)

Bir UserList alır.

Yetkilendirme üstbilgileri:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üst bilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak isteğin hesabını kullanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

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

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

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

UserLists'i listeler.

Yetkilendirme üstbilgileri:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üst bilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak isteğin hesabını kullanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

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

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

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

Bir UserList'i günceller.

Yetkilendirme üstbilgileri:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üst bilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak isteğin hesabını kullanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

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

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

AdIdentifiers

Dönüşüm etkinliğini diğer online etkinliklerle (ör. reklam tıklamaları) eşleştirmek için kullanılan tanımlayıcılar ve diğer bilgiler.

Alanlar
session_attributes

string

İsteğe bağlı. Etkinlik ilişkilendirmesi ve modellemesi için oturum özellikleri.

gclid

string

İsteğe bağlı. Bu etkinlikle ilişkilendirilen Google tıklama kimliği (gclid).

gbraid

string

İsteğe bağlı. Uygulama etkinlikleriyle ilişkilendirilen ve iOS 14 veya sonraki sürümü yüklü iOS cihazlardan gelen tıklamalara yönelik tıklama tanımlayıcısı.

wbraid

string

İsteğe bağlı. Web etkinlikleriyle ilişkilendirilen ve iOS 14 veya sonraki sürümü yüklü iOS cihazlardan gelen tıklamalara yönelik tıklama tanımlayıcısı.

landing_page_device_info

DeviceInfo

İsteğe bağlı. Reklamla etkileşimden sonra reklamverenin sitesine yönlendirme sırasında kullanılan cihaz hakkında toplanan bilgiler (varsa).

AddressInfo

Kullanıcının adres bilgileri.

Alanlar
given_name

string

Zorunlu. Kullanıcının verilen (ad) adı, tümü küçük harflerle, noktalama işareti olmadan, başında veya sonunda boşluk olmadan ve SHA-256 olarak karma oluşturma işlemi uygulanmış şekilde.

family_name

string

Zorunlu. Kullanıcının soyadı (tümü küçük harflerle, noktalama işareti olmadan, başında veya sonunda boşluk olmadan ve SHA-256 olarak karma oluşturma işlemi uygulanmış).

region_code

string

Zorunlu. Kullanıcının adresinin ISO-3166-1 alfa-2 cinsinden 2 harfli bölge kodu.

postal_code

string

Zorunlu. Kullanıcının adresinin posta kodu.

Yaş Aralığı

Demografik yaş aralıkları

Sıralamalar
AGE_RANGE_UNSPECIFIED Belirtilmedi.
AGE_RANGE_UNKNOWN Bilinmiyor.
AGE_RANGE_18_24 18-24 yaş aralığında olmalıdır.
AGE_RANGE_25_34 25-34 yaş aralığında
AGE_RANGE_35_44 35-44 yaş arasında
AGE_RANGE_45_54 45-54 yaş aralığında
AGE_RANGE_55_64 55-64 yaş aralığında
AGE_RANGE_65_UP 65 yaş ve üzeri

AudienceMember

Üzerinde işlem yapılacak kitle üyesi.

Alanlar
destination_references[]

string

İsteğe bağlı. Kitle üyesinin hangi Destination'ye gönderileceğini tanımlar.

consent

Consent

İsteğe bağlı. Kullanıcının izin ayarı.

data birleşik alanı. Üzerinde işlem yapılacak tanımlayıcı verilerin türü. data aşağıdakilerden yalnızca biri olabilir:
user_data

UserData

Kullanıcıyı tanımlayan, kullanıcı tarafından sağlanan veriler.

pair_data

PairData

Yayıncı-Reklamveren Kimlik Eşleşmesi (PAIR) kimlikleri.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

mobile_data

MobileData

Kullanıcının mobil cihazlarını tanımlayan veriler.

user_id_data

UserIdData

Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcılarla ilgili veriler.

ppid_data

PpidData

Yayıncı tarafından sağlanan tanımlayıcılarla ilgili veriler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

AwsWrappedKeyInfo

AWS KMS anahtarıyla sarmalanmış bir veri şifreleme anahtarı.

Alanlar
key_type

KeyType

Zorunlu. Verileri şifrelemek için kullanılan algoritma türü.

role_arn

string

Zorunlu. KMS şifre çözme erişimi için üstlenilecek IAM rolünün Amazon Kaynak Adı. arn:{partition}:iam::{account_id}:role/{role_name} biçiminde olmalıdır.

kek_uri

string

Zorunlu. DEK'nin şifresini çözmek için kullanılan AWS KMS anahtarının URI'si. arn:{partition}:kms:{region}:{account_id}:key/{key_id} veya aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id} biçiminde olmalıdır.

encrypted_dek

string

Zorunlu. Base64 kodlu şifrelenmiş veri şifreleme anahtarı.

KeyType

Verileri şifrelemek için kullanılan algoritma türü.

Sıralamalar
KEY_TYPE_UNSPECIFIED Belirtilmemiş anahtar türü. Hiçbir zaman kullanılmamalıdır.
XCHACHA20_POLY1305 Algoritma XChaCha20-Poly1305

Temel

Analizlerin karşılaştırıldığı temel ölçütler.

Alanlar
baseline birleşik alanı. Analizlerin karşılaştırıldığı temel konum. baseline aşağıdakilerden yalnızca biri olabilir:
baseline_location

Location

İsteğin temel konumudur. Temel konum, istenen bölgelerin VEYA listesidir.

location_auto_detection_enabled

bool

Doğru olarak ayarlanırsa hizmet, analizler için temel konumunu otomatik olarak algılamaya çalışır.

Konum

İsteğin temel konumudur. Temel konum, istenen bölgelerin ISO 3166-1 alfa-2 bölge kodlarının OR listesinde yer alıyor.

Alanlar
region_codes[]

string

ISO 3166-1 alfa-2 bölge kodlarının listesi.

CartData

Etkinlikle ilişkili alışveriş sepeti verileri.

Alanlar
merchant_id

string

İsteğe bağlı. Öğelerle ilişkili Merchant Center kimliği.

merchant_feed_label

string

İsteğe bağlı. Öğelerin feed'iyle ilişkili Merchant Center feed etiketi.

merchant_feed_language_code

string

İsteğe bağlı. Öğelerinizin yüklendiği Merchant Center feed'iyle ilişkili ISO 639-1 dil kodu.

transaction_discount

double

İsteğe bağlı. İşlemle ilişkili tüm indirimlerin toplamı.

items[]

Item

İsteğe bağlı. Etkinlikle ilişkili öğelerin listesi.

Kullanıcı için Dijital Pazarlar Yasası (DMA) izin ayarları.

Alanlar
ad_user_data

ConsentStatus

İsteğe bağlı. Kullanıcının reklam kullanıcı verilerine izin verip vermediğini gösterir.

ad_personalization

ConsentStatus

İsteğe bağlı. Kullanıcının reklam kişiselleştirmeye izin verip vermediğini gösterir.

ConsentStatus

Kullanıcının izin verip vermediğini, izni reddedip etmediğini veya izin belirtip belirtmediğini gösterir.

Sıralamalar
CONSENT_STATUS_UNSPECIFIED Belirtilmedi.
CONSENT_GRANTED İzin verildi.
CONSENT_DENIED Reddedildi.

ContactIdInfo

CONTACT_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Alanlar
match_rate_percentage

int32

Yalnızca çıkış. Müşteri Eşleştirme kullanıcı listeleri için eşleşme oranı.

data_source_type

DataSourceType

İsteğe bağlı. Değişmez. Yüklenen verilerin kaynağı

CreatePartnerLinkRequest

PartnerLink kaynağı oluşturma isteği. PartnerLink değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Bu iş ortağı bağlantıları koleksiyonunun sahibi olan üst öğe. Biçim: accountTypes/{account_type}/accounts/{account}

CreateUserListDirectLicenseRequest

UserListDirectLicense kaynağı oluşturma isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisans verilen kullanıcı listesinin sahibi olan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

user_list_direct_license

UserListDirectLicense

Zorunlu. Kullanıcı listesi oluşturmak için doğrudan lisans.

CreateUserListGlobalLicenseRequest

UserListGlobalLicense kaynağı oluşturma isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisans verilen kullanıcı listesinin sahibi olan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

user_list_global_license

UserListGlobalLicense

Zorunlu. Kullanıcı listesi oluşturmak için genel lisans.

CreateUserListRequest

CreateUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Bu kullanıcı listesinin oluşturulacağı üst hesap. Biçim: accountTypes/{account_type}/accounts/{account}

user_list

UserList

Zorunlu. Oluşturulacak kullanıcı listesi.

validate_only

bool

İsteğe bağlı. Doğruysa istek doğrulanır ancak yürütülmez.

ÖzelleştirilebilenDeğişken

Reklam dönüşümleri için özelleştirilebilen değişken.

Alanlar
variable

string

İsteğe bağlı. Ayarlanacak özelleştirilebilen değişkenin adı. Değişken, belirtilen hedef için bulunamazsa yoksayılır.

value

string

İsteğe bağlı. Özelleştirilebilen değişken için depolanacak değer.

destination_references[]

string

İsteğe bağlı. Özel değişkenin Event.destination_references değerlerinden hangisine gönderileceğini belirlemek için kullanılan referans dizesi. Boş bırakılırsa Event.destination_references kullanılır.

CustomerType

Etkinlikle ilişkili müşterinin türü.

Sıralamalar
CUSTOMER_TYPE_UNSPECIFIED Belirtilmemiş CustomerType. Hiçbir zaman kullanılmamalıdır.
NEW Müşteri, reklamveren için yeni olmalıdır.
RETURNING Müşteri, reklamverene geri dönüyorsa
REENGAGED Müşteri, reklamverenle yeniden etkileşime geçmiştir.

CustomerValueBucket

Müşterinin reklamveren tarafından değerlendirilen değeri.

Sıralamalar
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Belirtilmemiş CustomerValueBucket. Hiçbir zaman kullanılmamalıdır.
LOW Müşterinin değeri düşük.
MEDIUM Müşteri, orta değere sahip.
HIGH Müşteri yüksek değere sahip.

DataSourceType

Yüklenen verilerin kaynağını gösterir.

Sıralamalar
DATA_SOURCE_TYPE_UNSPECIFIED Belirtilmedi.
DATA_SOURCE_TYPE_FIRST_PARTY Yüklenen veriler birinci taraf verileridir.
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU Yüklenen veriler, üçüncü taraf kredi bürosuna aittir.
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE Yüklenen veriler, üçüncü taraf seçmen dosyasından alınmıştır.
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA Yüklenen veriler, üçüncü taraf iş ortağı verileridir.

DeletePartnerLinkRequest

PartnerLink kaynağının silinmesi için istek gönderin. google.protobuf.Empty değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Silinecek iş ortağı bağlantısının kaynak adı. Biçim: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

DeleteUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Silinecek kullanıcı listesinin adı. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

validate_only

bool

İsteğe bağlı. Doğruysa istek doğrulanır ancak yürütülmez.

Hedef

Veri gönderdiğiniz Google ürünü. Örneğin, Google Ads hesabı.

Alanlar
reference

string

İsteğe bağlı. Bu Destination kaynağının, istek içinde benzersiz olan kimliği. IngestEventsRequest ve IngestAudienceMembersRequest içinde bu Destination kaynağına başvuruda bulunmak için kullanılır.

login_account

ProductAccount

İsteğe bağlı. Bu API çağrısını yapmak için kullanılan hesap. operating_account adlı kullanıcıya veri eklemek veya bu kullanıcıdan veri kaldırmak için login_account adlı kullanıcının operating_account adlı kullanıcıya yazma erişimi olmalıdır. Örneğin, operating_account yönetici hesabı veya operating_account ile bağlantısı olan bir hesap.

linked_account

ProductAccount

İsteğe bağlı. Arayan kullanıcının login_account, oluşturulmuş bir hesap bağlantısı aracılığıyla erişebildiği bir hesap. Örneğin, bir veri iş ortağının login_account, bir müşterinin linked_account erişebilir. İş ortağı, linked_account hizmetinden başka bir operating_account hizmetine veri göndermek için bu alanı kullanabilir.

operating_account

ProductAccount

Zorunlu. Verilerin gönderileceği veya kaldırılacağı hesap.

product_destination_id

string

Zorunlu. Ürün hesabında verilerin aktarılacağı nesne. Örneğin, Google Ads kitle kimliği, Display & Video 360 kitle kimliği veya Google Ads dönüşüm işlemi kimliği.

DeviceInfo

Etkinlik gerçekleştiğinde kullanılan cihaz hakkında bilgiler (varsa).

Alanlar
user_agent

string

İsteğe bağlı. Belirli bir bağlam için cihazın kullanıcı aracısı dizesi.

ip_address

string

İsteğe bağlı. Belirli bir bağlam için cihazın IP adresi.

Not: Google Ads, Avrupa Ekonomik Alanı (AEA), Birleşik Krallık (UK) veya İsviçre'deki (CH) son kullanıcılar için IP adresi eşleştirmeyi desteklemez. IP adreslerinin bu bölgelerdeki kullanıcılardan paylaşımını koşullu olarak hariç tutmak için mantık ekleyin ve kullanıcılara sitelerinizde, uygulamalarınızda ve diğer mülklerinizde topladığınız verilerle ilgili açık ve kapsamlı bilgiler sağladığınızdan, ayrıca yasalar veya geçerli Google politikaları uyarınca gerekli olduğu durumlarda izin aldığınızdan emin olun. Daha fazla bilgi için Çevrimdışı dönüşümlerin içe aktarılması hakkında başlıklı sayfayı inceleyin.

Kodlama

Karma oluşturma işlemi uygulanmış tanımlayıcı bilgilerin kodlama türü.

Sıralamalar
ENCODING_UNSPECIFIED Belirtilmemiş kodlama türü. Hiçbir zaman kullanılmamalıdır.
HEX Onaltılık kodlama.
BASE64 Base64 kodlaması.

EncryptionInfo

Alınan verilerin şifreleme bilgileri.

Alanlar
wrapped_key birleşik alanı. Verileri şifrelemek için kullanılan sarmalanmış anahtar. wrapped_key aşağıdakilerden yalnızca biri olabilir:
gcp_wrapped_key_info

GcpWrappedKeyInfo

Google Cloud Platform ile ilgili özet bilgiler.

aws_wrapped_key_info

AwsWrappedKeyInfo

Amazon Web Services sarmalanmış anahtar bilgileri.

ErrorCount

Belirli bir hata nedenine ait hata sayısı.

Alanlar
record_count

int64

Belirli bir nedenle yüklenemeyen kayıtların sayısı.

reason

ProcessingErrorReason

Başarısız olan kayıtların hata nedeni.

ErrorInfo

Her hata türü için hata sayısı.

Alanlar
error_counts[]

ErrorCount

Hata listesi ve hata nedenine göre sayı. Bazı durumlarda doldurulmayabilir.

ErrorReason

Data Manager API'nin hata nedenleri. NOT: Bu enum dondurulmamıştır ve gelecekte yeni değerler eklenebilir.

Sıralamalar
ERROR_REASON_UNSPECIFIED Bu varsayılan değeri kullanmayın.
INTERNAL_ERROR Dahili bir hata oluştu.
DEADLINE_EXCEEDED İsteğin yanıtlanması çok uzun sürdü.
RESOURCE_EXHAUSTED Çok fazla istek var.
NOT_FOUND Kaynak bulunamadı.
PERMISSION_DENIED Kullanıcının izni yok veya kaynak bulunamadı.
INVALID_ARGUMENT İstekle ilgili bir sorun vardı.
REQUIRED_FIELD_MISSING Zorunlu alan eksik.
INVALID_FORMAT Biçim geçersiz.
INVALID_HEX_ENCODING Onaltılık olarak kodlanmış değer hatalı biçimlendirilmiş.
INVALID_BASE64_ENCODING Base64 kodlu değer hatalı biçimlendirilmiş.
INVALID_SHA256_FORMAT SHA-256 olarak kodlanmış değer hatalı biçimlendirilmiş.
INVALID_POSTAL_CODE Posta kodu geçerli değil.
INVALID_COUNTRY_CODE Ülke kodu geçerli değil.
INVALID_ENUM_VALUE Enum değeri kullanılamaz.
INVALID_USER_LIST_TYPE Kullanıcı listesi türü bu istek için geçerli değil.
INVALID_AUDIENCE_MEMBER Bu kitle üyesi geçerli değil.
TOO_MANY_AUDIENCE_MEMBERS İstek başına izin verilen maksimum kitle üyesi sayısı 10.000'dir.
TOO_MANY_USER_IDENTIFIERS Hedef kitle üyesi başına izin verilen maksimum kullanıcı tanımlayıcısı sayısı 10'dur.
TOO_MANY_DESTINATIONS İstek başına izin verilen maksimum hedef sayısı 10'dur.
INVALID_DESTINATION Bu hedef geçerli değil.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED Veri iş ortağının, işletme hesabına ait kullanıcı listesine erişimi yoktur.
INVALID_MOBILE_ID_FORMAT Mobil kimlik biçimi geçerli değil.
INVALID_USER_LIST_ID Kullanıcı listesi geçerli değil.
MULTIPLE_DATA_TYPES_NOT_ALLOWED Tek bir istekte birden fazla veri türünün alınmasına izin verilmez.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER Bir DataPartner giriş hesabı içeren hedef yapılandırmaları, tüm hedef yapılandırmalarında aynı giriş hesabına sahip olmalıdır.
TERMS_AND_CONDITIONS_NOT_SIGNED Gerekli hükümler ve koşullar kabul edilmedi.
INVALID_NUMBER_FORMAT Geçersiz numara biçimi.
INVALID_CONVERSION_ACTION_ID Dönüşüm işlemi kimliği geçerli değil.
INVALID_CONVERSION_ACTION_TYPE Dönüşüm işlemi türü geçerli değil.
INVALID_CURRENCY_CODE Para birimi kodu desteklenmiyor.
INVALID_EVENT Bu etkinlik geçerli değil.
TOO_MANY_EVENTS İstek başına izin verilen maksimum etkinlik sayısı 10.000'dir.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Hedef hesapta potansiyel müşteriler için gelişmiş dönüşümler etkinleştirilmemiş.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Google müşteri verileri politikaları nedeniyle hedef hesapta gelişmiş dönüşümler kullanılamıyor. Google temsilcinizle iletişime geçin.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Hedef hesap, gelişmiş dönüşümlerin şartlarını kabul etmemiştir.
DUPLICATE_DESTINATION_REFERENCE İstekteki iki veya daha fazla hedef aynı referansa sahip.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER Veri iş ortağı yetkilendirmesi için desteklenmeyen işletim hesabı.
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER Veri iş ortağı yetkilendirmesi için desteklenmeyen bağlı hesap.
NO_IDENTIFIERS_PROVIDED Etkinlik verileri, kullanıcı tanımlayıcıları veya reklam tanımlayıcıları içermez.
INVALID_PROPERTY_TYPE Mülk türü desteklenmiyor.
INVALID_STREAM_TYPE Akış türü desteklenmiyor.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT Bağlı hesap yalnızca giriş hesabı bir DATA_PARTNER hesabı olduğunda desteklenir.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH Giriş hesabı, söz konusu kullanım alanında kullanılan işletim hesabıyla aynı olmalıdır.
EVENT_TIME_INVALID Etkinlik, kabul edilebilir zaman aralığında gerçekleşmedi.
RESERVED_NAME_USED Parametre, ayrılmış bir ad kullanıyor.
INVALID_EVENT_NAME Etkinlik adı desteklenmiyor.
NOT_ALLOWLISTED Hesap, söz konusu özellik için izin verilenler listesinde değil.
INVALID_REQUEST_ID Bir isteğin durumunu almak için kullanılan istek kimliği geçerli değil. Durum yalnızca başarılı olan ve validate_only=true içermeyen istekler için alınabilir.
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT Bir etkinliğin 2 veya daha fazla Google Analytics hedefi vardı.
FIELD_VALUE_TOO_LONG Alan değeri çok uzun.
TOO_MANY_ELEMENTS İstek listesinde çok fazla öğe var.
ALREADY_EXISTS Kaynak zaten mevcut.
IMMUTABLE_FIELD_FOR_UPDATE Bir güncelleme isteği için değiştirilemez bir alan ayarlanmaya çalışıldı.
INVALID_RESOURCE_NAME Kaynak adı geçersiz.
INVALID_FILTER Sorgu filtresi geçersiz.
INVALID_UPDATE_MASK Güncelleme maskesi geçersiz.
INVALID_PAGE_TOKEN Sayfa jetonu geçersiz.
CANNOT_UPDATE_DISABLED_LICENSE Devre dışı bırakılmış bir lisans güncellenemez.
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST Hassas kullanıcı listeleri bu müşteriye lisanslanamaz.
INSUFFICIENT_COST Bu lisans için maliyet çok düşük.
CANNOT_DISABLE_LICENSE Bayi lisansı kullanıldığı için devre dışı bırakılamaz.
INVALID_CLIENT_ACCOUNT_ID Geçersiz müşteri hesabı kimliği.
PRICING_ONLY_ZERO_COST_ALLOWED Bu müşteri hesabı için sıfır olmayan maliyete izin verilmiyor.
PRICE_TOO_HIGH Bu lisans için maliyet çok yüksek.
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE Müşterinin lisans oluşturmasına izin verilmiyor.
INVALID_PRICING_END_DATE Bu lisans için fiyatlandırma bitiş tarihi geçersiz.
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT Paylaşılan veya lisanslı segment içeren mantıksal kullanıcı listeleri lisanslanamaz.
MISMATCHED_ACCOUNT_TYPE İstekteki müşteri müşterisinin hesap türü, müşterinin gerçek hesap türüyle eşleşmiyor.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE Lisans türü, medya paylaşım maliyetini desteklemiyor.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER Müşteri türü, medya paylaşım maliyetini desteklemiyor.
INVALID_MEDIA_SHARE_COST Geçersiz medya paylaşımı maliyeti.
INVALID_COST_TYPE Geçersiz maliyet türü.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST UserList türü, medya paylaşım maliyetini desteklemez.
MAX_COST_NOT_ALLOWED Maksimum maliyete yalnızca cost_type MEDIA_SHARE için izin verilir.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED Ticari kitle yalnızca doğrudan lisanslanabilir.
INVALID_DESCRIPTION Açıklama geçerli değil.
INVALID_DISPLAY_NAME Görünen ad geçerli değil.
DISPLAY_NAME_ALREADY_USED Görünen ad, hesap için başka bir kullanıcı listesinde zaten kullanılıyor.
OWNERSHIP_REQUIRED_FOR_UPDATE Kullanıcı listesini değiştirmek için sahiplik gerekir.
USER_LIST_MUTATION_NOT_SUPPORTED Kullanıcı listesi türü salt okunurdur ve mutasyonu desteklemez.
SENSITIVE_USER_LIST_IMMUTABLE Gizlilik açısından hassas olan veya yasal olarak reddedilen bir kullanıcı listesi, harici kullanıcılar tarafından değiştirilemez.
BILLABLE_RECORD_COUNT_IMMUTABLE Yeniden pazarlama kullanıcı listesinin faturalandırılabilir kayıt alanı, ayarlandıktan sonra değiştirilemez.
USER_LIST_NAME_RESERVED Kullanıcı listesi adı, sistem listeleri için ayrılmıştır.
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA Reklamverenin, reklamveren tarafından yüklenen verilerden oluşturulan yeniden pazarlama listelerini kullanabilmesi için izin verilenler listesine eklenmesi gerekir.
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE İş ortağı kitle kaynağı, kullanıcı listesi türü için desteklenmiyor.
COMMERCE_PARTNER_NOT_ALLOWED commerce_partner alanının ayarlanması yalnızca partner_audience_source alanı COMMERCE_AUDIENCE ise desteklenir.
UNSUPPORTED_PARTNER_AUDIENCE_INFO partner_audience_info alanı, kullanıcı listesi türü için desteklenmez.
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED İş Ortağı Eşleştirme kullanıcı listeleri yönetici hesapları tarafından oluşturulamaz.
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Veri iş ortağı, THIRD_PARTY_PARTNER_DATA için izin verilenler listesinde değil.
ADVERTISER_TOS_NOT_ACCEPTED Reklamveren, iş ortağının hizmet şartlarını kabul etmemiştir.
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Reklamverenin THIRD_PARTY_PARTNER_DATA için izin verilenler listesinde olmaması.
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT Bu kullanıcı listesi türü bu hesapta desteklenmiyor.
INVALID_COMMERCE_PARTNER commerce_partner alanı geçersiz.
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE Veri sağlayıcının, ticari kitleler oluşturmasına izin verilenler listesinde yer verilmiyor.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES Kullanıcı listesi yükleme anahtarı türleri desteklenmez.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG Alınan kullanıcı listesi bilgisi yapılandırması desteklenmiyor.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE Hesap türleri, kullanıcı listesi türü için desteklenmez.

Etkinlik

Kullanıcının bir reklamverenin web sitesi veya uygulamasıyla etkileşimini temsil eden bir etkinlik.

Alanlar
destination_references[]

string

İsteğe bağlı. Hedefi belirlemek için kullanılan referans dizesi. Boş bırakılırsa etkinlik, istekteki tüm destinations'lara gönderilir.

transaction_id

string

İsteğe bağlı. Bu etkinliğin benzersiz tanımlayıcısı. Birden fazla veri kaynağı kullanan dönüşümler için gereklidir.

event_timestamp

Timestamp

Zorunlu. Etkinliğin gerçekleştiği zaman.

last_updated_timestamp

Timestamp

İsteğe bağlı. Etkinliğin son güncellenme zamanı.

user_data

UserData

İsteğe bağlı. Etkinliğin ilişkilendirildiği kullanıcıyı temsil eden, kullanıcı tarafından sağlanan veri parçaları.

consent

Consent

İsteğe bağlı. İlişkili kullanıcının farklı türlerde izin verip vermediğiyle ilgili bilgiler.

ad_identifiers

AdIdentifiers

İsteğe bağlı. Dönüşüm etkinliğini diğer online etkinliklerle (ör. reklam tıklamaları) eşleştirmek için kullanılan tanımlayıcılar ve diğer bilgiler.

currency

string

İsteğe bağlı. Bu etkinlikteki tüm parasal değerlerle ilişkili para birimi kodu.

event_source

EventSource

İsteğe bağlı. Etkinliğin gerçekleştiği yerle ilgili sinyal (web, uygulama, mağaza vb.).

event_device_info

DeviceInfo

İsteğe bağlı. Etkinlik gerçekleştiğinde kullanılan cihaz hakkında toplanan bilgiler (varsa).

cart_data

CartData

İsteğe bağlı. İşlem ve etkinlikle ilişkili öğeler hakkında bilgiler.

custom_variables[]

CustomVariable

İsteğe bağlı. Dönüşüm kapsayıcılarına (dönüşüm işlemi veya FL etkinliği) gönderilecek ek anahtar/değer çifti bilgileri.

experimental_fields[]

ExperimentalField

İsteğe bağlı. Sonunda API'nin bir parçası olarak tanıtılabilecek deneysel alanlar için anahtar/değer çiftlerinin listesi.

user_properties

UserProperties

İsteğe bağlı. Etkinliğin gerçekleştiği sırada kullanıcı hakkında reklamveren tarafından değerlendirilen bilgiler.

event_name

string

İsteğe bağlı. Etkinliğin adı. GA4 etkinlikleri için gereklidir.

client_id

string

İsteğe bağlı. Bu GA4 web akışı için bir web istemcisinin kullanıcı örneğinin benzersiz tanımlayıcısı.

user_id

string

İsteğe bağlı. Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcı.

additional_event_parameters[]

EventParameter

İsteğe bağlı. Diğer yapılandırılmış alanlar kullanılarak daha önce belirtilmemiş, etkinliğe dahil edilecek tüm etkinlik parametrelerinin bulunduğu bir grup.

conversion_value

double

İsteğe bağlı. Değere dayalı dönüşümler için etkinlikle ilişkili dönüşüm değeri.

EventParameter

GA4 etkinlikleri için etkinlik parametresi.

Alanlar
parameter_name

string

Zorunlu. Kullanılacak parametrenin adı.

value

string

Zorunlu. Ayarlanacak parametrenin değerinin dize gösterimi.

EventSource

Etkinliğin kaynağı.

Sıralamalar
EVENT_SOURCE_UNSPECIFIED Belirtilmemiş EventSource. Hiçbir zaman kullanılmamalıdır.
WEB Etkinlik bir web tarayıcısından oluşturuldu.
APP Etkinlik bir uygulamadan oluşturuldu.
IN_STORE Etkinlik, mağaza içi bir işlemden oluşturuldu.
PHONE Etkinlik, telefon görüşmesinden oluşturuldu.
OTHER Etkinlik, diğer kaynaklardan oluşturuldu.

ExperimentalField

Resmi olmayan alanları temsil eden deneysel alan.

Alanlar
field

string

İsteğe bağlı. Kullanılacak alanın adı.

value

string

İsteğe bağlı. Ayarlanacak alanın değeri.

GcpWrappedKeyInfo

Google Cloud Platform sarmalanmış anahtarı hakkında bilgiler.

Alanlar
key_type

KeyType

Zorunlu. Verileri şifrelemek için kullanılan algoritma türü.

wip_provider

string

Zorunlu. KEK'yi kullanmak için gereken Workload Identity havuzu sağlayıcısı.

kek_uri

string

Zorunlu. Google Cloud Platform Cloud Key Management Service kaynak kimliği. projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} veya gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} biçiminde olmalıdır.

encrypted_dek

string

Zorunlu. Base64 kodlu şifrelenmiş veri şifreleme anahtarı.

KeyType

Verileri şifrelemek için kullanılan algoritma türü.

Sıralamalar
KEY_TYPE_UNSPECIFIED Belirtilmemiş anahtar türü. Hiçbir zaman kullanılmamalıdır.
XCHACHA20_POLY1305 Algoritma XChaCha20-Poly1305

Cinsiyet

Demografik cinsiyet türü (örneğin, kadın).

Sıralamalar
GENDER_UNSPECIFIED Belirtilmedi.
GENDER_UNKNOWN Bilinmiyor.
GENDER_MALE Erkek.
GENDER_FEMALE Kadın.

GetUserListDirectLicenseRequest

UserListDirectLicense kaynağını alma isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Kullanıcı listesi doğrudan lisansının kaynak adı.

GetUserListGlobalLicenseRequest

UserListGlobalLicense kaynağını alma isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Kullanıcı listesi genel lisansının kaynak adı.

GetUserListRequest

GetUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Alınacak UserList'in kaynak adı. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

IngestAudienceMembersRequest

Kitle üyelerinin, sağlanan hedeflere yüklenmesi isteği. IngestAudienceMembersResponse döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Kitle üyelerinin gönderileceği hedeflerin listesi.

audience_members[]

AudienceMember

Zorunlu. Belirtilen hedeflere gönderilecek kullanıcıların listesi. Tek bir istekte en fazla 10.000 AudienceMember kaynağı gönderilebilir.

consent

Consent

İsteğe bağlı. İstek düzeyinde izin, istekteki tüm kullanıcılar için geçerli olur. Kullanıcı düzeyinde izin, istek düzeyinde izni geçersiz kılar ve her AudienceMember içinde belirtilebilir.

validate_only

bool

İsteğe bağlı. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

encoding

Encoding

İsteğe bağlı. UserData yüklemeleri için gereklidir. Kullanıcı tanımlayıcılarının kodlama türü. Karma oluşturulmuş kullanıcı tanımlayıcıları için bu, karma oluşturulmuş dizenin kodlama türüdür. Şifrelenmiş karma kullanıcı tanımlayıcıları için bu, içteki karma dizeyi değil, dıştaki şifrelenmiş dizenin kodlama türüdür. Bu nedenle, içteki karma dize, dıştaki şifrelenmiş dizeden farklı şekilde kodlanabilir. UserData dışındaki yüklemeler için bu alan yoksayılır.

encryption_info

EncryptionInfo

İsteğe bağlı. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için bu alan yoksayılır.

terms_of_service

TermsOfService

İsteğe bağlı. Kullanıcının kabul ettiği/reddettiği hizmet şartları.

IngestAudienceMembersResponse

IngestAudienceMembersRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan kimliği.

IngestEventsRequest

Kitle üyelerinin, sağlanan hedeflere yüklenmesi isteği. IngestEventsResponse döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Etkinliklerin gönderileceği hedeflerin listesi.

events[]

Event

Zorunlu. Belirtilen hedeflere gönderilecek etkinliklerin listesi. Tek bir istekte en fazla 2.000 Event kaynağı gönderilebilir.

consent

Consent

İsteğe bağlı. İstek düzeyinde izin, istekteki tüm kullanıcılar için geçerli olur. Kullanıcı düzeyinde izin, istek düzeyinde izni geçersiz kılar ve her Event içinde belirtilebilir.

validate_only

bool

İsteğe bağlı. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

encoding

Encoding

İsteğe bağlı. UserData yüklemeleri için gereklidir. Kullanıcı tanımlayıcılarının kodlama türü. Karma oluşturulmuş kullanıcı tanımlayıcıları için bu, karma oluşturulmuş dizenin kodlama türüdür. Şifrelenmiş karma kullanıcı tanımlayıcıları için bu, içteki karma dizeyi değil, dıştaki şifrelenmiş dizenin kodlama türüdür. Bu nedenle, içteki karma dize, dıştaki şifrelenmiş dizeden farklı şekilde kodlanabilir. UserData dışındaki yüklemeler için bu alan yoksayılır.

encryption_info

EncryptionInfo

İsteğe bağlı. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için bu alan yoksayılır.

IngestEventsResponse

IngestEventsRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan kimliği.

IngestedUserListInfo

Kullanıcı tarafından sağlanan verilerle doldurulmuş bir kullanıcı listesini temsil eder.

Alanlar
upload_key_types[]

UploadKeyType

Zorunlu. Değişmez. Bu kullanıcı listesinin yükleme anahtarı türleri.

contact_id_info

ContactIdInfo

İsteğe bağlı. CONTACT_ID, upload_key_types'den biri olduğunda ek bilgiler.

mobile_id_info

MobileIdInfo

İsteğe bağlı. MOBILE_ID, upload_key_types'den biri olduğunda ek bilgiler.

user_id_info

UserIdInfo

İsteğe bağlı. USER_ID, upload_key_types'den biri olduğunda ek bilgiler.

pair_id_info

PairIdInfo

İsteğe bağlı. PAIR_ID, upload_key_types'den biri olduğunda ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

pseudonymous_id_info

PseudonymousIdInfo

İsteğe bağlı. PSEUDONYMOUS_ID için ek bilgiler upload_key_types.

partner_audience_info

PartnerAudienceInfo

İsteğe bağlı. İş ortağı kitleleri için ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

UploadKeyType

Bir kullanıcı listesinin olası yükleme anahtarı türlerini içeren sıralama.

Sıralamalar
UPLOAD_KEY_TYPE_UNSPECIFIED Belirtilmedi.
CONTACT_ID E-posta adresi, telefon numarası veya fiziksel adres gibi müşteri bilgileri
MOBILE_ID Mobil reklam kimlikleri.
USER_ID Üçüncü taraf tarafından sağlanan kullanıcı kimlikleri.
PAIR_ID Yayıncı-reklamveren kimlik eşleşmesi kimlikleri.
PSEUDONYMOUS_ID Veri Yönetimi Platformu Kimlikleri: - Google Kullanıcı Kimliği - İş Ortağı Tarafından Sağlanan Kimlik - Yayıncı Tarafından Sağlanan Kimlik - iOS IDFA - Android reklam kimliği - Roku Kimliği - Amazon Fire TV Kimliği - Xbox veya Microsoft Kimliği

Öğe

Etkinlikle ilişkili alışveriş sepetindeki bir öğeyi temsil eder.

Alanlar
merchant_product_id

string

İsteğe bağlı. Merchant Center hesabındaki ürün kimliği.

quantity

int64

İsteğe bağlı. Etkinlikle ilişkilendirilmiş bu öğenin sayısı.

unit_price

double

İsteğe bağlı. Vergi ve kargo ücretinin yanı sıra, işlem düzeyindeki tüm indirimler hariç birim fiyat.

item_id

string

İsteğe bağlı. Öğeye referans vermek için kullanılan benzersiz tanımlayıcı.

additional_item_parameters[]

ItemParameter

İsteğe bağlı. Diğer yapılandırılmış alanlar kullanılarak daha önce belirtilmemiş, etkinliğe dahil edilecek bir öğeyle ilgili tüm etkinlik parametrelerinin bulunduğu bir grup.

ItemParameter

Diğer yapılandırılmış alanlar kullanılarak daha önce belirtilmemiş, etkinliğe dahil edilecek bir öğeyle ilgili tüm etkinlik parametrelerinin bulunduğu bir grup.

Alanlar
parameter_name

string

Zorunlu. Kullanılacak parametrenin adı.

value

string

Zorunlu. Ayarlanacak parametrenin değerinin dize gösterimi.

ListUserListDirectLicensesRequest

Belirli bir hesaptaki tüm UserListDirectLicense kaynaklarını listeleme isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisansları sorgulanan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

filter

string

İsteğe bağlı. Liste isteğine uygulanacak filtreler. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: user_list_id = 123).

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Desteklenmeyen Alanlar:

  • name (Bunun yerine get yöntemini kullanın)
  • historical_pricings ve tüm alt alanları
  • pricing.start_time
  • pricing.end_time
page_size

int32

İsteğe bağlı. Sayfa başına döndürülecek maksimum lisans sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 lisans döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlı. Önceki bir ListUserListDirectLicense çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserListDirectLicense öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListUserListDirectLicensesResponse

ListUserListDirectLicensesRequest tarafından verilen yanıt.

Alanlar
user_list_direct_licenses[]

UserListDirectLicense

İstekteki belirli kullanıcı listesinin lisansları.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

ListUserListGlobalLicenseCustomerInfosRequest

Belirli bir kullanıcı için tüm UserListGlobalLicenseCustomerInfo kaynaklarını listeleme isteğinde bulunun.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Müşteri bilgilerinin sorgulandığı genel lisans. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} biçiminde olmalıdır. Tüm global lisans müşteri bilgilerini bir hesap altında listelemek için kullanıcı listesi global lisans kimliğini "-" ile değiştirin (ör. accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

filter

string

İsteğe bağlı. Liste isteğine uygulanacak filtreler. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: user_list_id = 123).

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Desteklenmeyen Alanlar:

  • name (Bunun yerine get yöntemini kullanın)
  • historical_pricings ve tüm alt alanları
  • pricing.start_time
  • pricing.end_time
page_size

int32

İsteğe bağlı. Döndürülecek maksimum lisans sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 lisans döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlı. Önceki bir ListUserListDirectLicense çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserListDirectLicense öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListUserListGlobalLicenseCustomerInfosResponse

[ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest] yanıtı.

Alanlar
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

İstekteki belirli lisansla ilgili müşteri bilgileri.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

ListUserListGlobalLicensesRequest

Belirli bir hesaptaki tüm UserListGlobalLicense kaynaklarını listeleme isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisansları sorgulanan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

filter

string

İsteğe bağlı. Liste isteğine uygulanacak filtreler. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: user_list_id = 123).

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Desteklenmeyen Alanlar:

  • name (Bunun yerine get yöntemini kullanın)
  • historical_pricings ve tüm alt alanları
  • pricing.start_time
  • pricing.end_time
page_size

int32

İsteğe bağlı. Döndürülecek maksimum lisans sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 lisans döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlı. Önceki bir ListUserListGlobalLicense çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserListDirectLicense öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListUserListGlobalLicensesResponse

ListUserListGlobalLicensesRequest tarafından verilen yanıt.

Alanlar
user_list_global_licenses[]

UserListGlobalLicense

İstekteki belirli kullanıcı listesinin lisansları.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

ListUserListsRequest

ListUserLists için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Bu kullanıcı listeleri koleksiyonunun sahibi olan üst hesap. Biçim: accountTypes/{account_type}/accounts/{account}

page_size

int32

İsteğe bağlı. Döndürülecek maksimum kullanıcı listesi sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 kullanıcı listesi döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlı. Önceki bir ListUserLists çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserLists öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

filter

string

İsteğe bağlı. Filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: display_name = "list 1").

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (var)

Desteklenen alanlar:

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

ListUserLists için yanıt mesajı.

Alanlar
user_lists[]

UserList

Belirtilen hesaptaki kullanıcı listeleri.

next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

MatchRateRange

Yüklemenin veya kullanıcı listesinin eşleşme oranı aralığı.

Sıralamalar
MATCH_RATE_RANGE_UNKNOWN Eşleşme oranı aralığı bilinmiyor.
MATCH_RATE_RANGE_NOT_ELIGIBLE Eşleşme oranı aralığı uygun değil.
MATCH_RATE_RANGE_LESS_THAN_20 Eşleşme oranı aralığı %20'den azdır ([0, 20) aralığında).
MATCH_RATE_RANGE_20_TO_30 Eşleşme oranı aralığı% 20 ile %30 arasındadır ([20, 31) aralığında).
MATCH_RATE_RANGE_31_TO_40 Eşleşme oranı aralığı% 31 ile %40 arasındadır ([31, 41) aralığında).
MATCH_RATE_RANGE_41_TO_50 Eşleşme oranı aralığı% 41 ile %50 arasındadır ([41, 51) aralığında).
MATCH_RATE_RANGE_51_TO_60 Eşleşme oranı aralığı% 51 ile %60 arasındadır ([51, 61) aralığında).
MATCH_RATE_RANGE_61_TO_70 Eşleşme oranı aralığı% 61 ile %70 arasındadır ([61, 71) aralığında).
MATCH_RATE_RANGE_71_TO_80 Eşleşme oranı aralığı% 71 ile %80 arasındadır ([71, 81) aralığında).
MATCH_RATE_RANGE_81_TO_90 Eşleşme oranı aralığı% 81 ile %90 arasındadır ([81, 91) aralığında).
MATCH_RATE_RANGE_91_TO_100

Eşleşme oranı aralığı% 91 ile %100 arasındadır ([91, 100] aralığında).

MobileData

Kitle için mobil kimlikler. En az bir mobil kimlik gereklidir.

Alanlar
mobile_ids[]

string

Zorunlu. Mobil cihaz kimliklerinin (reklam kimliği/IDFA) listesi. Tek bir AudienceMember içinde en fazla 10 mobileIds sağlanabilir.

MobileIdInfo

MOBILE_ID, upload_key_types'den biri olduğunda ek bilgiler.

Alanlar
data_source_type

DataSourceType

İsteğe bağlı. Değişmez. Yüklenen verilerin kaynağı.

key_space

KeySpace

Zorunlu. Değişmez. Mobil kimliklerin anahtar alanı.

app_id

string

Zorunlu. Değişmez. Verilerin toplandığı mobil uygulamayı benzersiz şekilde tanımlayan dize.

KeySpace

Mobil kimlik için anahtar alanı.

Sıralamalar
KEY_SPACE_UNSPECIFIED Belirtilmedi.
IOS iOS anahtar alanı.
ANDROID Android anahtar alanı.

PairData

Kitle için PAIR kimlikleri. En az bir PAIR ID gereklidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
pair_ids[]

string

Zorunlu. PAIR kullanıcı listesi için yayıncı anahtarı kullanılarak SHA256 ile karma oluşturulmuş ve EC değişmeli şifre ile şifrelenmiş, temiz oda tarafından sağlanan kimliği tanımlayabilecek bilgiler verileri. Tek bir AudienceMember içinde en fazla 10 pairIds sağlanabilir.

PairIdInfo

PAIR_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
match_rate_percentage

int32

Yalnızca çıkış. Bu alan, bu kullanıcı listesinin ilgili yayıncının birinci taraf verileriyle eşleşen üyelik yüzdesini gösterir. 0 ile 100 arasında olmalıdır (bu değerler dahil).

advertiser_identifier_count

int64

Yalnızca çıkış. Reklamverenin bir temiz oda sağlayıcısına yüklenen birinci taraf veri kayıtlarının sayısı. Bu, PAIR kullanıcı listesinin boyutunu göstermez.

publisher_id

int64

Zorunlu. Değişmez. Yayıncı-Reklamveren Kimlik Eşleşmesi kullanıcı listesinin eşleştirildiği yayıncıyı tanımlar. Bu alan, temiz oda sağlayıcı tarafından sağlanır ve yalnızca söz konusu temiz oda kapsamında benzersizdir. Bu, birden fazla temiz oda arasında genel tanımlayıcı olarak kullanılamaz.

publisher_name

string

İsteğe bağlı. Daha iyi bir hedefleme deneyimi için kullanıcı arayüzünde gösterilecek yayıncının açıklayıcı adı.

clean_room_identifier

string

Zorunlu. Değişmez. Bir temiz oda sağlayıcısı ile veya birden çok temiz oda sağlayıcısı arasında benzersiz bir reklamveren-yayıncı ilişkisini tanımlar.

PartnerAudienceInfo

İş ortağı kitleleri için ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
partner_audience_source

PartnerAudienceSource

Zorunlu. Değişmez. İş ortağı kitlesinin kaynağı.

commerce_partner

string

İsteğe bağlı. Ticaret iş ortağının adı. Yalnızca partner_audience_source COMMERCE_AUDIENCE ise izin verilir.

PartnerAudienceSource

İş ortağı kitle kaynağı.

Sıralamalar
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED Belirtilmedi.
COMMERCE_AUDIENCE İş ortağı kitle kaynağı, ticari kitlelerdir.
LINEAR_TV_AUDIENCE İş ortağı kitle kaynağı, geleneksel TV kitlesidir.
AGENCY_PROVIDER_AUDIENCE İş ortağı kitlesi kaynağı, ajans/sağlayıcı kitlesidir.

PpidData

PPID'leri içeren yayıncı tarafından sağlanan tanımlayıcılar verileri. En az bir ppid gereklidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
ppids[]

string

Zorunlu. Bir kullanıcı için yayıncı tarafından sağlanan tanımlayıcıların listesi.

ProcessingErrorReason

İşleme hatasının nedeni.

Sıralamalar
PROCESSING_ERROR_REASON_UNSPECIFIED İşleme hatasının nedeni bilinmiyor.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE Özelleştirilebilen değişken geçersiz.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED Özelleştirilebilen değişkenin durumu etkin değil.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD Dönüşüm, desteklenen maksimum yaştan daha eski.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID Aynı GCLID ve dönüşüm zamanına sahip bir dönüşüm zaten sistemde var.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID Aynı sipariş kimliği ve dönüşüm işlemi kombinasyonuna sahip bir dönüşüm zaten yüklenmiş.
PROCESSING_ERROR_REASON_INVALID_GBRAID GBRAID'in kodu çözülemedi.
PROCESSING_ERROR_REASON_INVALID_GCLID Google tıklama kimliğinin kodu çözülemedi.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID Satıcı kimliği, rakam olmayan karakterler içeriyor.
PROCESSING_ERROR_REASON_INVALID_WBRAID WBRAID'in kodu çözülemedi.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Dahili hata.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Gelişmiş dönüşüm şartları hedef hesapta imzalanmamış.
PROCESSING_ERROR_REASON_INVALID_EVENT Etkinlik geçersiz.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS Eşleşen işlemler, minimum eşiğin altında.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS İşlemler, minimum eşiğin altında.
PROCESSING_ERROR_REASON_INVALID_FORMAT Etkinlikte biçim hatası var.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR Etkinlikte şifre çözme hatası var.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR DEK'nin şifresi çözülemedi.
PROCESSING_ERROR_REASON_INVALID_WIP WIP yanlış biçimlendirilmiş veya WIP mevcut değil.
PROCESSING_ERROR_REASON_INVALID_KEK KEK yanlış olduğu veya mevcut olmadığı için verilerin şifresini çözemiyor.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED WIP, onay koşulu tarafından reddedildiği için kullanılamadı.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED Sistem, KEK'ye erişmek için gereken izinlere sahip değildi.
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED Sistem, AWS ile kimlik doğrulaması yapamadı.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR DEK kullanılarak UserIdentifier verilerinin şifresi çözülemedi.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER Kullanıcı, işleten hesabın reklamlarına ait olmayan bir reklam tanımlayıcısıyla etkinlikleri alma girişiminde bulundu.

ProcessingWarningReason

İşleme uyarısının nedeni.

Sıralamalar
PROCESSING_WARNING_REASON_UNSPECIFIED İşleme uyarısı nedeni bilinmiyor.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED Sistem, KEK'ye erişmek için gereken izinlere sahip değildi.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR DEK'nin şifresi çözülemedi.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR Etkinlikte şifre çözme hatası var.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED WIP, onay koşulu tarafından reddedildiği için kullanılamadı.
PROCESSING_WARNING_REASON_INVALID_WIP WIP yanlış biçimlendirilmiş veya WIP mevcut değil.
PROCESSING_WARNING_REASON_INVALID_KEK KEK yanlış olduğu veya mevcut olmadığı için verilerin şifresini çözemiyor.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR DEK kullanılarak UserIdentifier verilerinin şifresi çözülemedi.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Dahili hata.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED Sistem, AWS ile kimlik doğrulaması yapamadı.

Ürün

Kullanımdan kaldırıldı. Bunun yerine AccountType politikasını kullanın. Belirli bir Google ürününü temsil eder.

Sıralamalar
PRODUCT_UNSPECIFIED Belirtilmemiş ürün. Hiçbir zaman kullanılmamalıdır.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni olmanız gerekir.
DATA_PARTNER Veri İş Ortağı

ProductAccount

Belirli bir hesabı temsil eder.

Alanlar
product
(deprecated)

Product

Kullanımdan kaldırıldı. Bunun yerine account_type politikasını kullanın.

account_id

string

Zorunlu. Hesabın kimliği. Örneğin, Google Ads hesap kimliğiniz.

account_type

AccountType

İsteğe bağlı. Hesabın türü. Örneğin, GOOGLE_ADS. account_type veya kullanımdan kaldırılan product gereklidir. Her ikisi de ayarlanmışsa değerler eşleşmelidir.

AccountType

Google Hesabı türlerini gösterir. Hesapları ve hedefleri bulmak için kullanılır.

Sıralamalar
ACCOUNT_TYPE_UNSPECIFIED Belirtilmemiş ürün. Hiçbir zaman kullanılmamalıdır.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni olmanız gerekir.
DATA_PARTNER Veri İş Ortağı
GOOGLE_ANALYTICS_PROPERTY Google Analytics.

PseudonymousIdInfo

PSEUDONYMOUS_ID, upload_key_types'den biri olduğunda ek bilgiler.

Alanlar
sync_status

SyncStatus

Yalnızca çıkış. Kullanıcı listesinin senkronizasyon durumu.

billable_record_count

int64

İsteğe bağlı. Değişmez. Faturalandırılabilir kayıtların sayısı (ör. yüklenen veya eşleşen).

SyncStatus

Kullanıcı listesinin senkronizasyon durumu.

Sıralamalar
SYNC_STATUS_UNSPECIFIED Belirtilmedi.
CREATED Kullanıcı listesi yer tutucu olarak oluşturuldu. Liste içerikleri ve/veya meta veriler hâlâ senkronize ediliyor. Kullanıcı listesi kullanıma hazır değil.
READY_FOR_USE Kullanıcı listesi kullanıma hazır. İçerikler ve çerezler doğru şekilde senkronize edilmiştir.
FAILED Kullanıcı listesi içerikleri ve/veya meta verileri senkronize edilirken bir hata oluştu. Kullanıcı listesi kullanılamaz.

RemoveAudienceMembersRequest

Kullanıcıları, sağlanan hedeflerdeki bir kitleye kaldırma isteği. RemoveAudienceMembersResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Kullanıcıların kaldırılacağı hedeflerin listesi.

audience_members[]

AudienceMember

Zorunlu. Kaldırılacak kullanıcıların listesi.

validate_only

bool

İsteğe bağlı. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

encoding

Encoding

İsteğe bağlı. UserData yüklemeleri için gereklidir. Kullanıcı tanımlayıcılarının kodlama türü. Yalnızca şifrelenmiş kullanıcı tanımlayıcılarının dış kodlaması için geçerlidir. UserData dışındaki yüklemeler için bu alan yoksayılır.

encryption_info

EncryptionInfo

İsteğe bağlı. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için bu alan yoksayılır.

RemoveAudienceMembersResponse

RemoveAudienceMembersRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan kimliği.

RequestStatusPerDestination

Hedef başına bir istek durumu.

Alanlar
destination

Destination

DM API isteğindeki bir hedef.

request_status

RequestStatus

Hedefin istek durumu.

error_info

ErrorInfo

Yüklemeyle ilgili hata nedenini ve hata sayılarını içeren bir hata bilgisi hatası.

warning_info

WarningInfo

Yüklemeyle ilgili uyarı nedenini ve uyarı sayısını içeren bir uyarı bilgisi.

status birleşik alanı. Hedefin durumu. status aşağıdakilerden yalnızca biri olabilir:
audience_members_ingestion_status

IngestAudienceMembersStatus

Kitle üyelerinin alım isteğinin durumu.

events_ingestion_status

IngestEventsStatus

Alma etkinlikleri isteğinin durumu.

audience_members_removal_status

RemoveAudienceMembersStatus

Kitle üyelerini kaldırma isteğinin durumu.

IngestAudienceMembersStatus

Kitle üyelerinin alım isteğinin durumu.

Alanlar
status birleşik alanı. Kitle üyelerinin hedefe aktarılma durumu. status aşağıdakilerden yalnızca biri olabilir:
user_data_ingestion_status

IngestUserDataStatus

Kullanıcı verilerinin hedefe aktarılma durumu.

mobile_data_ingestion_status

IngestMobileDataStatus

Hedefe mobil veri alımının durumu.

pair_data_ingestion_status

IngestPairDataStatus

Hedefe çift veri alımının durumu.

user_id_data_ingestion_status

IngestUserIdDataStatus

Kullanıcı kimliği verilerinin hedefe aktarılma durumu.

ppid_data_ingestion_status

IngestPpidDataStatus

PPID verilerinin hedefe alınma durumu.

IngestEventsStatus

Etkinliklerin hedefe aktarılma durumu.

Alanlar
record_count

int64

Yükleme isteğinde gönderilen etkinliklerin toplam sayısı. Başarıyla alınan veya alınmayan tüm etkinlikleri içerir.

IngestMobileDataStatus

İçeri aktarmayla ilgili istatistikleri içeren hedefe mobil veri alımının durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla yerleştirilip yerleştirilmediklerine bakılmaksızın, istekteki tüm kitle üyelerini içerir.

mobile_id_count

int64

Hedef için yükleme isteğinde gönderilen mobil kimliklerin toplam sayısı. Başarıyla beslenip beslenmediklerine bakılmaksızın, istekteki tüm mobil kimlikleri içerir.

IngestPairDataStatus

İçe aktarma ile ilgili istatistikleri içeren hedefteki çift verilerin içe aktarılma durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla yerleştirilip yerleştirilmediklerine bakılmaksızın, istekteki tüm kitle üyelerini içerir.

pair_id_count

int64

Hedef için yükleme isteğinde gönderilen çift kimliklerinin toplam sayısı. Başarıyla beslenip beslenmediklerine bakılmaksızın, istekteki tüm çift kimliklerini içerir.

IngestPpidDataStatus

PPID verilerinin, almayla ilgili istatistikleri içeren hedefe alınma durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla yerleştirilip yerleştirilmediklerine bakılmaksızın, istekteki tüm kitle üyelerini içerir.

ppid_count

int64

Hedef için yükleme isteğinde gönderilen ppıd'lerin toplam sayısı. Başarıyla alınmış olsun veya olmasın, istekteki tüm ppıd'leri içerir.

IngestUserDataStatus

Kullanıcı verilerinin, alımla ilgili istatistikleri içeren hedefe alınmasının durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla yerleştirilip yerleştirilmediklerine bakılmaksızın, istekteki tüm kitle üyelerini içerir.

user_identifier_count

int64

Hedef için yükleme isteğinde gönderilen kullanıcı tanımlayıcılarının toplam sayısı. Başarıyla alınmış olup olmadıklarına bakılmaksızın, istekteki tüm kullanıcı tanımlayıcılarını içerir.

upload_match_rate_range

MatchRateRange

Yüklemenin eşleşme oranı aralığı.

IngestUserIdDataStatus

Hedefe kullanıcı kimliği verisi alımının durumu (alım ile ilgili istatistikleri içerir).

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla yerleştirilip yerleştirilmediklerine bakılmaksızın, istekteki tüm kitle üyelerini içerir.

user_id_count

int64

Hedef için yükleme isteğinde gönderilen kullanıcı kimliklerinin toplam sayısı. Başarıyla alınmış olup olmadıklarına bakılmaksızın, istekteki tüm kullanıcı kimliklerini içerir.

RemoveAudienceMembersStatus

Kitle üyelerini kaldırma isteğinin durumu.

Alanlar
status birleşik alanı. Kitle üyelerinin hedeften kaldırılma durumu. status aşağıdakilerden yalnızca biri olabilir:
user_data_removal_status

RemoveUserDataStatus

Hedefteki kullanıcı verilerinin kaldırılma durumu.

mobile_data_removal_status

RemoveMobileDataStatus

Mobil verilerin hedeften kaldırılma durumu.

pair_data_removal_status

RemovePairDataStatus

Hedefteki eşleme verilerinin kaldırılma durumu.

user_id_data_removal_status

RemoveUserIdDataStatus

Hedefteki kullanıcı kimliği verilerinin kaldırılma durumu.

ppid_data_removal_status

RemovePpidDataStatus

PPID verilerinin hedeften kaldırılma durumu.

RemoveMobileDataStatus

Mobil verilerin hedeften kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

mobile_id_count

int64

Kaldırma talebinde gönderilen mobil kimliklerin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm mobil kimlikleri içerir.

RemovePairDataStatus

Hedefteki eşleme verilerinin kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

pair_id_count

int64

Kaldırma isteğinde gönderilen eş kimliklerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm çift kimliklerini içerir.

RemovePpidDataStatus

PPID verilerinin hedeften kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

ppid_count

int64

Kaldırma talebinde gönderilen ppıd'lerin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm ppids'leri içerir.

RemoveUserDataStatus

Hedefteki kullanıcı verilerinin kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

user_identifier_count

int64

Kaldırma talebinde gönderilen kullanıcı tanımlayıcılarının toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kullanıcı tanımlayıcılarını içerir.

RemoveUserIdDataStatus

Hedefteki kullanıcı kimliği verilerinin kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

user_id_count

int64

Kaldırma talebinde gönderilen kullanıcı kimliklerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kullanıcı kimliklerini içerir.

RequestStatus

İsteğin durumu.

Sıralamalar
REQUEST_STATUS_UNKNOWN İstek durumu bilinmiyor.
SUCCESS İstek başarılı oldu.
PROCESSING İstek işleniyor.
FAILED İstek gerçekleştirilemedi.
PARTIAL_SUCCESS İstek kısmen başarılı oldu.

RetrieveInsightsRequest

DM API MarketingDataInsightsService.RetrieveInsights için istek mesajı

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Kullanıcı listesinin sahibi olan ebeveyn hesabı. Biçim: accountTypes/{account_type}/accounts/{account}

baseline

Baseline

Zorunlu. İstenen analizlerin temel çizgisi.

user_list_id

string

Zorunlu. Analiz istenen kullanıcı listesinin kimliği.

RetrieveInsightsResponse

DM API MarketingDataInsightsService.RetrieveInsights için yanıt mesajı

Alanlar
marketing_data_insights[]

MarketingDataInsight

Pazarlama verileriyle ilgili analizleri içerir.

MarketingDataInsight

Pazarlama verileriyle ilgili analizler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
dimension

AudienceInsightsDimension

Analizin ait olduğu boyut.

attributes[]

MarketingDataInsightsAttribute

Belirli bir boyutun değerleriyle ilgili analizler.

AudienceInsightsDimension

Analiz oluşturmada kullanılabilecek olası boyutlar.

Sıralamalar
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Belirtilmedi.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Bu sürümde değer bilinmiyor.
AFFINITY_USER_INTEREST Yakın ilgi alanı kullanıcı ilgi alanı.
IN_MARKET_USER_INTEREST Pazardaki bir kullanıcı ilgi alanı.
AGE_RANGE Yaş aralığı
GENDER Cinsiyet.

MarketingDataInsightsAttribute

Aynı boyuttaki ilgili özellikler koleksiyonuyla ilgili analizler.

Alanlar
user_interest_id

int64

Kullanıcı ilgi alanı kimliği.

lift

float

Kitlenin, temel değere kıyasla özellik değeri için sahip olduğu artış ölçüsü. Aralık [0-1].

age_range

AgeRange

Artışın sağlandığı kitlenin yaş aralığı.

gender

Gender

Artışın sağlandığı kitlenin cinsiyeti.

RetrieveRequestStatusRequest

Belirli bir istek kimliği için DM API'ye yapılan isteğin durumunu alma isteği. RetrieveRequestStatusResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
request_id

string

Zorunlu. Zorunlu. Data Manager API isteğinin istek kimliği.

RetrieveRequestStatusResponse

RetrieveRequestStatusRequest tarafından verilen yanıt.

Alanlar
request_status_per_destination[]

RequestStatusPerDestination

Hedef başına istek durumlarının listesi. Durumların sırası, orijinal istekteki hedeflerin sırasıyla eşleşir.

SearchPartnerLinksRequest

PartnerLink kaynaklarının aranması isteği. SearchPartnerLinksResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. İş ortağı bağlantılarının aranacağı hesap. filter belirtilmezse bu hesabın owning_account veya partner_account olduğu tüm iş ortağı bağlantıları döndürülür.

Biçim: accountTypes/{account_type}/accounts/{account}

page_size

int32

Döndürülecek maksimum iş ortağı bağlantısı sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemişse en fazla 10 iş ortağı bağlantısı döndürülür. Maksimum değer 100'dür. 100'ün üzerindeki değerler 100'e zorlanır.

page_token

string

Önceki bir SearchPartnerLinks çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken SearchPartnerLinks öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

filter

string

İsteğe bağlı. Filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: partner_link_id = 123456789).

Desteklenen işlemler:

  • AND
  • =
  • !=

Desteklenen alanlar:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id

Örnek: owning_account.account_type = "GOOGLE_ADS" OR partner_account.account_id = 987654321

SearchPartnerLinksResponse

SearchPartnerLinksRequest tarafından verilen yanıt.

Alanlar
next_page_token

string

Sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

SizeInfo

Bu kullanıcı listesindeki üyelerin farklı hedef ağlardaki tahmini sayısı.

Alanlar
display_network_members_count

int64

Yalnızca çıkış. Google Görüntülü Reklam Ağı'ndaki bu kullanıcı listesinde tahmini üye sayısı.

search_network_members_count

int64

Yalnızca çıkış. google.com alanında bu kullanıcı listesindeki tahmini üye sayısı. Bunlar, Arama Ağı kampanyalarında hedefleme için kullanılabilen üyelerdir.

TargetNetworkInfo

Farklı hedef ağlar için uygunluk bilgileri.

Alanlar
eligible_for_display

bool

Yalnızca çıkış. Bu kullanıcı listesinin Google Görüntülü Reklam Ağı için uygun olduğunu gösterir.

TermsOfService

Kullanıcının kabul ettiği/reddettiği hizmet şartları.

Alanlar
customer_match_terms_of_service_status

TermsOfServiceStatus

İsteğe bağlı. Müşteri Eşleştirme Hizmet Şartları: https://support.google.com/adspolicy/answer/6299717. Bu, UserData veya MobileData öğeleri alınırken kabul edilmelidir. Bu alan, İş Ortağı Eşleştirme kullanıcı listesi için zorunlu değildir.

TermsOfServiceStatus

Arayanın hizmet şartlarını kabul etme veya reddetme kararını gösterir.

Sıralamalar
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Belirtilmedi.
ACCEPTED Arayanın hizmet şartlarını kabul etmeyi seçtiğini gösteren durum.
REJECTED Arayanın hizmet şartlarını reddettiğini gösteren durum.

UpdateUserListDirectLicenseRequest

UserListDirectLicense kaynağının güncellenmesini isteme

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
user_list_direct_license

UserListDirectLicense

Zorunlu. Güncellenecek lisansı belirlemek için lisansların name alanı kullanılır.

update_mask

FieldMask

İsteğe bağlı. Güncellenecek alanların listesi. * özel karakteri desteklenmez ve kullanılması durumunda INVALID_UPDATE_MASK hatası verilir.

UpdateUserListGlobalLicenseRequest

UserListGlobalLicense kaynağının güncellenmesini isteme

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
user_list_global_license

UserListGlobalLicense

Zorunlu. Güncellenecek lisansı belirlemek için lisansların name alanı kullanılır.

update_mask

FieldMask

İsteğe bağlı. Güncellenecek alanların listesi. * özel karakteri desteklenmez ve kullanılması durumunda INVALID_UPDATE_MASK hatası verilir.

UpdateUserListRequest

UpdateUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
user_list

UserList

Zorunlu. Güncellenecek kullanıcı listesi.

Güncellenecek kullanıcı listesini belirlemek için kullanıcı listesinin name alanı kullanılır. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

update_mask

FieldMask

İsteğe bağlı. Güncellenecek alanların listesi.

validate_only

bool

İsteğe bağlı. Doğruysa istek doğrulanır ancak yürütülmez.

UserData

Kullanıcıyı tanımlayan veriler. En az bir tanımlayıcı gereklidir.

Alanlar
user_identifiers[]

UserIdentifier

Zorunlu. Kullanıcının tanımlayıcıları. Aynı türden verilerin birden fazla örneğini (örneğin, birden fazla e-posta adresi) sağlayabilirsiniz. Eşleşme olasılığını artırmak için mümkün olduğunca fazla tanımlayıcı sağlayın. Tek bir AudienceMember veya Event içinde en fazla 10 userIdentifiers sağlanabilir.

UserIdData

Kullanıcı kimliğini içeren kullanıcı kimliği verileri.

Alanlar
user_id

string

Zorunlu. Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcı.

UserIdInfo

USER_ID, upload_key_types'den biri olduğunda ek bilgiler.

Alanlar
data_source_type

DataSourceType

İsteğe bağlı. Değişmez. Yüklenen verilerin kaynağı.

UserIdentifier

Kullanıcı için tek tanımlayıcı.

Alanlar
identifier birleşik alanı. Tam olarak biri belirtilmelidir. identifier aşağıdakilerden yalnızca biri olabilir:
email_address

string

Normalleştirme işleminden sonra SHA-256 karma işlevi kullanılarak karma oluşturma işlemi uygulanmış e-posta adresi.

phone_number

string

Normalleştirme (E164 standardı) işleminden sonra SHA-256 karma işlevi kullanılarak karma oluşturma işlemi uygulanmış telefon numarası.

address

AddressInfo

Kullanıcının adresinin bilinen bileşenleri. Tüm tanımlayıcıların aynı anda eşleştirildiği bir grubu barındırır.

UserList

Kullanıcı listesi kaynağı.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesinin kaynak adı. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

id

int64

Yalnızca çıkış. Kullanıcı listesinin benzersiz kimliği.

read_only

bool

Yalnızca çıkış. Kullanıcının listeyi düzenleyip düzenleyemeyeceğini belirten bir seçenek.

membership_duration

Duration

İsteğe bağlı. Kullanıcının kullanıcı listesinde kalma süresi. Geçerli süreler, 24 saatin (86.400 saniye) tam katlarıdır. 24 saatin tam katı olmayan bir değer girilmesi INVALID_ARGUMENT hatasına neden olur.

access_reason

AccessReason

Yalnızca çıkış. Bu hesaba listeye erişim izni verilmesinin nedeni.

size_info

SizeInfo

Yalnızca çıkış. Bu kullanıcı listesindeki üyelerin farklı hedef ağlardaki tahmini sayısı.

target_network_info

TargetNetworkInfo

İsteğe bağlı. Farklı hedef ağlar için uygunluk bilgileri.

display_name

string

Zorunlu. Kullanıcı listesinin görünen adı.

description

string

İsteğe bağlı. Kullanıcı listesinin açıklaması.

membership_status

MembershipStatus

İsteğe bağlı. Bu kullanıcı listesinin üyelik durumu.

integration_code

string

İsteğe bağlı. Harici sistemden alınan bir kimlik. Kullanıcı listesi satıcıları, sistemlerindeki kimlikleri ilişkilendirmek için bu parametreyi kullanır.

closing_reason

ClosingReason

Yalnızca çıkış. Bu kullanıcı listesi üyelik durumunun kapatılma nedeni.

account_access_status

AccessStatus

İsteğe bağlı. Bu paylaşımın hâlâ etkin olup olmadığını gösterir. Bir kullanıcı listesi hesapla paylaşıldığında bu alan ENABLED olarak ayarlanır. Daha sonra kullanıcı listesi sahibi, paylaşımı iptal edip listeyi DISABLED yapmaya karar verebilir.

user_list_info birleşik alanı. Kullanıcı listesi hakkında ek bilgiler. user_list_info aşağıdakilerden yalnızca biri olabilir:
ingested_user_list_info

IngestedUserListInfo

İsteğe bağlı. Kullanıcı tarafından alınan verilerle doldurulan bir kullanıcı listesini temsil eder.

AccessReason

Olası erişim nedenlerini açıklayan enum veri türü.

Sıralamalar
ACCESS_REASON_UNSPECIFIED Belirtilmedi.
OWNED Kaynak, kullanıcının mülkiyetindedir.
SHARED Kaynak, kullanıcıyla paylaşılır.
LICENSED Kaynak, kullanıcıya lisanslanmıştır.
SUBSCRIBED Kullanıcı, kaynağa abone oldu.
AFFILIATED Kaynak, kullanıcı tarafından erişilebilir.

AccessStatus

Bu istemcinin listeye erişimi olup olmadığını gösterir.

Sıralamalar
ACCESS_STATUS_UNSPECIFIED Belirtilmedi.
ENABLED Erişim etkinleştirilmiş olmalıdır.
DISABLED Erişim devre dışı bırakıldı.

ClosingReason

Kullanıcı listesinin neden kapatıldığını gösterir. Bu enum yalnızca bir liste sistem tarafından otomatik olarak kapatıldığında kullanılır.

Sıralamalar
CLOSING_REASON_UNSPECIFIED Belirtilmedi.
UNUSED Kullanıcı listesi, son zamanlarda hedeflemede kullanılmadığı için kapatıldı. Ayrıntılı bilgi için https://support.google.com/google-ads/answer/2472738 adresine göz atın.

MembershipStatus

Kullanıcı listesinin durumu.

Sıralamalar
MEMBERSHIP_STATUS_UNSPECIFIED Belirtilmedi.
OPEN Açık durum: Kullanıcı listesine üye eklenmeye devam ediliyor ve liste hedeflenebiliyor.
CLOSED Kapalı durumu: Yeni üye eklenmez.

UserListDirectLicense

Doğrudan kullanıcı listesi lisansı.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesi doğrudan lisansının kaynak adı.

user_list_display_name

string

Yalnızca çıkış. Lisans verilen kullanıcı listesinin adı.

Bu alan salt okunurdur.

client_account_display_name

string

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin adı.

Bu alan salt okunurdur.

pricing

UserListLicensePricing

İsteğe bağlı. UserListDirectLicense fiyatlandırması.

historical_pricings[]

UserListLicensePricing

Yalnızca çıkış. Bu kullanıcı listesi lisansının fiyatlandırma geçmişi.

Bu alan salt okunurdur.

metrics

UserListLicenseMetrics

Yalnızca çıkış. Bu lisansla ilgili metrikler

Bu alan salt okunurdur ve yalnızca ListUserListDirectLicenses çağrısında başlangıç ve bitiş tarihleri ayarlanırsa doldurulur.

user_list_id

int64

Değişmez. Lisans verilen kullanıcı listesinin kimliği.

client_account_type

UserListLicenseClientAccountType

Değişmez. Kullanıcı listesinin lisanslandığı müşteri müşterisinin hesap türü.

client_account_id

int64

Değişmez. Kullanıcı listesinin lisanslandığı müşteri müşterisinin kimliği.

status

UserListLicenseStatus

İsteğe bağlı. UserListDirectLicense'ın durumu: ETKİN veya DEVRE DIŞI.

UserListGlobalLicense

Kullanıcı listesi genel lisansı.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesi genel lisansının kaynak adı.

user_list_display_name

string

Yalnızca çıkış. Lisans verilen kullanıcı listesinin adı.

Bu alan salt okunurdur.

pricing

UserListLicensePricing

İsteğe bağlı. UserListGlobalLicense fiyatlandırması.

historical_pricings[]

UserListLicensePricing

Yalnızca çıkış. Bu kullanıcı listesi lisansının fiyatlandırma geçmişi.

Bu alan salt okunurdur.

metrics

UserListLicenseMetrics

Yalnızca çıkış. Bu lisansla ilgili metrikler

Bu alan salt okunurdur ve yalnızca ListUserListGlobalLicenses çağrısında başlangıç ve bitiş tarihleri ayarlanırsa doldurulur.

user_list_id

int64

Değişmez. Lisans verilen kullanıcı listesinin kimliği.

license_type

UserListGlobalLicenseType

Değişmez. Kullanıcı listesinin lisanslandığı müşteri müşterisinin ürün türü.

status

UserListLicenseStatus

İsteğe bağlı. UserListGlobalLicense'ın durumu: ENABLED veya DISABLED.

UserListGlobalLicenseCustomerInfo

Kullanıcı listesi global lisansının müşterisi hakkında bilgiler. Bu, bir müşteri global lisans satın aldığında sistem tarafından otomatik olarak oluşturulur.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesi genel lisans müşterisinin kaynak adı.

user_list_id

int64

Yalnızca çıkış. Lisans verilen kullanıcı listesinin kimliği.

user_list_display_name

string

Yalnızca çıkış. Lisans verilen kullanıcı listesinin adı.

license_type

UserListGlobalLicenseType

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin ürün türü.

status

UserListLicenseStatus

Yalnızca çıkış. UserListDirectLicense'ın durumu: ETKİN veya DEVRE DIŞI.

pricing

UserListLicensePricing

Yalnızca çıkış. UserListDirectLicense fiyatlandırması.

client_account_type

UserListLicenseClientAccountType

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin ürün türü.

client_account_id

int64

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin kimliği.

client_account_display_name

string

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin adı.

historical_pricings[]

UserListLicensePricing

Yalnızca çıkış. Bu kullanıcı listesi lisansının fiyatlandırma geçmişi.

metrics

UserListLicenseMetrics

Yalnızca çıkış. Bu lisansla ilgili metrikler

Bu alan yalnızca ListUserListGlobalLicenseCustomerInfos çağrısında başlangıç ve bitiş tarihleri ayarlanırsa doldurulur.

UserListGlobalLicenseType

Kullanıcı listesi genel lisans türleri.

Sıralamalar
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED UNSPECIFIED.
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER Bayi lisansı.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE DataMart Sell Side lisansı.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE DataMart Buy Side lisansı.

UserListLicenseClientAccountType

Kullanıcı listesi lisansı için bir müşteri hesabının olası ürünü.

Sıralamalar
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN Bilinmiyor.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS Google Ads müşterisi.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni olmanız gerekir.

UserListLicenseMetrics

Kullanıcı listesi lisansıyla ilgili metrikler.

Alanlar
click_count

int64

Yalnızca çıkış. Kullanıcı listesi lisansının tıklama sayısı.

impression_count

int64

Yalnızca çıkış. Kullanıcı listesi lisansının gösterim sayısı.

revenue_usd_micros

int64

Yalnızca çıkış. ABD doları (mikro) cinsinden kullanıcı listesi lisansının geliri.

start_date

int64

Yalnızca çıkış. Metriklerin başlangıç tarihi (dahil) YYYYAAGG biçiminde. Örneğin, 20260102 ifadesi 2 Ocak 2026'yı temsil eder. Filtrede end_date kullanılıyorsa start_date de gereklidir. Filtreye ne start_date ne de end_date dahil edilirse yanıtta UserListLicenseMetrics alanları doldurulmaz.

end_date

int64

Yalnızca çıkış. Metriklerin YYYYAAGG biçimindeki bitiş tarihi (dahil). Örneğin, 20260102 ifadesi 2 Ocak 2026'yı temsil eder. Filtrede start_date kullanılıyorsa end_date de gereklidir. Filtreye ne start_date ne de end_date dahil edilirse yanıtta UserListLicenseMetrics alanları doldurulmaz.

UserListLicensePricing

Kullanıcı listesi lisans fiyatlandırması.

Alanlar
pricing_id

int64

Yalnızca çıkış. Bu fiyatlandırmanın kimliği.

start_time

Timestamp

Yalnızca çıkış. Fiyatlandırmanın başlangıç zamanı.

end_time

Timestamp

İsteğe bağlı. Fiyatlandırmanın bitiş zamanı.

pricing_active

bool

Yalnızca çıkış. Bu fiyatlandırmanın etkin olup olmadığı.

buyer_approval_state

UserListPricingBuyerApprovalState

Yalnızca çıkış. Bu fiyatlandırmanın alıcı onayı durumu.

Bu alan salt okunurdur.

cost_micros

int64

İsteğe bağlı. Model ile ilişkili maliyet, para birimi kodu alanı tarafından belirtilen para biriminde mikro birimler (10^-6) cinsinden. Örneğin, 2000000, currency_code USD ise 2 ABD doları anlamına gelir.

currency_code

string

İsteğe bağlı. Maliyet ve max_cost değerinin belirtildiği para birimi. ISO 4217'de tanımlanan üç harfli bir para birimi kodu olmalıdır.

cost_type

UserListPricingCostType

Değişmez. Bu fiyatlandırmanın maliyet türü.

Yalnızca create işleminde ayarlanabilir. Mevcut bir lisans için güncellenemez.

max_cost_micros

int64

İsteğe bağlı. MEDIA_SHARE maliyet türü kullanıldığında bir ticaret kitlesinden alınabilecek maksimum BGBM. Değer, mikro birimler (10^-6) cinsinden ve currency_code alanı tarafından belirtilen para birimindedir. Örneğin, 2000000, currency_code USD ise 2 ABD doları anlamına gelir.

Bu yalnızca cost_type MEDIA_SHARE olduğunda geçerlidir. cost_type MEDIA_SHARE değilken bu alan ayarlanırsa MAX_COST_NOT_ALLOWED hatası döndürülür. Ayarlanmazsa veya 0 olarak ayarlanırsa sınır yoktur.

UserListPricingBuyerApprovalState

Kullanıcı listesi fiyatlandırması alıcı onayı durumu.

Sıralamalar
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED UNSPECIFIED.
PENDING Kullanıcı listesi istemcisi, kullanıcı listesi sahibi tarafından belirlenen fiyatlandırma şartlarını henüz kabul etmemiştir.
APPROVED Kullanıcı listesi istemcisi, kullanıcı listesi sahibi tarafından belirlenen fiyatlandırma şartlarını kabul etmiştir.
REJECTED Kullanıcı listesi istemcisi, kullanıcı listesi sahibi tarafından belirlenen fiyatlandırma şartlarını reddetti.

UserListPricingCostType

Kullanıcı listesi fiyatlandırması maliyet türü.

Sıralamalar
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED Belirtilmedi.
CPC Tıklama başına maliyet.
CPM Bin gösterim başına maliyet.
MEDIA_SHARE Medya paylaşımı.

UserListLicenseStatus

Kullanıcı listesi lisans durumu.

Sıralamalar
USER_LIST_LICENSE_STATUS_UNSPECIFIED Bilinmiyor.
USER_LIST_LICENSE_STATUS_ENABLED Etkin durum: Kullanıcı listesi için lisanslama işlemi devam ediyor.
USER_LIST_LICENSE_STATUS_DISABLED Etkin değil durumu: Kullanıcı listesi artık lisanslanmıyor.

UserProperties

Etkinliğin gerçekleştiği sırada kullanıcı hakkında reklamveren tarafından değerlendirilen bilgiler. Daha fazla bilgi için https://support.google.com/google-ads/answer/14007601 adresini ziyaret edin.

Alanlar
customer_type

CustomerType

İsteğe bağlı. Etkinlikle ilişkili müşterinin türü.

customer_value_bucket

CustomerValueBucket

İsteğe bağlı. Müşterinin reklamveren tarafından değerlendirilen değeri.

additional_user_properties[]

UserProperty

İsteğe bağlı. Bu etkinlikle ilişkilendirilen kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir grup.

UserProperty

Bu etkinlikle ilişkilendirilen kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir grup.

Alanlar
property_name

string

Zorunlu. Kullanılacak kullanıcı özelliğinin adı.

value

string

Zorunlu. Kullanılacak kullanıcı özelliği değerinin dize gösterimi.

WarningCount

Belirli bir uyarı nedenine ilişkin uyarı sayısı.

Alanlar
record_count

int64

Uyarı içeren kayıtların sayısı.

reason

ProcessingWarningReason

Uyarı nedeni.

WarningInfo

Her uyarı türü için uyarı sayısı.

Alanlar
warning_counts[]

WarningCount

Uyarıların listesi ve uyarı nedenine göre sayıları.