Metadatos de recursos

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Puedes usar GoogleAdsFieldService para solicitar de forma dinámica el catálogo de recursos, campos de recursos, claves de segmentación y métricas disponibles en los métodos GoogleAdsService Search y SearchStream. El catálogo proporciona metadatos que los clientes de la API de Google Ads pueden usar para la validación y la construcción de declaraciones del lenguaje de consulta de Google Ads.

Solicitud y respuesta HTTP de muestra

La solicitud consta de un HTTP GET para el servidor de la API de Google Ads en la siguiente URL:

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

El siguiente es un ejemplo de una solicitud seguida de la respuesta que muestra GoogleAdsFieldService para el recurso ad_group:

Solicitud

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

Respuesta

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

Para este ejemplo, los arreglos importantes son los siguientes:

attributeResources
Recursos que se pueden unir de forma implícita al recurso en la cláusula FROM.
metrics
Métricas que están disponibles para seleccionarse con el recurso en la cláusula FROM. Solo se propaga para los campos en los que category es RESOURCE.
segments
Segmenta las claves que se pueden seleccionar con el recurso en la cláusula FROM. Estos segmentan las métricas especificadas en la consulta. Solo se propaga para los campos en los que category es RESOURCE.
selectableWith
Campos que se pueden seleccionar junto con un campo determinado, cuando no está en la cláusula FROM. Este atributo solo es relevante cuando se identifican recursos o segmentos que se pueden seleccionar en una consulta en la que no se incluyen en la cláusula FROM. Por ejemplo, si seleccionamos ad_group.id y segments.date de ad_group, y queremos incluir atributos de campaign, tendremos que verificar que segments.date esté en el atributo selectableWith para la campaña, ya que se selecciona junto con el campo segments.date existente.

Detalles de los metadatos

Puedes solicitar el catálogo mediante el GoogleAdsFieldService en estos niveles:

Recurso
Por ejemplo, googleAdsFields/campaign.
Campo "Recurso"
Por ejemplo, googleAdsFields/campaign.name.
Campo de segmentación
Por ejemplo, googleAdsFields/segments.ad_network_type.
Métrica
Por ejemplo, googleAdsFields/metrics.clicks.