Metadati delle risorse

Puoi utilizzare GoogleAdsFieldService (tramite GetGoogleAdsField o SearchGoogleAdsFields) per richiedere dinamicamente il catalogo di risorse, campi delle risorse, chiavi di segmentazione e metriche disponibili nei metodi GoogleAdsService Search e SearchStream. Il catalogo fornisce metadati che possono essere utilizzati dai client API Google Ads per la convalida e la creazione di istruzioni Google Ads Query Language.

Esempio di richiesta e risposta HTTP

La richiesta è composta da un HTTP GET al server dell'API Google Ads al seguente URL:

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

L'esempio seguente mostra una richiesta seguita dalla risposta restituita da GoogleAdsFieldService per la risorsa ad_group:

Richiesta

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

Risposta

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

In questo esempio, gli array importanti sono:

attributeResources
Risorse che possono essere unite implicitamente alla risorsa nella clausola FROM senza segmentare le metriche. Compilato solo per i campi in cui category è RESOURCE.
metrics
Metriche che possono essere selezionate con la risorsa nella clausola FROM. Compilato solo per i campi in cui category è RESOURCE.
segments
Chiavi di segmentazione (campi segments.* e risorse di segmentazione) che possono essere selezionate con la risorsa nella clausola FROM. Questi segmentano le metriche specificate nella query. Compilato solo per i campi in cui category è RESOURCE.
selectableWith
Risorse, segmenti o metriche che possono essere selezionati nella stessa query Google Ads Query Language quando questa risorsa o questo segmento non è la risorsa principale nella clausola FROM.

Compatibilità delle query con selectableWith

L'attributo selectableWith di un campo di risorsa o segmento specifica altre risorse, segmenti o metriche che possono essere selezionati nella stessa query Google Ads Query Language. Questo attributo è fondamentale quando vuoi includere campi di una risorsa o di un segmento non specificato nella clausola FROM.

Quando crei una query Google Ads Query Language:

  1. La risorsa nella clausola FROM è l'entità principale. Puoi sempre selezionare i campi da questa risorsa.
  2. Puoi anche selezionare metriche e segmenti compatibili disponibili con l'entità principale.
  3. Se includi campi di una risorsa o di un segmento al di fuori della clausola FROM, devi assicurarti che questa risorsa o questo segmento non FROM sia compatibile con tutti gli altri campi, segmenti e metriche selezionati nella query.

L'elenco selectableWith per una risorsa specifica (Risorsa A) contiene tutte le altre risorse, i segmenti e le metriche che possono essere selezionati insieme ai campi della Risorsa A quando quest'ultima non è l'entità principale.

Esempio

Considera questa query di esempio:

SELECT ad_group.id, segments.date, campaign.name FROM ad_group
  • La clausola FROM specifica ad_group.
  • Questa query seleziona ad_group.id (dalla risorsa FROM), segments.date e campaign.name.
  • Poiché campaign.name è selezionato, ma campaign non è presente nella clausola FROM, devi verificarne la compatibilità con altri elementi selezionati.
  • Per garantire che questa query sia valida, la risorsa campaign deve essere compatibile con segments.date (un altro campo selezionato). Pertanto, devi controllare l'attributo selectableWith per la risorsa campaign. Se segments.date è presente nell'elenco selectableWith di campaign, la query è valida.

Se selezioni campi da una risorsa che non si trova nella clausola FROM, l'elenco selectableWith di questa risorsa deve includere tutti gli altri segmenti e risorse presenti nella clausola SELECT.

Dettagli metadati

Puoi richiedere il catalogo utilizzando GoogleAdsFieldService (tramite il nome della risorsa con GetGoogleAdsField o eseguendo una query con SearchGoogleAdsFields) a questi livelli GoogleAdsFieldCategory:

Risorsa (RESOURCE)
Ad esempio, googleAdsFields/campaign.
Attributo della risorsa (ATTRIBUTE)
Ad esempio, googleAdsFields/campaign.name.
Campo di segmentazione (SEGMENT)
Ad esempio, googleAdsFields/segments.ad_network_type.
Metrica (METRIC)
Ad esempio, googleAdsFields/metrics.clicks.
Indietro
Recupero di oggetti
Avanti
Struttura della chiamata