Estadísticas de los creadores de YouTube

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:

  1. Visibilidad de creadores: Encuentra creadores relevantes para un conjunto determinado de temas, datos demográficos, públicos o atributos de creadores.
  2. Estadísticas de temas de creadores: Obtén estadísticas sobre creadores relevantes que generan contenido sobre temas específicos.
  3. 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.
  4. 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.

  1. 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 campo search_attributes para 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 ListAudienceInsightsAttributes especificando las dimensiones que necesitas, como KNOWLEDGE_GRAPH para los temas de interés. Para combinar atributos con grupos booleanos AND y OR, usa audience_combinations como se describe en Combinaciones de públicos complejas.

  2. Estadísticas de temas de creadores (search_topics): Proporciona una lista de temas de contenido con el campo search_topics. La API devuelve creadores pertinentes que generan contenido sobre los temas especificados. Los datos se recuperan para el país especificado en country_locations (esta opción admite un solo país por solicitud).

    Las entidades admitidas en search_topics deben etiquetarse con la capacidad CONTENT_TRENDING_INSIGHTS o CREATOR_TOPIC_INSIGHTS. Usa ListAudienceInsightsAttributes para recuperar las capacidades de las entidades compatibles.

  3. Estadísticas de creadores (search_channels): Proporciona una lista de IDs de canales de YouTube, identificadores de canales de YouTube (youtube_channel_handles, disponibles en v25 y versiones posteriores) o una combinación de ambos con el campo search_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 InsightsAudienceAttributeGroup dentro de audience_combinations combina sus atributos con un OR lógico.
  • Varios elementos InsightsAudienceAttributeGroup en audience_combinations se combinan con un AND ló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:

  1. El grupo 1 contiene los atributos de la entidad del Gráfico de conocimiento para "Skin care" y "Hair care".
  2. 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_locations en 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 objetos YouTubeCreatorInsights que coinciden con tus criterios principales.
  • local_creator_insights: Es una lista de objetos YouTubeCreatorInsights para creadores locales. Este campo solo se completa si se solicitó LOCAL_CREATOR_DATA y el criterio usado fue search_topics.

Cada objeto YouTubeCreatorInsights contiene lo siguiente:

  • creator_name: Es el nombre del creador.
  • creator_channels: Es una lista de objetos YouTubeChannelInsights. Los detalles del canal y channel_metrics (YouTubeMetrics) se devuelven dentro de cada objeto YouTubeChannelInsights en creator_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": []
}

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.

  1. 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 campo audience_attributes de search_audience y, de manera opcional, usa audience_combinations para combinar atributos con la lógica booleana AND/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 ContentCreatorInsightsService tienen acceso automático a ListAudienceInsightsAttributes en AudienceInsightsService (consulta la guía de estadísticas de público). Otros extremos de AudienceInsightsService requieren una lista de entidades permitidas independiente.

  2. Tendencias de temas (search_topics): Proporciona una lista de temas de contenido en el campo search_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 configurando supplemental_data.

    Los atributos KNOWLEDGE_GRAPH que muestra ListAudienceInsightsAttributes incluyen una o más etiquetas InsightsKnowledgeGraphEntityCapabilities. Las entidades etiquetadas como CONTENT_TRENDING_INSIGHTS se admiten como temas en GenerateTrendingInsights.

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 usa search_topics (y el tema es una entidad del Gráfico de conocimiento etiquetada con la función CREATOR_TOPIC_INSIGHTS), si estableces supplemental_data en LOCAL_CREATOR_DATA, se propaga el campo related_local_creators en los objetos TrendInsight devueltos con creadores locales relacionados que dieron su consentimiento para compartir sus datos de ubicación. El descubrimiento de creadores locales no es compatible con sub_country_locations.
  • Opinión sobre la marca (BRAND_SENTIMENT_DATA): Cuando tu solicitud de tendencias usa search_topics y el tema de la entidad del Gráfico de conocimiento solicitado tiene la capacidad BRAND, configurar supplemental_data como BRAND_SENTIMENT_DATA propaga el campo brand_sentiment_insights en los objetos TrendInsight devueltos.

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.

El método GenerateTrendingInsights devuelve una lista de objetos TrendInsight, cada uno de los cuales contiene lo siguiente:

  • trend_attribute: Es el AudienceInsightsAttributeMetadata principal 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 valor InsightsTrend (EMERGING, RISING, SUSTAINED o DECLINING) que indica la dirección de la tendencia. Consulta trend_metrics.trend_change_percent para conocer el tamaño del cambio.
  • trend_data_points: Son los datos históricos de la tendencia. Solo se propaga para las tendencias que usan search_topics.
  • related_videos: Es una lista de objetos AudienceInsightsAttributeMetadata para los videos populares asociados con el tema de la tendencia (solo se completa para las tendencias que usan search_topics). Para estos atributos, el YouTubeVideoAttributeMetadata anidado 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 objetos YouTubeCreatorInsights para creadores relacionados con el tema de la tendencia (solo se propaga para las tendencias que usan search_topics).
  • related_local_creators: Es una lista de objetos YouTubeCreatorInsights para 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 solicita LOCAL_CREATOR_DATA (consulta Datos complementarios, creadores locales y opinión sobre la marca).
  • brand_sentiment_insights: Es una lista de objetos BrandSentimentInsight para la tendencia (se propaga cuando la solicitud usa search_topics para una entidad con la capacidad BRAND y solicita BRAND_SENTIMENT_DATA). Cada objeto BrandSentimentInsight contiene lo siguiente:
    • month: Es el mes que representa la opinión sobre la marca en formato YYYY-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.

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.

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:

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.