Insights para criadores de conteúdo do YouTube

Descubra e busque insights sobre criadores de conteúdo do YouTube com o recurso de insights de criadores de conteúdo no ContentCreatorInsightsService. Esse serviço ajuda agências e anunciantes a encontrar criadores de conteúdo relevantes para o público-alvo deles.

A API tem quatro funções principais:

  1. Facilidade de descoberta de criadores de conteúdo: encontre criadores de conteúdo relevantes para um determinado conjunto de temas, informações demográficas, públicos-alvo ou atributos de criadores de conteúdo.
  2. Insights sobre temas de criadores de conteúdo: busque insights sobre criadores de conteúdo relevantes que produzem conteúdo sobre temas específicos.
  3. Insights do criador de conteúdo: busque insights sobre canais específicos do YouTube, como contagem de inscritos, contagem de visualizações e informações demográficas do público.
  4. Insights de tendências: busque insights sobre tendências específicas com base em públicos-alvo ou temas específicos.

A descoberta de criadores locais (encontrar criadores que estão ou postam de um determinado país e são vistos nesse país) é compatível com a descoberta de criadores com base em tópicos ou insights de tendências, solicitando dados complementares. Também é possível solicitar insights sobre o sentimento em relação à marca para insights de tendências com base em tópicos, solicitando dados complementares.

Requisitos de qualificação

A GenerateCreatorInsights é um componente particular da API Google Ads oferecido com uma licença de dados não exclusiva e livre de royalties. Os parceiros assinados podem usar as bibliotecas de cliente padrão do Google Ads para conhecer criadores de conteúdo do YouTube e conteúdo. Para se qualificar, os parceiros precisam atender às seguintes condições:

  • Ter uma ferramenta de planejamento ou interface do usuário que integre a API Google Ads.
  • Use a API para analisar o conteúdo e os criadores do YouTube em busca de possíveis oportunidades de publicidade.
  • Faça uma avaliação prévia para verificar se você se qualifica.
  • Seguir os requisitos de uso de dados e passar por auditorias periódicas de dados.
  • Aceite os Termos de Serviço da API Google Ads e a política de uso de dados associada.

Entre em contato com o representante do Google para mais informações.

Gerar insights sobre criadores de conteúdo

Para gerar insights do criador de conteúdo, envie uma solicitação ao método GenerateCreatorInsights. Esse método tem um limite de 5 consultas por segundo (QPS). Ele aceita critérios diferentes dependendo se você quer a facilidade de descoberta de criadores, a pesquisa de criadores com base em temas ou insights de criadores específicos do canal. É preciso informar os locais dos países de destino em country_locations.

  1. Facilidade de descoberta de criadores de conteúdo (search_attributes): forneça uma lista de atributos de público-alvo, como idade, gênero e interesses do usuário (públicos-alvo de afinidade, no mercado e de eventos importantes), usando o campo search_attributes para encontrar criadores de conteúdo com públicos-alvo que correspondam a esses atributos. Você também pode fornecer atributos de criadores para filtrar criadores com conteúdo que corresponda a atributos específicos.

    Recupere os atributos de público-alvo disponíveis usando ListAudienceInsightsAttributes e especificando as dimensões necessárias, como KNOWLEDGE_GRAPH para tópicos de interesse. Para combinar atributos usando grupos booleanos AND e OR, use audience_combinations, conforme descrito em Combinações de público-alvo complexas.

  2. Insights sobre temas do criador de conteúdo (search_topics): forneça uma lista de temas de conteúdo usando o campo search_topics. A API retorna criadores relevantes que produzem conteúdo sobre os temas especificados. Os dados são buscados para o país especificado em country_locations (essa opção aceita um único país por solicitação).

    As entidades compatíveis em search_topics precisam ser marcadas com o recurso CONTENT_TRENDING_INSIGHTS ou CREATOR_TOPIC_INSIGHTS. Use ListAudienceInsightsAttributes para recuperar os recursos de entidade compatíveis.

  3. Insights do criador de conteúdo (search_channels): forneça uma lista de IDs de canais do YouTube, identificadores de canais do YouTube (youtube_channel_handles, disponíveis na versão v25 e mais recentes) ou uma combinação de ambos usando o campo search_channels. A API retorna insights sobre esses canais específicos.

Combinações complexas de público-alvo

