Kaynak Meta Verileri

GoogleAdsService Search ve SearchStream yöntemlerinde bulunan kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için katalogu dinamik olarak istemek üzere GoogleAdsFieldService kullanabilirsiniz. Katalog, Google Ads sorgu dili ifadelerinin doğrulanması ve oluşturulması için Google Ads API istemcileri tarafından kullanılabilecek meta veriler sağlar.

Örnek HTTP isteği ve yanıtı

İstek, aşağıdaki URL'de Google Ads API sunucusuna gönderilen bir HTTP GET'den oluşur:

https://googleads.googleapis.com/v19/googleAdsFields/{resource_or_field}

Aşağıda, ad_group kaynağı için GoogleAdsFieldService kaynağından döndürülen yanıtın ardından bir istek örneği verilmiştir:

İstek

https://googleads.googleapis.com/v19/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 örnekte önemli diziler şunlardır:

attributeResources
FROM yan tümcesinde kaynağa dolaylı olarak birleştirilebilecek kaynaklar.
metrics
FROM yan tümcesinde kaynakla birlikte seçilebilecek metrikler. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.
segments
FROM yan tümcesinde kaynakla birlikte seçilebilecek segment anahtarları. Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.
selectableWith
FROM yan tümcesinde değilken belirli bir alanla birlikte seçilebilecek alanlar. Bu özellik yalnızca, FROM yan tümcesinde kaynak tarafından dahil edilmedikleri bir sorguda seçilebilen kaynakları veya segmentleri tanımlarken alakalıdır. Örneğin, ad_group kaynağından ad_group.id ve segments.date'yi seçiyor ve campaign kaynağından özellikleri dahil etmek istiyorsak mevcut segments.date alanının yanında seçildiği için segments.date'nin kampanya için selectableWith özelliğinde yer aldığını kontrol etmemiz gerekir.

Meta veri ayrıntıları

Kataloğu şu düzeylerde GoogleAdsFieldService kullanarak isteyebilirsiniz:

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ı