Metadane zasobu

Możesz użyć usługi SearchAds360FieldService aby dynamicznie wysyłać żądania do katalogu zasobów, pól zasobów klucze i dane segmentacji dostępne w SearchAds360Service Metody Search i SearchStream. Katalog zawiera metadane, które można wykorzystać używane przez klientów interfejsu Search Ads 360 Reporting API do weryfikacji i tworzenia Search Ads 360 Instrukcje języka zapytań.

Przykładowe żądanie i odpowiedź HTTP

Żądanie składa się z identyfikatora HTTP GET przesyłanego do serwera interfejsu Search Ads 360 Reporting API następujący adres URL:

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

Poniżej znajdziesz przykład żądania, po którym następuje odpowiedź zwrócona z adresu SearchAds360FieldService dla zasobu ad_group:

Żądanie

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

Odpowiedź

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

W tym przykładzie ważne tablice to:

attributeResources

Zasoby, które można domyślnie połączyć z zasobem w narzędziu FROM .

metrics

Dane, które można wybierać z zasobem w FROM . Wartość podawana tylko w przypadku pól, w których category ma wartość RESOURCE.

segments

Segmentuj klucze, które można wybrać z zasobem w klauzuli FROM. Segmentują one dane określone w zapytaniu. Wartość wypełniana tylko w przypadku pól. gdzie category to RESOURCE.

selectableWith

Pola, które można wybierać obok danego pola, jeśli nie znajduje się w FROM . Ten atrybut ma znaczenie tylko przy identyfikowaniu zasobów lub segmentów które można wybrać w zapytaniu, jeśli nie są one uwzględniane przez w klauzuli FROM. Na przykład, jeśli wybierasz ad_group.id i segments.date z ad_group, a chcesz uwzględnić atrybuty z campaign, sprawdź, czy segments.date znajduje się w selectableWith dla kampanii, ponieważ jest on wybierany obok pola obecne pole segments.date.

Szczegóły metadanych

Możesz poprosić o katalog w SearchAds360FieldService na tych stronach: poziomy:

Zasób

Na przykład searchAds360Fields/campaign.

Pole zasobu

Na przykład searchAds360Fields/campaign.name.

Pole podziału na segmenty

Na przykład searchAds360Fields/segments.ad_network_type.

Dane

Na przykład searchAds360Fields/metrics.clicks.

Użyj zapytania, aby uzyskać szczegóły pola

Szczegóły pól można uzyskać, wysyłając zapytanie do

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

Przykład 1: użycie wyrażenia regularnego.

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

Przykład 2. Zapytanie o określone pola, dane lub segmenty.

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