Em GenerateCreatorInsights e GenerateTrendingInsights, é possível definir relações complexas de atributos de público-alvo usando audience_combinations. Esse campo permite combinar atributos de público-alvo com lógica booleana (AND e OR) além do comportamento de união simples (OR) de audience_attributes:

  • Cada InsightsAudienceAttributeGroup em audience_combinations combina os atributos com um OR lógico.
  • Vários itens InsightsAudienceAttributeGroup em audience_combinations são combinados com um AND lógico.

Por exemplo, para segmentar um público-alvo interessado em ("Skin care" OR "Hair care") AND "Cosmetics", inclua dois itens InsightsAudienceAttributeGroup em audience_combinations:

  1. Grupo 1, que contém os atributos de entidade do Mapa de informações para "Skin care" e "Hair care".
  2. Grupo 2 que contém o atributo de entidade do Mapa de informações para "Cosmetics" (como /m/014trl).

Dados complementares e criadores de conteúdo locais

Por padrão, apenas os dados de insights principais são retornados. É possível solicitar recursos opcionais e dados adicionais na resposta definindo o campo repetido supplemental_data.

Por exemplo, é possível solicitar dados do criador local adicionando o valor de tipo enumerado LOCAL_CREATOR_DATA a supplemental_data. Se você pesquisar criadores de conteúdo usando search_topics (e o tema for uma entidade do Mapa de Informações marcada com o recurso CREATOR_TOPIC_INSIGHTS), a API vai preencher o campo local_creator_insights na resposta com criadores de conteúdo locais que consentiram em compartilhar os dados de local.

Não se esqueça das seguintes especificações para a Descoberta de Criadores locais:

  • Definição: criadores de conteúdo locais são aqueles que moram ou postam no país selecionado e são assistidos nesse mesmo país.
  • Restrição: a descoberta de criadores locais não é compatível quando sub_country_locations está definido na solicitação.
  • Recursos: é possível recuperar a lista de entidades do Mapa de Informações compatíveis e os recursos delas usando ListAudienceInsightsAttributes.

O método GenerateCreatorInsights retorna um objeto GenerateCreatorInsightsResponse que contém os seguintes campos:

  • creator_insights: uma lista de objetos YouTubeCreatorInsights que correspondem aos seus critérios principais.
  • local_creator_insights: uma lista de objetos YouTubeCreatorInsights para criadores locais. Isso só será preenchido se LOCAL_CREATOR_DATA tiver sido solicitado e o critério usado tiver sido search_topics.

Cada objeto YouTubeCreatorInsights contém:

  • creator_name: o nome do criador.
  • creator_channels: uma lista de objetos YouTubeChannelInsights. Os detalhes do canal e channel_metrics (YouTubeMetrics) são retornados dentro de cada objeto YouTubeChannelInsights em creator_channels.

O objeto YouTubeMetrics contém:

  • Contagem de inscritos, visualizações e vídeos
  • Número total de marcações "Gostei", compartilhamentos e comentários em todos os vídeos do canal
  • Taxa de engajamento em todo o ciclo de vida (total de engajamento dividido pelo total de visualizações)
  • Média de visualizações, marcações "Gostei", compartilhamentos e comentários por vídeo nos últimos 28 dias
  • Contagem de visualizações de Shorts e vídeos
  • Se o criador de conteúdo é um criador de Shorts ativo ou um criador de transmissões ao vivo ativo (publicou um nos últimos 90 dias)
  • Oportunidades de parceria

A taxa de engajamento e a média de visualizações, marcações "Gostei" e comentários por vídeo são métricas não públicas que são preenchidas apenas quando o criador de conteúdo consente em compartilhá-las.

Para verificar se um criador de conteúdo está qualificado para parcerias de conteúdo de marca original, inspecione partnership_opportunities. Um criador de conteúdo estará qualificado se a lista contiver CREATOR_PARTNERSHIPS.

O objeto YouTubeChannelInsights contém as seguintes informações sobre um canal do YouTube:

  • Nome do canal, ID, identificador, URL, descrição e URL da miniatura
  • Data de criação do canal e país associado
  • Métricas do canal
  • Atributos do público do canal (como idade, gênero e detalhamento de interesses do usuário)
  • Atributos do canal (associados ao conteúdo do canal)
  • Vídeos mais acessados
  • Tipo de canal e idiomas do conteúdo
  • Pontuação de relevância (somente para pesquisas em alta)
  • Se o criador de conteúdo deu consentimento para compartilhar métricas não públicas

