Métadonnées de ressources

Vous pouvez utiliser GoogleAdsFieldService pour demander dynamiquement les ressources, les champs de ressources, la segmentation clés et métriques disponibles dans le GoogleAdsService Search et SearchStream. Le catalogue fournit des métadonnées qui peuvent être utilisé par les clients de l'API Google Ads pour valider et créer des instructions en langage de requête Google Ads.

Exemple de requête et de réponse HTTP

La demande consiste en un HTTP GET envoyé au serveur de l'API Google Ads à l'adresse URL:

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

Voici un exemple de requête suivie de la réponse renvoyée par GoogleAdsFieldService pour la ressource ad_group:

Requête

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

Réponse

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

Pour cet exemple, les tableaux importants sont les suivants:

attributeResources

Ressources pouvant être associées implicitement à la ressource dans la clause FROM.

metrics

Métriques pouvant être sélectionnées avec la ressource dans la clause FROM. Uniquement renseigné pour les champs où category est défini sur RESOURCE.

segments

Segmentez les clés pouvant être sélectionnées avec la ressource dans la clause FROM. Ceux-ci segmentent les métriques spécifiées dans la requête. Renseigné uniquement pour les champs où category est RESOURCE.

selectableWith

Champs pouvant être sélectionnés à côté d'un champ donné, lorsqu'ils ne se trouvent pas dans la section FROM . Cet attribut n'est pertinent que pour identifier des ressources ou des segments pouvant être sélectionnés dans une requête alors qu'ils ne sont pas inclus ressource dans la clause FROM. Par exemple, si nous sélectionnons ad_group.id et segments.date de ad_group, et nous voulons inclure les attributs de campaign, nous devons vérifier que segments.date se trouve dans selectableWith pour la campagne, car il est sélectionné avec l'attribut segments.date.

Détails des métadonnées

Vous pouvez demander le catalogue à l'aide de GoogleAdsFieldService aux niveaux suivants:

Ressource

Par exemple : googleAdsFields/campaign.

Champ de la ressource

Par exemple : googleAdsFields/campaign.name.

Champ de segmentation

Par exemple : googleAdsFields/segments.ad_network_type.

Métrique

Par exemple : googleAdsFields/metrics.clicks.