Descripción general
En estas páginas, se enumeran los recursos que se pueden consultar en la API de Google Ads mediante GoogleAdsService.SearchStream
o GoogleAdsService.Search
. Los nombres de los recursos están vinculados a su propia página. En cada página, se muestran las siguientes listas:
- Artefactos (recursos, segmentos o métricas) que se pueden usar en la misma cláusula SELECT con el recurso
- Recursos atribuidos cuyos campos no segmentarán métricas, cuando se incluyan en las mismas cláusulas SELECT y WHERE de estos campos de recursos
Después de esas listas, se presentan las tablas que contienen nombres de campos de recursos, segmentos y métricas que se pueden incluir en una búsqueda, cuando este recurso se especifica en la cláusula FROM. Cada nombre está vinculado a la tabla que contiene sus metadatos:
category
data type
type URL
filterable
selectable
sortable
repeated
- Filtrable
- En esta fila, se indica si el campo se puede usar en las condiciones de la cláusula
WHERE
de la consulta GAQL. - Se puede seleccionar
- En esta fila, se indica si el campo se puede especificar en la cláusula
SELECT
de la consulta GAQL. - Se puede ordenar
- En esta fila, se indica si el campo se puede ordenar y usar en la cláusula
ORDER BY
de la consulta GAQL. - Repetido
- Esta fila indica si el campo se repite, que se debe controlar como una lista.
Ejemplos de informes
Lista de todos los recursos
Tipos de recursos | |
---|---|
accessibility_bidding_strategy | Representa una vista de las estrategias de oferta que pertenecen al cliente y que se comparten con él. A diferencia de la estrategia de oferta, este recurso incluye estrategias que son propiedad de los administradores del cliente y que se comparten con este, además de estrategias que le pertenecen. Este recurso no proporciona métricas y solo expone un subconjunto limitado de atributos de BidStrategy. |
account_budget | Un presupuesto de la cuenta Contiene información sobre el presupuesto, así como los cambios más recientes en el presupuesto y los cambios propuestos que están pendientes de aprobación. Los cambios propuestos con una aprobación pendiente, si los hay, se encuentran en &end_proposal' Los detalles eficaces sobre el presupuesto se encuentran en campos con el prefijo 'aprobado&'ajustado_' y aquellos sin un prefijo. Debido a que algunos detalles eficaces pueden diferir de lo que el usuario solicitó originalmente (p. ej., el límite de gasto), estas diferencias se yuxtapone a través de los campos &pos39;proposed_', 'approved_' y, posiblemente, 'ajustes_' Este recurso se muta mediante AccountBudgetProposal, y no se puede mutar directamente. Un presupuesto puede tener como máximo una propuesta pendiente en un momento determinado. Se lee a través de pending_proposal. Una vez aprobado, un presupuesto puede estar sujeto a ajustes, como ajustes de crédito. Los ajustes crean diferencias entre los campos "Aprobado" y "Ajustado", que, de lo contrario, serían idénticos. |
account_budget_proposal | Una propuesta de presupuesto a nivel de la cuenta Todos los campos con el prefijo 'propuesto' pueden no aplicarse directamente. Por ejemplo, los límites de inversión propuestos pueden ajustarse antes de su aplicación. Esto es válido si el campo tiene un equivalente aprobado, como p.ej., límites de gasto. Tenga en cuenta que el tipo de propuesta (proposal_type) cambia qué campos son obligatorios y cuáles deben permanecer vacíos. |
account_link [vínculo_cuenta] | Representa la conexión de uso compartido de datos entre una cuenta de Google Ads y otra cuenta. |
grupo_anuncios | Un grupo de anuncios |
anuncio_grupo_anuncios | Un anuncio de grupo de anuncios |
ad_group_ad_asset_combination_view. | Vista del uso de la combinación de elementos de anuncios del grupo de anuncios. Ahora solo admitimos AdGroupAdAssetCombinetionView para anuncios de búsqueda responsivos, con más tipos de anuncios planificados para el futuro. |
ad_group_ad_asset_view. | Un vínculo entre un AdGroupAd y un elemento. Actualmente, solo se admite AdGroupAdAssetView para AppAds. |
ad_group_ad_label [etiqueta_ad_grupo_anuncios] | Es la relación entre un anuncio de un grupo de anuncios y una etiqueta. |
ad_group_asset. | Un vínculo entre un grupo de anuncios y un elemento. |
ad_group_audience_view | Es una vista del público del grupo de anuncios. Incluye datos de rendimiento de las listas de remarketing y de intereses para los anuncios de la Red de Display y YouTube, y las listas de remarketing para anuncios de búsqueda (RLSA), agregadas a nivel del público. |
ad_group_bid_modifier | Representa un modificador de ofertas del grupo de anuncios. |
criterio_del_grupo_anuncios | Criterio del grupo de anuncios: |
personalizado_del_grupo_de_anuncios | Corresponde al valor del personalizador para el personalizador asociado a nivel del grupo de anuncios. |
ad_group_criterion_label | Es la relación entre un criterio de grupo de anuncios y una etiqueta. |
simulación_del_grupo_de_anuncios | La simulación de un criterio del grupo de anuncios. A continuación, se describen las combinaciones admitidas de tipo de canal publicitario, tipo de criterio, tipo de simulación y modificación de la simulación, respectivamente. Operaciones de simulación del grupo de anuncios de hoteles a partir de la versión 5 1. DISPLAY - PALABRA CLAVE - CPC_BID - UNIFORM 2. BÚSQUEDA - PALABRA CLAVE - CPC_BID - UNIFORM 3. SHOPPING - LISTING_GROUP - CPC_BID - UNIFORM 4. HOTEL - LISTING_GROUP - CPC_BID - UNIFORM 5. HOTEL - LISTING_GROUP - PERCENT_CPC_BID - UNIFORM |
personal_grupo_anuncios | Es un valor del personalizador para el personalizador asociado a nivel del grupo de anuncios. |
ad_group_extension_setting | Es una configuración de la extensión del grupo de anuncios. |
feed_grupo_anuncios | Un feed de grupo de anuncios |
ad_group_label [etiqueta_grupo_anuncios] | Es la relación entre un grupo de anuncios y una etiqueta. |
simulación_grupo_anuncios | La simulación de un grupo de anuncios A continuación, se detallan las combinaciones admitidas de tipo de canal publicitario, tipo de simulación y método de modificación de la simulación, respectivamente. 1. BÚSQUEDA - CPC_BID - PREDETERMINADO 2. BÚSQUEDA - CPC_BID - UNIFORM 3. BÚSQUEDA - TARGET_CPA - UNIFORM 4. BÚSQUEDA - TARGET_ROAS - UNIFORM 5. DISPLAY - CPC_BID - PREDETERMINADO 6 DISPLAY - CPC_BID - UNIFORM 7 DISPLAY - TARGET_CPA - UNIFORM |
ad_parameter | Es un parámetro de anuncio que se utiliza para actualizar valores numéricos (como precios o niveles de inventario) en cualquier línea de texto de un anuncio (incluidas las URL). Puede haber un máximo de dos AdParameters por criterio de grupo de anuncios. (Uno con parámetro_índice = 1 y otro con parámetro_índice = 2) En el anuncio, los parámetros se referencian a través de un marcador de posición con el formato {param#:value}". P.ej.: {param1:$17}" |
ad_schedule_view | Una vista de la programación de anuncios resume el rendimiento de las campañas según los criterios de AdSchedule. |
age_range_view [vista_rango_edad] | Una vista de rango de edad. |
elemento | El elemento es parte de un anuncio que se puede compartir entre varios anuncios. Puede ser una imagen (ImageAsset), un video (YoutubeVideoAsset), etc. Los elementos son inmutables y no se pueden quitar. Para detener la publicación de un elemento, quítalo de la entidad que lo usa. |
asset_field_type_view. | Una vista de tipos de campos de elementos. Esta vista registra métricas no contabilizadas en exceso para cada tipo de campo del elemento cuando este se usa como extensión. |
asset_group [grupo_elementos] | Es un grupo de elementos. AssetGroupAsset se usa para vincular un activo al grupo de elementos. AssetGroupSignal se usa para asociar un indicador a un grupo de elementos. |
asset_group_asset | AssetGroupAsset es el vínculo entre un elemento y un grupo de elementos. Agregar un AssetGroupAsset vincula un activo con un grupo de elementos. |
asset_group_listing_group_filter | AssetGroupListingGroupFilter representa un nodo del árbol de filtro de un grupo de fichas en un grupo de elementos. |
asset_group_product_group_view [vista_grupo_producto_grupo] | Vista de un grupo de productos de un grupo de elementos |
asset_group_signal [indicador_grupo_elementos] | AssetGroupSignal representa un indicador en un grupo de elementos. La existencia de un indicador le indica a la campaña de máximo rendimiento quién tiene más probabilidades de generar una conversión. Las campañas de máximo rendimiento utilizan un indicador para buscar personas nuevas con una intención similar o más alta a fin de encontrar conversiones en la Búsqueda, Display, video y mucho más. |
asset_set [conjunto_elemento] | Es un conjunto de elementos que representa una colección de elementos. Use AssetSetAsset para vincular un elemento a este. |
asset_set_asset | AssetSetAsset es la vinculación entre un elemento y un conjunto de elementos. Agregar un AssetSetAsset vincula un activo con un conjunto de elementos. |
público | El público es una opción de segmentación eficaz que le permite mezclar diferentes atributos de segmento, como afinidades y datos demográficos detallados, a fin de crear públicos que representen secciones de sus segmentos objetivo. |
trabajo_por lotes | Una lista de mutaciones que se procesan de forma asíncrona. El usuario sube las mutaciones. Las mutaciones no se pueden leer, y los resultados del trabajo solo se pueden leer con BatchJobService.ListBatchJobResults. |
bidding_data_exclusion. | Representa una exclusión de los datos de ofertas. Consulte información sobre exclusiones de datos en https://support.google.com/google-ads/answer/10370710. |
bidding_SEASONality_Adjustment | Representa un ajuste de estacionalidad de la oferta. Consulta "Acerca de los ajustes de estacionalidad" en https://support.google.com/google-ads/answer/10369906. |
bidding_strategy | Una estrategia de oferta |
simulación_estrategia_ofertas | Simulación de una estrategia de oferta. A continuación, se detallan las combinaciones de tipos y métodos de modificación compatibles. 1. TARGET_CPA: UNIFORM 2. TARGET_ROAS: UNIFORM |
billing_setup | Una configuración de facturación, que asocia una cuenta de pagos y un anunciante Una configuración de facturación es específica de un anunciante. |
call_view [llamada_vista] | Una vista de llamada que incluye datos para el seguimiento de llamadas o de los anuncios solo de llamada. |
campaña | Una campaña. |
campaign_asset | Un vínculo entre una campaña y un activo. |
campaign_asset_set. | CampaignAssetSet es la vinculación entre una campaña y un conjunto de elementos. Si agrega un elemento AssetAssetSet, se vincula un conjunto de elementos con una campaña. |
campaign_audience_view | Vista de un público de la campaña. Incluye datos de rendimiento de las listas de remarketing y de intereses para los anuncios de la Red de Display y YouTube, y las listas de remarketing para anuncios de búsqueda (RLSA), agregadas por criterio de campaña y público. Esta vista solo incluye públicos adjuntos a nivel de la campaña. |
campaign_bid_modifier. | Representa un criterio solo modificable por la oferta a nivel de la campaña. |
campaign_budget | Un presupuesto de la campaña |
campaign_conversion_goal (campaña_conversión_objetivo) | La configuración de oferta de la campaña especificada solo para todas las acciones de conversión con una categoría y un origen que coincidan |
criterio_de_campaña | Un criterio de campaña |
Simulación_criterio_de_campaña | La simulación de un criterio de campaña. A continuación, se detallan las combinaciones admitidas de tipo de canal publicitario, ID de criterio, tipo de simulación y modificación de la simulación, respectivamente. 1. BÚSQUEDA - 30000,30001,30002 - BID_MODIFIER - UNIFORM 2. DISPLAY - 30001 - BID_MODIFIER - UNIFORM |
campaign_customizer. | Es un valor del personalizador para el personalizador personalizado a nivel de la campaña. |
campaign_draft [campaña_borrador] | Un borrador de la campaña. |
campaign_experiment | Un experimento A/B que compara el rendimiento de la campaña de base (el control) y una variación de esa campaña (el experimento). |
campaign_extension_setting | Una configuración de extensión de campaña. |
campaign_feed | Un feed de la campaña |
campaign_group [grupo_campaña] | Un grupo de campañas |
campaign_label [etiqueta_campaña] | Representa una relación entre una campaña y una etiqueta. |
campaign_shared_set | CampaignSharedSets se utiliza para administrar los conjuntos compartidos asociados a una campaña. |
simulación_de_campaña | La simulación de una campaña A continuación, se detallan las combinaciones admitidas de tipo de canal publicitario, tipo de simulación y método de modificación de la simulación, respectivamente. BÚSQUEDA - CPC_BID - UNIFORM SEARCH - CPC_BID - SCALING SEARCH - TARGET_CPA - UNIFORM SEARCH - TARGET_CPA - SCALING SEARCH - TARGET_ROAS - UNIFORM SEARCH - TARGET_IMPRESSION_SHARE - UNIFORM SEARCH - UNI- {/0} |
carrier_constant | Es un criterio de operadores que se puede utilizar en la orientación de la campaña. |
cambiar_evento | Describe el cambio detallado del recurso que se muestra de ciertos tipos de recursos. Se mostrarán los cambios que realizaron los usuarios externos (incluidos los usuarios externos y los usuarios internos que se pueden mostrar externamente) en la IU, la API y las versiones nuevas de Editor en los últimos 30 días. El cambio muestra los valores antiguos de los campos modificados antes del cambio y los valores nuevos inmediatamente después de este. ChangeEvent puede tener un retraso de hasta 3 minutos para reflejar un nuevo cambio. |
cambio_estado | Describe el estado del recurso que se muestra. ChangeStatus podría tener un retraso de hasta 3 minutos para reflejar un nuevo cambio. |
click_view [vista_clic] | Una vista de clics con métricas agregadas a cada nivel de clic, incluidos los clics válidos y los no válidos. En las campañas que no son de Búsqueda, metrics.clicks representa la cantidad de interacciones válidas y no válidas. Las consultas que incluyen ClickView deben tener un filtro que limite los resultados a un día y se pueden solicitar para las fechas desde hace 90 días antes de la hora de la solicitud. |
público_combinado | Describir un recurso para públicos combinados que incluya diferentes públicos |
conversion_action | Una acción de conversión |
conversion_custom_variable | Una variable personalizada de conversión Consulte "Acerca de las variables personalizadas para las conversiones" en https://support.google.com/google-ads/answer/9964350 |
conversion_goal_campaign_config. | Configuración del objetivo de conversión de una campaña. |
conversion_value_rule. | Una regla de valor de conversión |
conversion_value_rule_set [conjunto_regla_valor_conversión] | Se estableció una regla de valor de conversión |
currency_constant | Una constante de moneda. |
público_personalizado | Un público personalizado Esta es una lista de usuarios por interés. |
meta_conversión_personalizada | Es el objetivo de conversión personalizado que puede hacer que las acciones de conversión arbitrarias sean aptas para ofertas. |
interés_personalizado | Es un interés personalizado. Esta es una lista de usuarios por interés. |
cliente | Un cliente. |
customer_asset | Es un vínculo entre un cliente y un activo. |
cliente_cliente | Un vínculo entre un cliente determinado y un cliente cliente. Los ClientClient solo existen para los clientes administradores. Se incluyen todos los clientes clientes indirectos y directos, así como el administrador en sí. |
customer_client_link [vínculo_cliente_cliente] | Representa la relación del cliente con el vínculo. |
customer_conversion_goal (cliente_conversión_objetivo) | Control de oferta para acciones de conversión con una categoría y un origen coincidentes. |
customer_customizeer | Es un valor del personalizador para el personalizador asociado a nivel del cliente. |
configuración_de_extensiones_de_clientes | Una configuración de extensión de cliente. |
feed_cliente | Un feed de cliente |
customer_label [etiqueta_cliente] | Representa una relación entre un cliente y una etiqueta. Es posible que este cliente no tenga acceso a todas las etiquetas adjuntas. Es posible que se muestren etiquetas de cliente adicionales si aumenta los permisos con el método log-customer-id. |
customer_manager_link [vínculo_administrador_cliente] | Representa la relación entre el cliente y el administrador. |
criterio_negativo_con_cliente | Un criterio negativo para las exclusiones a nivel del cliente. |
customer_user_access | Representa el permiso de un solo usuario para un solo cliente. |
customer_user_access_invitation | Represente una invitación a un usuario nuevo en esta cuenta de cliente. |
customizer_attribute | Un atributo del personalizador Utilice CustomerCustomizer, CampaignCustomizer, AdGroupCustomizer o AdGroupCriterionCustomizer para asociar un atributo del personalizador y establecer su valor a nivel del criterio del cliente, la campaña, el grupo de anuncios o el grupo de anuncios, respectivamente. |
detail_placement_view | Vista con métricas agregadas por grupo de anuncios y URL o video de YouTube. |
detalles_demográficos | Un segmento demográfico detallado: una vertical determinada basada en intereses para segmentar sus anuncios para llegar a los usuarios en función de datos biográficos a largo plazo |
display_keyword_view. | Vista de una palabra clave de la Red de Display. |
distance_view [vista_distancia] | Vista de distancia con métricas agregadas por la distancia del usuario a las extensiones de ubicación del anunciante. Cada DistanceBucket incluye todas las impresiones que se encuentran dentro de su distancia y una sola impresión contribuirá a las métricas para todos los DistanceBuckets que incluyen la distancia del usuario. |
domain_category [categoría_dominio] | Una categoría generada automáticamente mediante el rastreo de un dominio. Si una campaña utiliza el DynamicSearchAdsSetting, se generarán categorías del dominio. Para segmentar anuncios a las categorías, utilice WebpageConditionInfo. Consulte https://support.google.com/google-ads/answer/2471185 |
dynamic_search_ads_search_term_view | Una vista de términos de búsqueda de anuncios dinámicos de búsqueda |
expanded_landing_page_view | Vista de una página de destino con métricas agregadas a nivel de la URL final expandida. |
experimento | Un experimento de Google Ads para que los usuarios experimenten los cambios en varias campañas, comparen el rendimiento y apliquen los cambios efectivos. |
experimento_armado | Un experimento de Google Ads para que los usuarios experimenten los cambios en varias campañas, comparen el rendimiento y apliquen los cambios efectivos. |
extension_feed_item | Un elemento del feed de extensión. |
feed | Un feed |
feed_item | Corresponde a un elemento del feed. |
feed_item_set | Representa un conjunto de elementos del feed. El conjunto se puede usar y compartir entre determinadas funciones de los elementos del feed. Por ejemplo, se puede hacer referencia al conjunto en las funciones coincidentes de CustomerFeed, CampaignFeed y AdGroupFeed. |
feed_item_set_link | Representa un vínculo entre un FeedItem y un FeedItemSet. |
target_item_target. | Es una orientación del elemento del feed. |
feed_asignación | Corresponde a una asignación de feed. |
feed_placeholder_view | Vista de marcador de posición de feed. |
gender_view [género_vista] | Una vista de género. |
geo_target_constant | Una constante de segmentación geográfica. |
geografía_geográfica | Una vista geográfica. La Vista geográfica incluye todas las métricas agregadas a nivel del país, una fila por país. Informa las métricas en la ubicación física real del usuario o en un área de interés. Si se usan otros campos de segmento, es posible que obtenga más de una fila por país. |
group_placement_view | Vista de una posición de grupo |
hotel_group_view [vista_grupo_hoteles] | Vista de un grupo de hoteles |
hotel_performance_view. | Una vista del rendimiento del hotel |
hotel_reconciliation. | Conciliación de un hotel Contiene información de conversiones de las reservas de hoteles para conciliar los registros de los anunciantes. Estas filas se pueden actualizar o cancelar antes de la facturación mediante cargas masivas. |
income_range_view. | Una vista de rango de ingresos |
keyword_plan | Un plan del Planificador de palabras clave. Cantidad máxima de planes de palabras clave guardados: 10,000. Si se alcanza el límite, es posible quitar planes. |
keyword_plan_ad_group | Es un grupo de anuncios del Planificador de palabras clave. Cantidad máxima de grupos de anuncios con plan de palabras clave por plan: 200. |
keyword_plan_ad_group_keyword | Una palabra clave del grupo de anuncios del plan de palabras clave. Cantidad máxima de palabras clave del plan de palabras clave por plan: 10,000. |
keyword_plan_campaign | Una campaña del plan de palabras clave. Cantidad máxima de campañas del plan de palabras clave por plan permitidas: 1. |
keyword_plan_campaign_keyword | Una palabra clave de la campaña del plan de palabras clave. Solo se admiten palabras clave negativas para la palabra clave de la campaña. |
keyword_theme_constant | Una constante del tema de palabras clave de las campañas inteligentes. |
keyword_view | Vista de palabras clave |
label | Una etiqueta |
landing_page_view | Vista de una página de destino con métricas agregadas a nivel de la URL final no expandida. |
language_constant. | Un idioma. |
datos_del_envío_por_formulario | Datos de los envíos de formularios de clientes potenciales |
life_event [evento_de_vida] | Un acontecimiento: Una vertical en particular basada en intereses que se orienta a los usuarios cuando se encuentran en medio de eventos importantes de la vida. |
location_view [vista_ubicación] | Una vista de ubicación resume el rendimiento de las campañas según los criterios de ubicación. |
managed_placement_view | Una vista de posición gestionada |
media_file | Un archivo multimedia |
mobile_app_category_constant | Una constante de la categoría de aplicación para dispositivos móviles. |
mobile_device_constant. | Una constante de dispositivos móviles |
Offline_user_data_job | Un trabajo que contiene datos de los usuarios sin conexión de visitantes de una tienda, o miembros de la lista de usuarios que se procesarán de forma asíncrona. Los datos subidos no se pueden leer, y los resultados de procesamiento del trabajo solo se pueden leer con GoogleAdsService.Search/SearchStream. |
Operating_system_version_constant | Una versión del sistema operativo para dispositivos móviles o una variedad de versiones, según operator_type Consulte la lista de plataformas móviles disponibles en https://developers.google.com/google-ads/api/reference/data/codes-formats#mobile-platforms. |
view_organic_search_term_view | Una vista de términos de búsqueda orgánica pagada que proporciona una vista de las estadísticas de búsqueda en los anuncios y las fichas orgánicas agregadas por término de búsqueda a nivel del grupo de anuncios. |
parent_status_view. | Una vista de estado parental. |
product_bidding_category_constant. | Una categoría de oferta de producto |
product_group_view [vista_grupo_producto] | Vista de un grupo de productos |
recommendation | Una recomendación. |
remarketing_action. | Una acción de remarketing Un fragmento de código JavaScript que recopilará el ID del producto y el tipo de página visitada (página del producto, página del carrito de compras, página de compra o visita general al sitio) en un sitio web del anunciante |
search_term_view | Una vista de términos de búsqueda con métricas agregadas por término de búsqueda a nivel del grupo de anuncios. |
criterio_compartido | Criterio que pertenece a un conjunto compartido. |
shared_set | Los conjuntos compartidos se usan para compartir exclusiones de criterios en varias campañas. |
shopping_performance_view. | Vista del rendimiento de Shopping. Proporciona estadísticas agregadas de las campañas de Shopping en varios niveles de dimensiones de productos. Los valores de las dimensiones de Merchant Center, como la marca, la categoría, los atributos personalizados, la condición del producto y el tipo de producto, reflejarán el estado de cada dimensión a partir de la fecha y hora en que se registró el evento correspondiente. |
smart_campaign_search_term_view | Una vista de términos de búsqueda de las campañas inteligentes |
parámetro_campaña_inteligente | Configuración para configurar campañas inteligentes. |
third_party_app_analytics_link | Una conexión de uso compartido de datos que permite importar estadísticas de aplicaciones de terceros a un cliente de Google Ads |
tema_constante | Utilice temas para segmentar o excluir posiciones en la Red de Display de Google según la categoría en la que se encuentra la posición (por ejemplo, Mascotas, Animales/Mascotas/Perros). |
topic_view [vista_tema] | Vista de temas. |
usuario_interés | Un interés de usuario: una vertical en particular basada en intereses para la orientación. |
user_list | Una lista de usuarios. Esta es una lista de usuarios a los que puede orientar un cliente. |
user_location_view. | Una vista de la ubicación del usuario La Vista de ubicaciones del usuario incluye todas las métricas agregadas a nivel del país, una fila por país. Informa las métricas en la ubicación física real del usuario por ubicación de segmentación o no. Si se usan otros campos de segmento, es posible que obtenga más de una fila por país. |
video | Un video |
webpage_view | Vista de una página web |