Metadati delle risorse

Puoi utilizzare GoogleAdsFieldService per richiedere in modo dinamico al catalogo risorse, campi delle risorse, chiavi di segmentazione e metriche disponibili nei metodi GoogleAdsService Ricerca e SearchStream. Il catalogo fornisce metadati che possono essere utilizzati dai client dell'API Google Ads per la convalida e la creazione di istruzioni per il linguaggio di query di Google Ads.

Esempio di richiesta e risposta HTTP

Nota: l'esempio mostra la richiesta HTTP/JSON sottostante come guida, ma ti consigliamo vivamente di utilizzare una delle librerie client basate su gRPC per inviare le tue richieste.

La richiesta è composta da un HTTP GET al server dell'API Google Ads al seguente 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. Compilato solo 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 in cui category è RESOURCE.

selectableWith

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

Dettagli 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.