Referência de solicitação e resposta do GenerateCreatorInsights

Chame GenerateCreatorInsights em ContentCreatorInsightsService no seguinte endpoint:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

A tabela a seguir resume os campos em GenerateCreatorInsightsRequest:

Caminho do campo Requisito Formato e restrições
customer_id Obrigatório ID de cliente de 10 dígitos (string) sem hífens.
customer_insights_group Obrigatório Nome definido pelo usuário (string) do cliente ou da marca que está sendo planejado.
country_locations[] Obrigatório Lista de objetos LocationInfo de país (geo_target_constant, como "geoTargetConstants/2840"). Precisa conter um único país quando search_topics é usado.
sub_country_locations[] Opcional Filtros de subpaís LocationInfo, compatíveis apenas com search_attributes e incompatíveis com LOCAL_CREATOR_DATA.
search_attributes criteria (oneof) SearchAttributes contendo:
• audience_attributes[]: age_range, gender, device, parental_status, income_range (além de user_interest, entity ou category quando audience_combinations não é usado).
• audience_combinations[]: itens AND-of-ORs InsightsAudienceAttributeGroup.
• creator_attributes[]: itens do Mapa de Informações entity com o recurso CREATOR_ATTRIBUTE.
search_topics criteria (oneof) SearchTopics que contém entities[] (AudienceInsightsEntity com knowledge_graph_machine_id marcado com CREATOR_TOPIC_INSIGHTS ou CONTENT_TRENDING_INSIGHTS).
search_channels criteria (oneof) YouTubeChannels que contenham youtube_channels[] (channel_id) e/ou youtube_channel_handles[] (identificadores que começam com @, como "@youtubecreators").
supplemental_data[] Opcional Valores de ContentCreatorInsightsSupplementalData. Defina LOCAL_CREATOR_DATA em uma solicitação search_topics de um único país (para entidades com CREATOR_TOPIC_INSIGHTS) para preencher local_creator_insights[].
insights_application_info Opcional Metadados AdditionalApplicationInfo sobre o aplicativo que emite a solicitação.

A mensagem GenerateCreatorInsightsResponse retorna os seguintes campos:

Campo de resposta Tipo Descrição
creator_insights[] YouTubeCreatorInsights Criadores de conteúdo que atendem aos seus critérios principais (creator_name e creator_channels[]).
local_creator_insights[] YouTubeCreatorInsights Criadores de conteúdo locais que consentiram em compartilhar dados de local (preenchidos quando LOCAL_CREATOR_DATA é solicitado com search_topics em uma entidade com CREATOR_TOPIC_INSIGHTS).
creator_channels[] YouTubeChannelInsights Metadados: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location e data_sharing_consent_given.
Insights e conteúdo: channel_audience_attributes[] (com consentimento), channel_attributes[], top_videos[], language_distributions[], relevance_score (preenchido apenas para GenerateTrendingInsights com search_topics) e 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 e partnership_opportunities[].
Métricas restritas por consentimento: engagement_rate e médias de 28 dias por vídeo (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

Exemplos de solicitação e resposta REST da GenerateCreatorInsights

O exemplo a seguir descobre criadores de conteúdo usando searchAttributes com audienceAttributes demográfico, audienceCombinations booleano ("Skin care" OR "Hair care", AND "Cosmetics") e 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 buscar criadores de conteúdo com base em temas e criadores locais, use searchTopics e inclua "LOCAL_CREATOR_DATA" em 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 buscar insights de canais específicos do YouTube por ID ou identificador, use 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"
    ]
  }
}

Uma GenerateCreatorInsightsResponse bem-sucedida retorna creatorInsights[] (e localCreatorInsights[] quando LOCAL_CREATOR_DATA é solicitado):

