Kaynak Adları

Ad hiyerarşisi

Search Ads 360 Reporting API'de kullanılan kaynak adları hiyerarşiktir ve Search Ads 360'taki öğelerin organizasyonunu yansıtır. Neredeyse tüm kaynaklar, Customer kaynağının alt kaynaklarıdır. Bu durum, neredeyse her API çağrısının belirli bir Search Ads 360 hesabını hedeflemesi gerektiğini gösterir. Örneğin, kampanyalar, reklam grupları, reklamlar ve anahtar kelimeler, bir kök müşteri kaynağının alt kaynaklarıdır.

Kaynak Kaynak Adı
Müşteri customers/1234567890
Kampanya customers/1234567890/campaigns/8765432109
Reklam Grubu customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

Kaynak kimlikleri

Search Ads 360 Reporting API varlıkları (müşteriler, kampanyalar vb.), API genelinde kaynak adlarıyla ifade edilir. Ancak kaynak adlarının kendilerinin, hiyerarşideki her nesneyi tanımlayan benzersiz sayısal kaynak kimliklerine sahip olabileceğini unutmamak önemlidir. Bu gibi durumlarda, kaynak adını ayrıştırarak bu kaynak kimliklerini ayıklamak ve yeni bir kaynak kimliği oluşturmak faydalı olabilir.

Örneğin, önceki tablodaki AdGroupAd kaynak adını inceleyin:

customers/1234567890/adGroupAds/54321098765~2109876543210

Bu, aşağıdaki gibi ayrı kaynak kimliklerine (koleksiyon kimlikleri ile ayrılmış) ayrılabilir:

Kaynak adı bileşenleri
Kaynak kimlikleri
Müşteri kimliği:
"1234567890"
reklam grubu kimliği:
"54321098765"
reklam grubu reklam kimliği:
"2109876543210"
Koleksiyon kimlikleri
"customers"
"adGroupAds"

Bağımsız kimlikleri ayrıştırmak, reklam grubu reklamının müşterisine (customers/1234567890) veya reklam grubuna (customers/1234567890/adGroupAds/54321098765) referans verecek yeni kaynak adları türetmenize olanak tanır.