Kaynak Meta Verileri

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ızca category öğesinin RESOURCE 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ızca category öğesinin RESOURCE 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ünden ad_group.id ve segments.date öğelerini seçersek ve campaign özelliklerini dahil etmek istersek segments.date öğesinin mevcut segments.date alanının yanında seçildiği için kampanyanın selectableWith ö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.
Önceki
Nesne alma
Sonraki
Telefon görüşmesi yapısı