Descubre y obtén estadísticas sobre los creadores de YouTube con la función de estadísticas de creadores
en ContentCreatorInsightsService.
Este servicio ayuda a las agencias y los anunciantes a encontrar creadores que sean relevantes para su público objetivo.
La API tiene cuatro funciones principales:
- Visibilidad de creadores: Encuentra creadores relevantes para un conjunto determinado de temas, datos demográficos, públicos o atributos de creadores.
- Estadísticas de temas de creadores: Obtén estadísticas sobre creadores relevantes que generan contenido sobre temas específicos.
- Estadísticas de creadores: Obtén estadísticas sobre canales de YouTube específicos, como su recuento de suscriptores, el recuento de vistas y los datos demográficos del público.
- Estadísticas de tendencias: Obtén estadísticas sobre tendencias específicas, según públicos o temas específicos.
El descubrimiento de creadores locales (encontrar creadores que se encuentran en un país determinado o que publican desde allí, y que se ven en ese país) se admite cuando se usa el descubrimiento de creadores basado en temas o las estadísticas de tendencias solicitando datos complementarios. También puedes solicitar estadísticas de opinión sobre la marca para las estadísticas de tendencias basadas en temas solicitando datos complementarios.
Requisitos de elegibilidad
GenerateCreatorInsights es un componente privado de la API de Google Ads que se ofrece con una licencia de datos no exclusiva y libre de regalías. Los socios que firmaron el acuerdo pueden usar las bibliotecas cliente de Google Ads estándar para explorar los creadores y el contenido de YouTube. Para poder participar, los socios deben cumplir con las siguientes condiciones:
- Tener una herramienta de planificación o una interfaz de usuario que integre la API de Google Ads
- Usa la API para explorar el contenido y los creadores de YouTube en busca de posibles oportunidades publicitarias.
- Completa una evaluación de preselección para verificar la elegibilidad.
- Sigue los requisitos de uso de datos y sométete a auditorías de datos periódicas.
- Acepta las condiciones del servicio de la API de Google Ads y la política de uso de datos asociada.
Comunícate con tu representante de Google para obtener más información.
Genera estadísticas de creadores
Para generar estadísticas de creadores, envía una solicitud al método GenerateCreatorInsights. Este método tiene un límite de 5 consultas por segundo (QPS). Acepta diferentes criterios según si deseas visibilidad de creadores, búsqueda de creadores por tema o estadísticas de creadores específicas de un canal. Debes proporcionar las ubicaciones de los países de segmentación
en country_locations.
Visibilidad de los creadores (
search_attributes): Proporciona una lista de atributos del público, como la edad, el género y los intereses de los usuarios (públicos afines, en el mercado y de acontecimientos personales), con el camposearch_attributespara encontrar creadores cuyos públicos coincidan con esos atributos. También puedes proporcionar atributos de creador para filtrar los creadores cuyo contenido coincida con atributos específicos.Recupera los atributos de público disponibles con
ListAudienceInsightsAttributesespecificando las dimensiones que necesitas, comoKNOWLEDGE_GRAPHpara los temas de interés. Para combinar atributos con grupos booleanosANDyOR, usaaudience_combinationscomo se describe en Combinaciones de públicos complejas.Estadísticas de temas de creadores (
search_topics): Proporciona una lista de temas de contenido con el camposearch_topics. La API devuelve creadores pertinentes que generan contenido sobre los temas especificados. Los datos se recuperan para el país especificado encountry_locations(esta opción admite un solo país por solicitud).Las entidades admitidas en
search_topicsdeben etiquetarse con la capacidadCONTENT_TRENDING_INSIGHTSoCREATOR_TOPIC_INSIGHTS. UsaListAudienceInsightsAttributespara recuperar las capacidades de las entidades compatibles.Estadísticas de creadores (
search_channels): Proporciona una lista de IDs de canales de YouTube, identificadores de canales de YouTube (youtube_channel_handles, disponibles env25y versiones posteriores) o una combinación de ambos con el camposearch_channels. La API devuelve estadísticas sobre esos canales específicos.
Combinaciones de públicos complejas
Tanto en GenerateCreatorInsights como en GenerateTrendingInsights, puedes definir
relaciones complejas de atributos de público con audience_combinations. Este campo te permite combinar atributos de público con lógica booleana (AND y OR) más allá del comportamiento de unión plana (OR) de audience_attributes:
- Cada
InsightsAudienceAttributeGroupdentro deaudience_combinationscombina sus atributos con unORlógico. - Varios elementos
InsightsAudienceAttributeGroupenaudience_combinationsse combinan con unANDlógico.
Por ejemplo, para segmentar tus anuncios para un público interesado en ("Skin care" OR "Hair
care") AND "Cosmetics", incluye dos elementos InsightsAudienceAttributeGroup en audience_combinations:
- El grupo 1 contiene los atributos de la entidad del Gráfico de conocimiento para
"Skin care"y"Hair care". - El grupo 2 contiene el atributo de entidad del Gráfico de conocimiento para
"Cosmetics"(como/m/014trl).
Datos complementarios y creadores locales
De forma predeterminada, solo se devuelven los datos de las estadísticas principales. Puedes solicitar funciones opcionales
y datos adicionales en tu respuesta configurando el campo repetido
supplemental_data.
Por ejemplo, puedes solicitar datos del creador local agregando el valor de enumeración LOCAL_CREATOR_DATA a supplemental_data. Si buscas creadores con search_topics (y el tema es una entidad de Gráfico de conocimiento etiquetada con la función CREATOR_TOPIC_INSIGHTS), la API completa el campo local_creator_insights de la respuesta con creadores locales que aceptaron compartir sus datos de ubicación.
Ten en cuenta las siguientes especificaciones para el descubrimiento de creadores locales:
- Definición: Los creadores locales son aquellos que residen en el país seleccionado o publican contenido desde allí, y cuyos videos se miran en ese país.
- Restricción: El descubrimiento de creadores locales no se admite cuando se establece
sub_country_locationsen la solicitud. - Capacidades: Puedes recuperar la lista de entidades de Gráfico de conocimiento admitidas y sus capacidades con
ListAudienceInsightsAttributes.
El método GenerateCreatorInsights devuelve un objeto GenerateCreatorInsightsResponse que contiene los siguientes campos:
creator_insights: Es una lista de objetosYouTubeCreatorInsightsque coinciden con tus criterios principales.local_creator_insights: Es una lista de objetosYouTubeCreatorInsightspara creadores locales. Este campo solo se completa si se solicitóLOCAL_CREATOR_DATAy el criterio usado fuesearch_topics.
Cada objeto YouTubeCreatorInsights contiene lo siguiente:
creator_name: Es el nombre del creador.creator_channels: Es una lista de objetosYouTubeChannelInsights. Los detalles del canal ychannel_metrics(YouTubeMetrics) se devuelven dentro de cada objetoYouTubeChannelInsightsencreator_channels.
El objeto YouTubeMetrics contiene lo siguiente:
- Recuentos de suscriptores, vistas y videos
- Recuentos totales de Me gusta, veces compartido y comentarios en todos los videos del canal
- Tasa de participación histórica (participación total dividida por las vistas totales)
- Promedio de vistas, Me gusta, veces compartido y comentarios por video en los últimos 28 días
- Recuentos de vistas y videos de Shorts
- Si el creador es un creador de Shorts activo o un creador de transmisiones en vivo activo (publicó un video en los últimos 90 días)
- Oportunidades de asociación
La tasa de participación y el promedio de vistas, Me gusta y comentarios por video son métricas no públicas que se completan solo cuando el creador acepta compartirlas.
Para verificar si un creador cumple con los requisitos para participar en asociaciones de contenido de marca original, inspecciona partnership_opportunities. El creador cumple con los requisitos si la lista contiene CREATOR_PARTNERSHIPS.
El objeto YouTubeChannelInsights contiene la siguiente información sobre un
canal de YouTube:
- Nombre del canal, ID, nombre de usuario, URL, descripción y URL de la miniatura
- Fecha de creación del canal y país asociado
- Métricas de canales
- Atributos del público del canal (como el desglose por edad, género e intereses de los usuarios)
- Atributos del canal (los atributos asociados con el contenido del canal)
- Videos más exitosos
- Tipo de canal e idiomas del contenido
- Puntuación de relevancia (solo para búsquedas de tendencias de temas)
- Si el creador dio su consentimiento para compartir métricas no públicas
Referencia de solicitud y respuesta de GenerateCreatorInsights
Llama a GenerateCreatorInsights en ContentCreatorInsightsService en el siguiente extremo:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
En la siguiente tabla, se resumen los campos de
GenerateCreatorInsightsRequest:
| Ruta del campo | Requisito | Formato y restricciones |
|---|---|---|
customer_id |
Obligatorio | Es el ID de cliente de 10 dígitos (string) sin guiones. |
customer_insights_group |
Obligatorio | Nombre definido por el usuario (string) del cliente o la marca para los que se realiza la planificación. |
country_locations[] |
Obligatorio | Es una lista de objetos LocationInfo de países (geo_target_constant, como "geoTargetConstants/2840"). Debe contener un solo país cuando se usa search_topics. |
sub_country_locations[] |
Opcional | Filtros de subpaís LocationInfo; solo se admiten con search_attributes y no son compatibles con LOCAL_CREATOR_DATA. |
search_attributes |
criteria (oneof) |
SearchAttributes que contiene lo siguiente:• audience_attributes[]: age_range, gender, device, parental_status, income_range (además de user_interest, entity o category cuando no se usa audience_combinations).• audience_combinations[]: AND-of-ORs InsightsAudienceAttributeGroup elementos.• creator_attributes[]: Son elementos de entity del Gráfico de conocimiento con la capacidad CREATOR_ATTRIBUTE. |
search_topics |
criteria (oneof) |
SearchTopics que contiene entities[] (AudienceInsightsEntity con knowledge_graph_machine_id etiquetado con CREATOR_TOPIC_INSIGHTS o CONTENT_TRENDING_INSIGHTS). |
search_channels |
criteria (oneof) |
YouTubeChannels que contengan youtube_channels[] (channel_id) o youtube_channel_handles[] (identificadores que comiencen con @, como "@youtubecreators"). |
supplemental_data[] |
Opcional | Valores de ContentCreatorInsightsSupplementalData. Establece LOCAL_CREATOR_DATA en una solicitud search_topics de un solo país (para entidades con CREATOR_TOPIC_INSIGHTS) para propagar local_creator_insights[]. |
insights_application_info |
Opcional | AdditionalApplicationInfo: Metadatos sobre la aplicación que emite la solicitud. |
El mensaje GenerateCreatorInsightsResponse devuelve
los siguientes campos:
| Campo de respuesta | Tipo | Descripción |
|---|---|---|
creator_insights[] |
YouTubeCreatorInsights |
Creadores que cumplen con tus criterios principales (creator_name y creator_channels[]) |
local_creator_insights[] |
YouTubeCreatorInsights |
Creadores locales que dieron su consentimiento para compartir datos de ubicación (se propaga cuando se solicita LOCAL_CREATOR_DATA con search_topics en una entidad con CREATOR_TOPIC_INSIGHTS). |
creator_channels[] |
YouTubeChannelInsights |
Metadatos: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location y data_sharing_consent_given.Estadísticas y contenido: channel_audience_attributes[] (restringido por consentimiento), channel_attributes[], top_videos[], language_distributions[], relevance_score (completado solo para GenerateTrendingInsights con search_topics) y channel_metrics. |
channel_metrics |
YouTubeMetrics |
Métricas públicas: subscriber_count, views_count, video_count, likes_count, shares_count, comments_count, shorts_views_count, shorts_video_count, is_active_shorts_creator, is_active_live_stream_creator y partnership_opportunities[].Métricas que requieren consentimiento: engagement_rate y promedios de 28 días por video (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video). |
Ejemplos de solicitud y respuesta de REST de GenerateCreatorInsights
En el siguiente ejemplo, se descubren creadores que usan searchAttributes con
audienceAttributes demográfico, audienceCombinations booleano ("Skin care"
OR "Hair care", AND "Cosmetics") y creatorAttributes:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocations": [
{
"geoTargetConstant": "geoTargetConstants/2840"
}
],
"searchAttributes": {
"audienceAttributes": [
{
"ageRange": {
"type": "AGE_RANGE_25_34"
}
},
{
"gender": {
"type": "FEMALE"
}
}
],
"audienceCombinations": [
{
"attributes": [
{
"entity": {
"knowledgeGraphMachineId": "/m/015c4z"
}
},
{
"entity": {
"knowledgeGraphMachineId": "/m/018bb_"
}
}
]
},
{
"attributes": [
{
"entity": {
"knowledgeGraphMachineId": "/m/014trl"
}
}
]
}
],
"creatorAttributes": [
{
"entity": {
"knowledgeGraphMachineId": "/m/014trl"
}
}
]
}
}
Para recuperar creadores basados en temas junto con creadores locales, usa searchTopics y
agrega "LOCAL_CREATOR_DATA" en supplementalData:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocations": [
{
"geoTargetConstant": "geoTargetConstants/2840"
}
],
"supplementalData": [
"LOCAL_CREATOR_DATA"
],
"searchTopics": {
"entities": [
{
"knowledgeGraphMachineId": "/m/014trl"
}
]
}
}
Para recuperar estadísticas de canales de YouTube específicos por ID del canal o nombre de usuario, usa
searchChannels:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocations": [
{
"geoTargetConstant": "geoTargetConstants/2840"
}
],
"searchChannels": {
"youtubeChannels": [
{
"channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
}
],
"youtubeChannelHandles": [
"@exampleskincare"
]
}
}
Una solicitud GenerateCreatorInsightsResponse correcta devuelve
creatorInsights[] (y localCreatorInsights[] cuando se solicita
LOCAL_CREATOR_DATA):
{
"creatorInsights": [
{
"creatorName": "Example Skincare Creator",
"creatorChannels": [
{
"displayName": "Example Skincare Channel",
"youtubeChannel": {
"channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
},
"channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
"handle": "@exampleskincare",
"publishDate": "2020-03-15",
"countryLocation": {
"geoTargetConstant": "geoTargetConstants/2840"
},
"dataSharingConsentGiven": true,
"channelMetrics": {
"subscriberCount": "450000",
"viewsCount": "38200000",
"videoCount": "210",
"likesCount": "1950000",
"commentsCount": "84000",
"engagementRate": 0.056,
"averageViewsPerVideo": 62000.0,
"shortsViewsCount": "14500000",
"shortsVideoCount": "95",
"isActiveShortsCreator": true,
"isActiveLiveStreamCreator": false,
"partnershipOpportunities": [
"CREATOR_PARTNERSHIPS",
"PARTNERSHIP_ADS"
]
}
}
]
}
],
"localCreatorInsights": []
}
Genera estadísticas de tendencias
Para generar estadísticas de tendencias, envía una solicitud al
método GenerateTrendingInsights. Este método tiene un límite de 5 consultas por segundo (QPS). Acepta dos tipos de entrada según si deseas tendencias de público o de temas, y requiere una ubicación de país objetivo.
Tendencias de público (
search_audience): Proporciona una lista de atributos de público (como edad, género e intereses de los usuarios) en el campoaudience_attributesdesearch_audiencey, de manera opcional, usaaudience_combinationspara combinar atributos con la lógica booleanaAND/OR. La API devuelve una lista de estadísticas de tendencias para esos públicos, incluidas métricas como el cambio porcentual en el valor de la tendencia durante el período de comparación.Los desarrolladores con acceso a
ContentCreatorInsightsServicetienen acceso automático aListAudienceInsightsAttributesenAudienceInsightsService(consulta la guía de estadísticas de público). Otros extremos deAudienceInsightsServicerequieren una lista de entidades permitidas independiente.Tendencias de temas (
search_topics): Proporciona una lista de temas de contenido en el camposearch_topics. La API devuelve estadísticas de tendencias para esos temas, incluido el cambio porcentual en el valor de la tendencia durante el período de comparación. También puedes solicitar estadísticas sobre los creadores locales o la opinión sobre la marca configurandosupplemental_data.Los atributos
KNOWLEDGE_GRAPHque muestraListAudienceInsightsAttributesincluyen una o más etiquetasInsightsKnowledgeGraphEntityCapabilities. Las entidades etiquetadas comoCONTENT_TRENDING_INSIGHTSse admiten como temas enGenerateTrendingInsights.
Datos complementarios y creadores locales
Al igual que con la generación de estadísticas de creadores, puedes solicitar funciones opcionales en
las estadísticas de tendencias configurando el campo repetido
supplemental_data como LOCAL_CREATOR_DATA o
BRAND_SENTIMENT_DATA:
- Creadores locales (
LOCAL_CREATOR_DATA): Cuando tu solicitud de tendencias usasearch_topics(y el tema es una entidad del Gráfico de conocimiento etiquetada con la funciónCREATOR_TOPIC_INSIGHTS), si establecessupplemental_dataenLOCAL_CREATOR_DATA, se propaga el camporelated_local_creatorsen los objetosTrendInsightdevueltos con creadores locales relacionados que dieron su consentimiento para compartir sus datos de ubicación. El descubrimiento de creadores locales no es compatible consub_country_locations. - Opinión sobre la marca (
BRAND_SENTIMENT_DATA): Cuando tu solicitud de tendencias usasearch_topicsy el tema de la entidad del Gráfico de conocimiento solicitado tiene la capacidadBRAND, configurarsupplemental_datacomoBRAND_SENTIMENT_DATApropaga el campobrand_sentiment_insightsen los objetosTrendInsightdevueltos.
La medición de la opinión sobre la marca utiliza modelos de IA de Gemini para analizar el contenido de video de YouTube relacionado con la marca y clasificar la opinión como positiva, negativa o neutral. Solo se analiza el contenido de video; no se incluyen los comentarios de los usuarios.
Metadatos de las estadísticas de tendencias
El método GenerateTrendingInsights devuelve una lista de objetos TrendInsight, cada uno de los cuales contiene lo siguiente:
trend_attribute: Es elAudienceInsightsAttributeMetadataprincipal de la tendencia.trend_metrics: Son las métricas de la tendencia, como el cambio porcentual durante el período de comparación.trend: Es un valorInsightsTrend(EMERGING,RISING,SUSTAINEDoDECLINING) que indica la dirección de la tendencia. Consultatrend_metrics.trend_change_percentpara conocer el tamaño del cambio.trend_data_points: Son los datos históricos de la tendencia. Solo se propaga para las tendencias que usansearch_topics.related_videos: Es una lista de objetosAudienceInsightsAttributeMetadatapara los videos populares asociados con el tema de la tendencia (solo se completa para las tendencias que usansearch_topics). Para estos atributos, elYouTubeVideoAttributeMetadataanidado se completa con metadatos a nivel del video (URL, URL de la miniatura, recuentos de vistas y de Me gusta) y metadatos a nivel del canal (ID del canal, nombre y URL del canal).related_creators: Es una lista de objetosYouTubeCreatorInsightspara creadores relacionados con el tema de la tendencia (solo se propaga para las tendencias que usansearch_topics).related_local_creators: Es una lista de objetosYouTubeCreatorInsightspara creadores locales relacionados con el tema de la tendencia que dieron su consentimiento para compartir sus datos de ubicación. Solo se propaga cuando se solicitaLOCAL_CREATOR_DATA(consulta Datos complementarios, creadores locales y opinión sobre la marca).brand_sentiment_insights: Es una lista de objetosBrandSentimentInsightpara la tendencia (se propaga cuando la solicitud usasearch_topicspara una entidad con la capacidadBRANDy solicitaBRAND_SENTIMENT_DATA). Cada objetoBrandSentimentInsightcontiene lo siguiente:month: Es el mes que representa la opinión sobre la marca en formatoYYYY-MM.has_insufficient_data: Indica si no hay datos suficientes para calcular el sentimiento de marca.sentiment_distributions: Es la distribución de las opiniones entre positivas, negativas y neutrales, calculada como la proporción de vistas de los videos correspondientes a la marca con cada opinión.sentiment_summaries: Son resúmenes generados por IA de temas positivos y negativos en el contenido relacionado con la marca, junto con videos de muestra para cada opinión. Los resúmenes se generan solo para las opiniones positivas y negativas, no para las neutras.
Referencia de solicitud y respuesta de GenerateTrendingInsights
Llama a GenerateTrendingInsights en ContentCreatorInsightsService en el siguiente extremo:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights
En la siguiente tabla, se resumen los campos de
GenerateTrendingInsightsRequest:
| Ruta del campo | Requisito | Formato y restricciones |
|---|---|---|
customer_id |
Obligatorio | Es el ID de cliente de 10 dígitos (string) sin guiones. |
customer_insights_group |
Obligatorio | Nombre definido por el usuario (string) del cliente o la marca para los que se realiza la planificación. |
country_location |
Obligatorio | Un solo país LocationInfo (geo_target_constant, como "geoTargetConstants/2840"). |
sub_country_locations[] |
Opcional | Filtros de subpaís LocationInfo; solo se admiten para search_audience y no son compatibles con LOCAL_CREATOR_DATA. |
search_audience |
criteria (oneof) |
SearchAudience que contiene lo siguiente:• audience_attributes[] (obligatorio): age_range, gender, parental_status, income_range (además de user_interest, entity o category cuando no se usa audience_combinations).• audience_combinations[] (opcional): Son grupos de atributos AND-of-ORs. |
search_topics |
criteria (oneof) |
SearchTopics que contiene entities[] (AudienceInsightsEntity con knowledge_graph_machine_id etiquetados con CONTENT_TRENDING_INSIGHTS). |
supplemental_data[] |
Opcional | Valores de ContentCreatorInsightsSupplementalData:• LOCAL_CREATOR_DATA: Completa related_local_creators[] para las entidades search_topics con CREATOR_TOPIC_INSIGHTS.• BRAND_SENTIMENT_DATA: Completa brand_sentiment_insights[] para las entidades search_topics con BRAND. |
insights_application_info |
Opcional | AdditionalApplicationInfo: Metadatos sobre la aplicación que emite la solicitud. |
El mensaje GenerateTrendingInsightsResponse devuelve entradas TrendInsight en trend_insights[]:
Campo TrendInsight |
Tipo | Descripción |
|---|---|---|
trend_attribute |
AudienceInsightsAttributeMetadata |
Es el atributo principal de la tendencia (dimension, display_name o attribute). |
trend_metrics |
TrendInsightMetrics |
Métricas durante el período de comparación de 3 meses (views_count y views_indexed_value para search_topics; audience_share para search_audience; trend_change_percent). |
trend |
InsightsTrend |
Dirección de la tendencia (EMERGING, RISING, SUSTAINED o DECLINING). |
trend_data_points[] |
TrendInsightDataPoint |
Datos históricos mensuales (month en formato YYYY-MM y trend_metrics); propagados para search_topics. |
related_videos[] |
AudienceInsightsAttributeMetadata |
Videos del momento con YouTubeVideoAttributeMetadata; se completa para search_topics. |
related_creators[] |
YouTubeCreatorInsights |
Creadores relacionados con el tema; se completa para search_topics. |
related_local_creators[] |
YouTubeCreatorInsights |
Creadores locales que dan su consentimiento; se completa para search_topics cuando se solicita LOCAL_CREATOR_DATA en una entidad con CREATOR_TOPIC_INSIGHTS. |
brand_sentiment_insights[] |
BrandSentimentInsight |
Opinión mensual sobre la marca (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); se propaga para search_topics cuando se solicita BRAND_SENTIMENT_DATA en una entidad con la capacidad BRAND. |
Ejemplo de solicitud y respuesta de REST de GenerateTrendingInsights
En el siguiente ejemplo, se llama a
GenerateTrendingInsights con searchTopics para
una entidad de marca del Gráfico de conocimiento (/g/11example_brand, etiquetada con
CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS y BRAND) y se solicitan
LOCAL_CREATOR_DATA y BRAND_SENTIMENT_DATA:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights
{
"customerInsightsGroup": "Spring Skincare Campaign",
"countryLocation": {
"geoTargetConstant": "geoTargetConstants/2840"
},
"supplementalData": [
"LOCAL_CREATOR_DATA",
"BRAND_SENTIMENT_DATA"
],
"searchTopics": {
"entities": [
{
"knowledgeGraphMachineId": "/g/11example_brand"
}
]
}
}
Un GenerateTrendingInsightsResponse correcto
devuelve entradas TrendInsight en trendInsights[]:
{
"trendInsights": [
{
"trendAttribute": {
"dimension": "KNOWLEDGE_GRAPH",
"displayName": "Example Skincare Brand",
"attribute": {
"entity": {
"knowledgeGraphMachineId": "/g/11example_brand"
}
}
},
"trendMetrics": {
"viewsCount": "18500000",
"viewsIndexedValue": "82",
"trendChangePercent": 0.24
},
"trend": "RISING",
"trendDataPoints": [
{
"month": "2026-05",
"trendMetrics": {
"viewsCount": "18500000",
"viewsIndexedValue": "82",
"trendChangePercent": 0.08
}
}
],
"brandSentimentInsights": [
{
"month": "2026-05",
"hasInsufficientData": false,
"sentimentDistributions": [
{
"sentiment": "SENTIMENT_POSITIVE",
"sentimentShare": 0.68
},
{
"sentiment": "SENTIMENT_NEUTRAL",
"sentimentShare": 0.25
},
{
"sentiment": "SENTIMENT_NEGATIVE",
"sentimentShare": 0.07
}
]
}
],
"relatedVideos": [],
"relatedCreators": [],
"relatedLocalCreators": []
}
]
}
Herramienta de seguimiento de errores de Google
Usa la Herramienta de seguimiento de errores de Google para hacer preguntas de asistencia, informar errores o enviar solicitudes de funciones. Google hace un seguimiento, prioriza y publica actualizaciones sobre tus solicitudes directamente en Issue Tracker. Para obtener más información, consulta Crea un error en la Herramienta de seguimiento de errores de Google.
Crea un problema con una de las siguientes plantillas de Issue Tracker:
- Haz una pregunta de asistencia general o envía comentarios sobre la documentación
- Cómo informar un error técnico
- Envía una solicitud de función de la API
Completa todos los campos de la plantilla con información detallada para que Google pueda reproducir y priorizar tu solicitud. Google podría cerrar los informes incompletos y pedirte que envíes un nuevo problema con los detalles faltantes.