GoogleAdsFieldService
sayesinde GoogleAdsService
Arama ve SearchStream yöntemlerindeki kaynaklar, kaynağın alanları, segmentasyon anahtarları ve metrikleri için katalogu dinamik olarak isteyebilirsiniz. Katalogda, Google Ads API istemcileri tarafından Google Ads Sorgu Dili ifadelerinin doğrulanması ve oluşturulması için kullanılabilecek meta veriler bulunur.
Örnek HTTP isteği ve yanıtı
İstek, aşağıdaki URL'deki Google Ads API sunucusuna yapılan bir HTTP GET
bölümünden oluşur:
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
Aşağıda, ad_group kaynağı için GoogleAdsFieldService
öğesinden döndürülen yanıtın ardından bir istek örneği verilmiştir:
İstek
https://googleads.googleapis.com/v17/googleAdsFields/ad_group
Yanıt
{
"resourceName": "googleAdsFields/ad_group",
"name": "ad_group",
"category": "RESOURCE",
"selectable": false,
"filterable": false,
"sortable": false,
"selectableWith": [
"campaign",
"customer",
"metrics.average_cpc",
"segments.device",
...
],
"attributeResources": [
"customer",
"campaign"
],
"metrics": [
"metrics.conversions",
"metrics.search_budget_lost_impression_share",
"metrics.average_cost",
"metrics.clicks",
...
],
"segments": [
"segments.date",
"segments.ad_network_type",
"segments.device",
...
]
}
Bu örnek için önemli diziler şunlardır:
attributeResources
FROM
ifadesindeki kaynakla dolaylı yoldan birleştirilebilecek kaynaklar.metrics
FROM
ifadesindeki kaynakla birlikte seçilebilecek metriklerdir. Yalnızcacategory
öğesininRESOURCE
olduğu alanlar için doldurulur.segments
FROM
ifadesindeki kaynakla seçilebilen anahtarları segmentlere ayırın. Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızcacategory
değerininRESOURCE
olduğu alanlar için doldurulur.selectableWith
-
FROM
yan tümcesinde olmadığında belirli bir alanın yanında seçilebilen alanlar. Bu özellik yalnızcaFROM
ifadesinde kaynak tarafından dahil edilmeyen sorguda seçilebilen kaynakları veya segmentleri tanımlarken geçerlidir. Örnek olarak,ad_group
alanındanad_group.id
vesegments.date
öğelerini seçer vecampaign
özelliklerini dahil etmek isterseksegments.date
alanının mevcutsegments.date
alanının yanında seçildiği için kampanyanınselectableWith
özelliğinde desegments.date
olduğunu kontrol etmemiz gerekir.
Meta veri ayrıntıları
Aşağıdaki düzeylerde GoogleAdsFieldService
kullanarak katalog isteğinde bulunabilirsiniz:
- Kaynak
- Örneğin,
googleAdsFields/campaign
. - Kaynağın alanı
- Örneğin,
googleAdsFields/campaign.name
. - Segmentasyon alanı
- Örneğin,
googleAdsFields/segments.ad_network_type
. - Metrik
- Örneğin,
googleAdsFields/metrics.clicks
.