Metadatos del recurso

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

Ejemplo de solicitud y respuesta HTTP

Nota: El ejemplo muestra la solicitud HTTP/JSON subyacente como guía, pero te recomendamos que uses una de las bibliotecas cliente basadas en gRPC para enviar tus solicitudes.

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

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

En el siguiente ejemplo, se muestra una solicitud seguida de la respuesta que devuelve GoogleAdsFieldService para el recurso ad_group:

Solicitud

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

En este ejemplo, los arrays importantes son los siguientes:

attributeResources

Recursos que se pueden unir de forma implícita al recurso en la cláusula FROM.

metrics

Son las métricas que se pueden seleccionar con el recurso en la cláusula FROM. Solo se completa para los campos en los que category es RESOURCE.

segments

Son las claves de segmentación que se pueden seleccionar con el recurso en la cláusula FROM. Estos segmentos dividen 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án en la cláusula FROM. Este atributo solo es relevante cuando se identifican recursos o segmentos que se pueden seleccionar en una búsqueda en la que el recurso no los incluye en la cláusula FROM. Por ejemplo, si seleccionamos ad_group.id y segments.date de ad_group, y queremos incluir atributos de campaign, deberemos verificar que segments.date esté en el atributo selectableWith de la campaña, ya que se selecciona junto con el campo segments.date existente.

Detalles de los metadatos

Puedes solicitar el catálogo con GoogleAdsFieldService en los siguientes niveles:

Recurso

Por ejemplo, googleAdsFields/campaign.

Campo del recurso

Por ejemplo, googleAdsFields/campaign.name.

Campo de segmentación

Por ejemplo, googleAdsFields/segments.ad_network_type.

Métrica

Por ejemplo, googleAdsFields/metrics.clicks.