Metadati delle risorse

Puoi utilizzare GoogleAdsFieldService per richiedere in modo dinamico il catalogo di risorse, campi delle risorse, Chiavi e metriche disponibili in GoogleAdsService Metodi Search e SearchStream. Il catalogo fornisce metadati che possono essere utilizzati dai client dell'API Google Ads per la convalida e la creazione di istruzioni in 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 indirizzo: URL:

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

Di seguito è riportato un esempio di richiesta seguita dalla risposta restituita da GoogleAdsFieldService per la risorsa ad_group:

Richiesta

https://googleads.googleapis.com/v17/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",
    ...
  ]
}

Per questo esempio, gli array importanti sono:

attributeResources

Risorse che possono essere unite implicitamente alla risorsa nella clausola FROM.

metrics

Metriche disponibili per essere selezionate con la risorsa nella clausola FROM. Solo viene compilato per i campi in cui category è RESOURCE.

segments

Segmenta le chiavi che possono essere selezionate con la risorsa nella clausola FROM. Consentono di segmentare le metriche specificate nella query. Compilato solo per i campi dove category è RESOURCE.

selectableWith

Campi che possono essere selezionati insieme a un determinato campo, quando non in FROM una clausola. Questo attributo è pertinente solo per identificare le risorse o i segmenti che possono essere selezionati in una query se non sono inclusi dalla risorsa nella clausola FROM. Ad esempio, se selezioniamo ad_group.id e segments.date da ad_group e vogliamo includere attributi da campaign, dobbiamo verificare che segments.date sia in selectableWith per la campagna, poiché viene selezionato insieme all'attributo esistente segments.date.

Dettagli dei metadati

Puoi richiedere il catalogo utilizzando GoogleAdsFieldService a questi livelli:

Risorsa

Ad esempio, googleAdsFields/campaign.

Campo della risorsa

Ad esempio, googleAdsFields/campaign.name.

Campo di segmentazione

Ad esempio, googleAdsFields/segments.ad_network_type.

Metrica

Ad esempio, googleAdsFields/metrics.clicks.