Kaynak Meta Verileri

Şunu kullanabilirsiniz: GoogleAdsFieldService kaynak, kaynak alanları, segmentasyon ve dinamik olarak kataloğu isteme GoogleAdsService'ndaki anahtarlar ve metrikler Arama ve SearchStream yöntemleri. Katalogda, kitlenizle ilgili Google Ads API istemcileri tarafından Google Ads Sorgu Dili ifadelerinin doğrulanması ve oluşturulması için kullanılır.

Örnek HTTP isteği ve yanıtı

Not: Örnekte, temel HTTP/JSON isteği kılavuz olarak gösterilmektedir ancak isteklerinizi göndermek için gRPC'ye dayalı istemci kitaplıklarından birini kullanmanız önemle tavsiye edilir.

İstek, aşağıdaki konumda Google Ads API sunucusuna yönelik bir HTTP GET içerir URL:

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

Aşağıda, bir istek örneği verilmiştir. Ardından gelen ad_group kaynağı için GoogleAdsFieldService:

İ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 yan tümcesinde kaynağa dolaylı olarak birleştirilebilecek kaynaklar.

metrics

FROM yan tümcesinde kaynakla birlikte seçilebilecek metrikler. Yalnızca category öğesinin 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 içinde değilken belirli bir alanın yanında seçilebilecek alanlar ifadesini ekleyin. Bu özellik yalnızca kaynakları veya segmentleri tanımlarken kullanılabilir Bunlar, FROM ifadesindeki kaynak kodunu girin. Örneğin, ad_group.id ve ad_group tarih aralığından segments.date ve campaign, segments.date öğesinin selectableWith içinde olup olmadığını kontrol etmemiz gerekir seçildiğinden, bu özellik kampanyanın mevcut segments.date alanı.

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.