Metadata Resource

Anda dapat menggunakan GoogleAdsFieldService untuk meminta katalog secara dinamis untuk resource, kolom resource, segmentasi kunci dan metrik yang tersedia di GoogleAdsService Metode Penelusuran dan SearchStream. Katalog menyediakan metadata yang dapat digunakan oleh klien Google Ads API untuk validasi dan pembuatan pernyataan Bahasa Kueri Google Ads.

Contoh permintaan dan respons HTTP

Permintaan terdiri atas HTTP GET ke server Google Ads API pada URL:

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

Berikut ini adalah contoh permintaan yang diikuti dengan respons yang dikembalikan dari GoogleAdsFieldService untuk resource ad_group:

Permintaan

https://googleads.googleapis.com/v17/googleAdsFields/ad_group

Respons

{
  "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",
    ...
  ]
}

Untuk contoh ini, array pentingnya adalah:

attributeResources

Resource yang dapat digabungkan secara implisit ke resource dalam klausa FROM.

metrics

Metrik yang tersedia untuk dipilih dengan resource dalam klausa FROM. Hanya diisi untuk kolom yang category-nya adalah RESOURCE.

segments

Kunci segmen yang dapat dipilih dengan resource dalam klausa FROM. Mengelompokkan metrik yang ditentukan dalam kueri. Hanya diisi untuk kolom dengan category adalah RESOURCE.

selectableWith

Kolom yang dapat dipilih bersama kolom tertentu, jika tidak ada di FROM . Atribut ini hanya relevan saat mengidentifikasi resource atau segmen yang dapat dipilih dalam kueri jika tidak disertakan oleh resource dalam klausa FROM. Sebagai contoh, jika kita memilih ad_group.id dan segments.date dari ad_group, dan kita ingin menyertakan atribut dari campaign, kita perlu memeriksa apakah segments.date ada di selectableWith untuk kampanye, karena sedang dipilih bersama atribut Kolom segments.date.

Detail metadata

Anda dapat meminta katalog menggunakan GoogleAdsFieldService pada tingkat berikut:

Resource

Misalnya, googleAdsFields/campaign.

Kolom resource

Misalnya, googleAdsFields/campaign.name.

Kolom segmentasi

Misalnya, googleAdsFields/segments.ad_network_type.

Metrik

Misalnya, googleAdsFields/metrics.clicks.