{
  "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 gerar insights de tendências, envie uma solicitação ao método GenerateTrendingInsights. Esse método tem um limite de 5 consultas por segundo (QPS). Ele aceita dois tipos de entrada, dependendo se você quer tendências de público-alvo ou de tópicos, e exige um local de país de destino.

  1. Tendências de público-alvo (search_audience): forneça uma lista de atributos de público-alvo (como idade, gênero e interesses do usuário) no campo audience_attributes de search_audience e, se quiser, use audience_combinations para combinar atributos com a lógica booleana AND/OR. A API retorna uma lista de insights de tendências para esses públicos-alvo, incluindo métricas como a mudança percentual no valor da tendência durante o período de comparação.

    Os desenvolvedores com acesso a ContentCreatorInsightsService têm acesso automático a ListAudienceInsightsAttributes em AudienceInsightsService (consulte o guia de insights sobre público-alvo). Outros endpoints em AudienceInsightsService exigem uma lista de permissões separada.

  2. Tendências de temas (search_topics): forneça uma lista de temas de conteúdo no campo search_topics. A API retorna insights de tendências para esses temas, incluindo a mudança percentual no valor da tendência durante o período de comparação. Também é possível solicitar insights sobre criadores locais ou sentimento da marca definindo supplemental_data.

    Os atributos KNOWLEDGE_GRAPH retornados por ListAudienceInsightsAttributes incluem uma ou mais tags InsightsKnowledgeGraphEntityCapabilities. As entidades marcadas com CONTENT_TRENDING_INSIGHTS são aceitas como tópicos em GenerateTrendingInsights.

Assim como na geração de insights do criador de conteúdo, é possível solicitar recursos opcionais em insights de tendências definindo o campo repetido supplemental_data como LOCAL_CREATOR_DATA ou BRAND_SENTIMENT_DATA:

  • Criadores de conteúdo locais (LOCAL_CREATOR_DATA): quando sua solicitação de tendências usa search_topics (e o tema é uma entidade do Mapa de Informações marcada com o recurso CREATOR_TOPIC_INSIGHTS), definir supplemental_data como LOCAL_CREATOR_DATA preenche o campo related_local_creators nos objetos TrendInsight retornados com criadores de conteúdo locais relacionados que consentiram em compartilhar os dados de local. A descoberta de criadores de conteúdo locais é incompatível com sub_country_locations.
  • Sentimento da marca (BRAND_SENTIMENT_DATA): quando sua solicitação de tendência usa search_topics e o tópico da entidade do Mapa de informações solicitado tem o recurso BRAND, definir supplemental_data como BRAND_SENTIMENT_DATA preenche o campo brand_sentiment_insights nos objetos TrendInsight retornados.

A medição do sentimento da marca usa modelos de IA do Gemini para analisar o conteúdo de vídeos do YouTube relacionados à marca, categorizando o sentimento como positivo, negativo ou neutro. Somente o conteúdo do vídeo é analisado. Os comentários dos usuários não são incluídos.

O método GenerateTrendingInsights retorna uma lista de objetos TrendInsight, cada um contendo:

  • trend_attribute: o AudienceInsightsAttributeMetadata principal da tendência.
  • trend_metrics: as métricas da tendência, como a mudança percentual no período de comparação.
  • trend: um valor InsightsTrend (EMERGING, RISING, SUSTAINED ou DECLINING) que indica a direção da tendência. Consulte trend_metrics.trend_change_percent para saber o tamanho da mudança.
  • trend_data_points: pontos de dados históricos da tendência. Preenchido apenas para tendências que usam search_topics.
  • related_videos: uma lista de objetos AudienceInsightsAttributeMetadata para vídeos em alta associados ao tema da tendência (preenchida apenas para tendências que usam search_topics). Para esses atributos, o YouTubeVideoAttributeMetadata aninhado é preenchido com metadados no nível do vídeo (URL, URL da miniatura, contagens de visualizações e marcações "Gostei") e metadados no nível do canal (ID do canal, nome e URL do canal).
  • related_creators: uma lista de objetos YouTubeCreatorInsights para criadores relacionados ao tema da tendência (preenchida apenas para tendências que usam search_topics).
  • related_local_creators: uma lista de objetos YouTubeCreatorInsights para criadores locais relacionados ao tema da tendência que consentiram em compartilhar os dados de local. Preenchido apenas quando LOCAL_CREATOR_DATA é solicitado (consulte Dados complementares, criadores locais e sentimento de marca).
  • brand_sentiment_insights: uma lista de objetos BrandSentimentInsight para a tendência (preenchida quando a solicitação usa search_topics para uma entidade com o recurso BRAND e solicita BRAND_SENTIMENT_DATA). Cada objeto BrandSentimentInsight contém:
    • month: o mês que o sentimento da marca representa no formato YYYY-MM.
    • has_insufficient_data: se não há dados suficientes para calcular o sentimento da marca.
    • sentiment_distributions: distribuição de sentimento entre positivo, negativo e neutro, calculada como a proporção de visualizações de vídeos correspondentes à marca com cada sentimento.
    • sentiment_summaries: resumos gerados com IA de temas positivos e negativos em conteúdo relacionado à marca, além de vídeos de amostra para cada sentimento. Os resumos são gerados apenas para sentimentos positivos e negativos, não neutros.

Chame GenerateTrendingInsights em ContentCreatorInsightsService no seguinte endpoint:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

A tabela a seguir resume os campos em GenerateTrendingInsightsRequest:

Caminho do campo Requisito Formato e restrições
customer_id Obrigatório ID de cliente de 10 dígitos (string) sem hífens.
customer_insights_group Obrigatório Nome definido pelo usuário (string) do cliente ou da marca que está sendo planejado.
country_location Obrigatório País único LocationInfo (geo_target_constant, como "geoTargetConstants/2840").
sub_country_locations[] Opcional Filtros de subpaís LocationInfo, compatíveis apenas com search_audience e incompatíveis com LOCAL_CREATOR_DATA.
search_audience criteria (oneof) SearchAudience contendo:
• audience_attributes[] (obrigatório): age_range, gender, parental_status, income_range (além de user_interest, entity ou category quando audience_combinations não é usado).
• audience_combinations[] (opcional): grupos de atributos AND-of-ORs.
search_topics criteria (oneof) SearchTopics que contém entities[] (AudienceInsightsEntity com knowledge_graph_machine_id marcado com CONTENT_TRENDING_INSIGHTS).
supplemental_data[] Opcional Valores de ContentCreatorInsightsSupplementalData:
• LOCAL_CREATOR_DATA: preenche related_local_creators[] para entidades search_topics com CREATOR_TOPIC_INSIGHTS.
• BRAND_SENTIMENT_DATA: preenche brand_sentiment_insights[] para entidades search_topics com BRAND.
insights_application_info Opcional Metadados AdditionalApplicationInfo sobre o aplicativo que emite a solicitação.

A mensagem GenerateTrendingInsightsResponse retorna entradas TrendInsight em trend_insights[]:

Campo TrendInsight Tipo Descrição
trend_attribute AudienceInsightsAttributeMetadata Atributo principal da tendência (dimension, display_name, attribute).
trend_metrics TrendInsightMetrics Métricas do período de comparação de 3 meses (views_count e views_indexed_value para search_topics; audience_share para search_audience; trend_change_percent).
trend InsightsTrend Direção da tendência (EMERGING, RISING, SUSTAINED ou DECLINING).
trend_data_points[] TrendInsightDataPoint Dados históricos mensais (month no formato YYYY-MM e trend_metrics); preenchidos para search_topics.
related_videos[] AudienceInsightsAttributeMetadata Vídeos em alta com YouTubeVideoAttributeMetadata; preenchido para search_topics.
related_creators[] YouTubeCreatorInsights Criadores de conteúdo relacionados ao tema, preenchidos para search_topics.
related_local_creators[] YouTubeCreatorInsights Criadores de conteúdo locais que consentiram. Preenchido para search_topics quando LOCAL_CREATOR_DATA é solicitado em uma entidade com CREATOR_TOPIC_INSIGHTS.
brand_sentiment_insights[] BrandSentimentInsight Sentimento mensal da marca (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); preenchido para search_topics quando BRAND_SENTIMENT_DATA é solicitado em uma entidade com o recurso BRAND.

O exemplo a seguir chama GenerateTrendingInsights usando searchTopics para uma entidade de marca do Mapa de Informações (/g/11example_brand, marcada com CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS e BRAND) e solicita LOCAL_CREATOR_DATA e 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"
      }
    ]
  }
}

Um GenerateTrendingInsightsResponse bem-sucedido retorna entradas TrendInsight em 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": []
    }
  ]
}

Issue Tracker do Google

Use o Issue Tracker do Google para fazer perguntas de suporte, informar bugs ou enviar solicitações de recursos. O Google rastreia, prioriza e publica atualizações sobre suas solicitações diretamente no Issue Tracker. Para mais informações, consulte Criar um problema no Issue Tracker do Google.

Crie um problema usando um dos seguintes modelos do Issue Tracker:

Preencha todos os campos do modelo com informações detalhadas para que o Google possa reproduzir e priorizar sua solicitação. O Google pode encerrar relatórios incompletos e pedir que você envie um novo problema com os detalhes que faltam.