Kaynak Meta Verileri

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ızca category öğesinin RESOURCE 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ızca category değerinin RESOURCE 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ızca FROM ifadesinde kaynak tarafından dahil edilmeyen sorguda seçilebilen kaynakları veya segmentleri tanımlarken geçerlidir. Örnek olarak, ad_group alanından ad_group.id ve segments.date öğelerini seçer ve campaign özelliklerini dahil etmek istersek segments.date alanının mevcut segments.date alanının yanında seçildiği için kampanyanın selectableWith özelliğinde de segments.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.
Önceki
Nesne alma
Sonraki
Telefon görüşmesi yapısı