Kaynak meta verileri

GoogleAdsFieldService (GetGoogleAdsField veya SearchGoogleAdsFields aracılığıyla) kullanarak GoogleAdsService Search ve SearchStream yöntemlerinde kullanılabilen kaynak kataloğunu, kaynak alanlarını, segmentasyon anahtarlarını ve metrikleri dinamik olarak isteyebilirsiniz. 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 yapılan bir HTTP GET işleminden oluşur:

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

Metrikleri segmentlere ayırmadan FROM yan tümcesindeki kaynağa örtülü olarak birleştirilebilen kaynaklar. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.

metrics

FROMKoşulunda kaynakla birlikte seçilebilen metrikler. Yalnızca category değerinin RESOURCE olduğu alanlar için doldurulur.

segments

FROM ifadesinde kaynakla birlikte seçilebilen segment anahtarları (segments.* alanları ve segmentlere ayırma kaynakları). Bu filtreler, sorguda belirtilen metrikleri segmentlere ayırır. Yalnızca category RESOURCE olan alanlar için doldurulur.

selectableWith

Bu kaynak veya segment, FROM ifadesindeki birincil kaynak olmadığında aynı Google Ads Query Language sorgusunda seçilebilen kaynaklar, segmentler veya metrikler.

selectableWith ile uyumluluğu sorgulama

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

Google Ads Sorgu Dili 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 yan tümcesi 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) selectableWith listesi, Kaynak A birincil öğe olmadığında Kaynak A'daki alanlarla birlikte seçilebilen diğer tüm kaynakları, segmentleri ve metrikleri içerir.

Örnek

Şu ö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 değerlerini seçer.
• campaign.name seçili olduğu ancak campaign, FROM maddesinde 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ğının selectableWith özelliğini kontrol etmeniz gerekir. segments.date, campaign'nin selectableWith listesinde varsa sorgu geçerlidir.

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

Meta veri ayrıntıları

Kataloğu GoogleAdsFieldService kullanarak (GetGoogleAdsField ile kaynak adına göre veya SearchGoogleAdsFields ile sorgulayarak) şu GoogleAdsFieldCategory düzeylerde isteyebilirsiniz:

Kaynak (RESOURCE)

Örneğin, googleAdsFields/campaign.

Kaynak özelliği (ATTRIBUTE)

Örneğin, googleAdsFields/campaign.name.

Segmentasyon alanı (SEGMENT)

Örneğin, googleAdsFields/segments.ad_network_type.

Metrik (METRIC)

Örneğin, googleAdsFields/metrics.clicks.