GoogleAdsService
Arama ve SearchStream yöntemlerinde bulunan kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için kataloğu dinamik olarak istemek amacıyla GoogleAdsFieldService
aracını kullanabilirsiniz. Katalogda, Google Ads API müşterileri tarafından Google Ads Query Language 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 sunucusu için bir HTTP GET
içerir:
https://googleads.googleapis.com/v16/googleAdsFields/{resource_or_field}
Aşağıda, bir istek örneği ve ardından ad_group kaynağı için GoogleAdsFieldService
öğesinden döndürülen yanıt verilmiştir:
İstek
https://googleads.googleapis.com/v16/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
yantümcesinde dolaylı olarak kaynağa eklenebilecek kaynaklar.metrics
FROM
yan tümcesindeki kaynakla seçilebilecek metrikler. Yalnızcacategory
öğesininRESOURCE
olduğu alanlar için doldurulur.segments
FROM
yan tümcesindeki kaynakla seçilebilen segment anahtarları. Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızcacategory
öğesininRESOURCE
olduğu alanlar için doldurulur.selectableWith
-
FROM
yantümcesinde değilken belirli bir alanın yanında seçilebilen alanlar. Bu özellik yalnızca,FROM
ifadesindeki kaynak tarafından dahil edilmedikleri bir sorguda seçilebilen kaynakları veya segmentleri tanımlarken kullanılabilir. Örneğin,ad_group
bölümündenad_group.id
vesegments.date
öğelerini seçersek vecampaign
özelliklerini dahil etmek isterseksegments.date
öğesinin mevcutsegments.date
alanının yanında seçildiği için kampanyanınselectableWith
özelliğinde olup olmadığını kontrol etmemiz gerekir.
Meta veri ayrıntıları
Şu düzeylerde GoogleAdsFieldService
öğesini 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
.