Kaynak Meta Verileri

GoogleAdsFieldService GoogleAdsService Search ve SearchStream yöntemlerinde kullanılabilen kaynaklar, kaynak alanları, segmentasyon anahtarları ve metrikler için kataloğu dinamik olarak istemek üzere kullanabilirsiniz. Katalog, Google Ads API istemcileri tarafından Google Ads sorgu dili ifadelerinin doğrulanması ve oluşturulması için 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 işleminden oluşur:

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

Aşağıdaki örnekte, GoogleAdsFieldService tarafından ad_group kaynağı için döndürülen yanıtın ardından bir istek gösterilmektedir:

İstek

https://googleads.googleapis.com/v22/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

Koşuldaki kaynağa örtülü olarak birleştirilebilen kaynaklar.FROM

metrics

FROM Yan tümcesinde kaynakla birlikte seçilebilecek metrikler. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.

segments

FROM ifadesinde kaynakla birlikte seçilebilen segment anahtarları. Bunlar, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.

selectableWith

Bir kaynak veya segment alanındaki selectableWith özelliği, aynı GAQL sorgusunda seçilebilecek diğer kaynakları, segmentleri veya metrikleri belirtir. Bu özellik, FROM ifadesinde belirtilmeyen bir kaynaktaki veya segmentteki alanları dahil etmek istediğinizde çok önemlidir.

GAQL sorgusu oluştururken:

1.  FROM ifadesindeki kaynak, birincil öğedir. Bu kaynaktaki alanları istediğiniz zaman seçebilirsiniz.
2.  Ayrıca, birincil öğeyle birlikte kullanılabilen uyumlu metrikleri ve segmentleri de seçebilirsiniz.
3.  FROM ifadesi dışındaki herhangi bir kaynak veya segmentten alan eklerseniz bu FROM dışı kaynağın ya da segmentin, sorguda seçilen diğer tüm alanlar, segmentler ve metriklerle uyumlu olduğundan emin olmanız gerekir.

Belirli bir kaynağın (Kaynak A olarak adlandıralım) selectableWith listesi, Kaynak A birincil öğe olmadığında Kaynak A'daki alanlarla birlikte seçilebilecek diğer tüm kaynakları, segmentleri ve metrikleri içerir.

Örnek:

Aşağıdaki örnek sorguyu inceleyin: SELECT ad_group.id, segments.date, campaign.name FROM ad_group

•   FROM ifadesi ad_group değerini belirtir.

•   Bu sorgu ad_group.id (FROM kaynağında), segments.date ve campaign.name öğelerini seçer.

•   campaign.name seçili olduğu ancak campaign, FROM ifadesinde yer almadığı için diğer seçili öğelerle uyumluluğunu doğrulamanız gerekir.

•   Bu sorgunun geçerli olması için campaign kaynağının segments.date (seçilen başka bir alan) ile uyumlu olması gerekir. Bu nedenle, campaign kaynağı için selectableWith özelliğini kontrol etmeniz gerekir. segments.date, campaign'nin selectableWith listesinde yer alıyorsa sorgu geçerlidir.

FROM ifadesinde olmayan bir kaynaktan alan seçerseniz bu kaynağın selectableWith listesi, SELECT ifadesinde bulunan diğer tüm segmentleri ve kaynakları içermelidir.

Meta veri ayrıntıları

Şu düzeylerde GoogleAdsFieldService simgesini kullanarak kataloğu 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.