Metadata Resource

Anda dapat menggunakan SearchAds360FieldService untuk meminta katalog secara dinamis untuk resource, kolom resource, kunci dan metrik segmentasi yang tersedia di SearchAds360Service Metode Search dan SearchStream. Katalog menyediakan {i>metadata<i} yang dapat digunakan oleh klien Search Ads 360 Reporting API untuk validasi dan pembuatan Search Ads 360 Pernyataan Bahasa Kueri.

Contoh permintaan dan respons HTTP

Permintaan terdiri dari HTTP GET ke server Search Ads 360 Reporting API di URL berikut:

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

Permintaan

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

Respons

{
  "resourceName": "searchAds360Fields/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 di FROM .
metrics
Metrik yang tersedia untuk dipilih dengan resource di FROM . Hanya diisi untuk kolom yang category-nya adalah RESOURCE.
segments
Segmentasikan kunci 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 sumber daya atau segmen yang dapat dipilih dalam kueri yang tidak disertakan oleh resource dalam klausa FROM. Sebagai contoh, jika Anda memilih ad_group.id dan segments.date dari ad_group, dan Anda ingin menyertakan atribut dari campaign, Anda harus memeriksa apakah segments.date berada dalam selectableWith untuk kampanye, karena sedang dipilih bersama kolom segments.date yang ada.

Detail metadata

Anda dapat meminta katalog menggunakan SearchAds360FieldService di level:

Resource
Misalnya, searchAds360Fields/campaign.
Kolom resource
Misalnya, searchAds360Fields/campaign.name.
Kolom segmentasi
Misalnya, searchAds360Fields/segments.ad_network_type.
Metrik
Misalnya, searchAds360Fields/metrics.clicks.

Menggunakan kueri untuk mendapatkan detail kolom

Hal ini memungkinkan untuk mendapatkan detail {i>field<i} dengan mengirim kueri ke

https://searchads360.googleapis.com/v0/searchAds360Fields:search

Contoh 1: Menggunakan ekspresi reguler.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

Contoh 2: Membuat kueri untuk kolom, metrik, atau segmen tertentu.

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )