Ressourcenmetadaten

Sie können SearchAds360FieldService verwenden um Ressourcen, Ressourcenfelder, Segmentierungsschlüssel und Messwerte in SearchAds360Service verfügbar Search- und SearchStream-Methoden. Der Katalog enthält Metadaten, die Sie werden von Search Ads 360 Reporting API-Clients zur Validierung und Erstellung von Search Ads 360 verwendet. Anweisungen der Abfragesprache

Beispiel für eine HTTP-Anfrage und -Antwort

Die Anfrage besteht aus einer HTTP GET an den Search Ads 360 Reporting API-Server am folgende URL:

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

Das folgende Beispiel zeigt eine Anfrage, gefolgt von der vom SearchAds360FieldService für Ressource ad_group:

Anfrage

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

Antwort

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

In diesem Beispiel sind die folgenden Arrays wichtig:

attributeResources
Ressourcen, die implizit mit der Ressource im FROM verknüpft werden können Klausel.
metrics
Messwerte, die mit der Ressource in FROM ausgewählt werden können Klausel. Wird nur für Felder ausgefüllt, in denen category den Wert RESOURCE hat.
segments
Segmentschlüssel, die mit der Ressource in der FROM-Klausel ausgewählt werden können. Damit werden die in der Abfrage angegebenen Messwerte segmentiert. Nur für Felder ausgefüllt Dabei ist category RESOURCE.
selectableWith
Felder, die zusammen mit einem bestimmten Feld ausgewählt werden können, wenn sie nicht im FROM Klausel. Dieses Attribut ist nur für die Identifizierung von Ressourcen oder Segmenten relevant. die in einer Abfrage ausgewählt werden können, wo sie nicht vom Ressource in der FROM-Klausel. Wenn Sie beispielsweise ad_group.id auswählen und segments.date aus ad_group und Sie möchten Attribute aus campaign müssen Sie prüfen, ob sich segments.date im selectableWith-Attribut für die Kampagne, da es zusammen mit dem vorhandenes segments.date-Feld.

Metadatendetails

Sie können den Katalog mit der SearchAds360FieldService hier anfordern: Stufen:

Ressource
Beispiel: searchAds360Fields/campaign.
Feld der Ressource
Beispiel: searchAds360Fields/campaign.name.
Segmentierungsfeld
Beispiel: searchAds360Fields/segments.ad_network_type.
Messwert
Beispiel: searchAds360Fields/metrics.clicks.

Felddetails mit einer Abfrage abrufen

Sie können Felddetails abrufen, indem Sie eine Abfrage an

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

Beispiel 1: Verwendung eines regulären Ausdrucks.

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

Beispiel 2: Bestimmte Felder, Messwerte oder Segmente abfragen

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"
  )