Kaynak Adları

Ad hiyerarşisi

Search Ads 360 Reporting API'de kullanılan kaynak adları hiyerarşiktir ve Search Ads 360 içindeki varlıkların düzenini yansıtır. Kaynakların neredeyse tamamı, Customer kaynağının alt kaynaklarıdır. Bu kaynak, 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, kök müşteri kaynağının alt kaynaklarıdır.

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

Kaynak kimlikleri

Search Ads 360 Raporlama API'si varlıklarına (müşteriler, kampanyalar vb.), API'de kaynak adları tarafından atıfta bulunulur. Ancak kaynak adlarının, hiyerarşideki her nesneyi tanımlayan benzersiz sayısal kaynak kimlikleri olabileceğini unutmayın. Bu gibi durumlarda, bu kaynak kimliklerini almak ve yeni bir kimlik oluşturmak için kaynak adını ayrıştırmak yararlı olabilir.

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

customers/1234567890/adGroupAds/54321098765~2109876543210

Bu, aşağıdaki gibi bağımsız kaynak kimliklerine (koleksiyon kimlikleriyle 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"

Kimliklerin ayrı ayrı ayrıştırılması, reklam grubu reklamının müşterisine (customers/1234567890) veya reklam grubuna (customers/1234567890/adGroupAds/54321098765) başvuruda bulunacak yeni kaynak adları türetmenize olanak tanır.