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. Hemen hemen 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 yansıtır. Örneğin kampanyalar, reklam grupları, reklamlar ve anahtar kelimelerin tümü 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 anılır. Ancak kaynak adlarının, hiyerarşideki her nesneyi tanımlayan benzersiz sayısal kaynak kimliklerine sahip olabileceğini unutmayın. Bu gibi durumlarda, bu kaynak kimliklerini ayıklamak ve yeni bir kaynak kimliği oluşturmak için kaynak adını ayrıştırmak yararlı olabilir.

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

customers/1234567890/adGroupAds/54321098765~2109876543210

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

Kimlikleri tek tek ayrıştırmak, reklam grubunun reklamının müşterisine (customers/1234567890) veya reklam grubuna (customers/1234567890/adGroupAds/54321098765) referans vermek için yeni kaynak adları oluşturmanıza olanak tanır.