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:
- 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.
- Insights sobre temas de criadores de conteúdo: busque insights sobre criadores de conteúdo relevantes que produzem conteúdo sobre temas específicos.
- 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.
- 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.
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 camposearch_attributespara 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
ListAudienceInsightsAttributese especificando as dimensões necessárias, comoKNOWLEDGE_GRAPHpara tópicos de interesse. Para combinar atributos usando grupos booleanosANDeOR, useaudience_combinations, conforme descrito em Combinações de público-alvo complexas.Insights sobre temas do criador de conteúdo (
search_topics): forneça uma lista de temas de conteúdo usando o camposearch_topics. A API retorna criadores relevantes que produzem conteúdo sobre os temas especificados. Os dados são buscados para o país especificado emcountry_locations(essa opção aceita um único país por solicitação).As entidades compatíveis em
search_topicsprecisam ser marcadas com o recursoCONTENT_TRENDING_INSIGHTSouCREATOR_TOPIC_INSIGHTS. UseListAudienceInsightsAttributespara recuperar os recursos de entidade compatíveis.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ãov25e mais recentes) ou uma combinação de ambos usando o camposearch_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
InsightsAudienceAttributeGroupemaudience_combinationscombina os atributos com umORlógico. - Vários itens
InsightsAudienceAttributeGroupemaudience_combinationssão combinados com umANDló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:
- Grupo 1, que contém os atributos de entidade do Mapa de informações para
"Skin care"e"Hair care". - 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_locationsestá 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 objetosYouTubeCreatorInsightsque correspondem aos seus critérios principais.local_creator_insights: uma lista de objetosYouTubeCreatorInsightspara criadores locais. Isso só será preenchido seLOCAL_CREATOR_DATAtiver sido solicitado e o critério usado tiver sidosearch_topics.
Cada objeto YouTubeCreatorInsights contém:
creator_name: o nome do criador.creator_channels: uma lista de objetosYouTubeChannelInsights. Os detalhes do canal echannel_metrics(YouTubeMetrics) são retornados dentro de cada objetoYouTubeChannelInsightsemcreator_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": []
}
Gerar insights sobre tendências
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.
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 campoaudience_attributesdesearch_audiencee, se quiser, useaudience_combinationspara combinar atributos com a lógica booleanaAND/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
ContentCreatorInsightsServicetêm acesso automático aListAudienceInsightsAttributesemAudienceInsightsService(consulte o guia de insights sobre público-alvo). Outros endpoints emAudienceInsightsServiceexigem uma lista de permissões separada.Tendências de temas (
search_topics): forneça uma lista de temas de conteúdo no camposearch_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 definindosupplemental_data.Os atributos
KNOWLEDGE_GRAPHretornados porListAudienceInsightsAttributesincluem uma ou mais tagsInsightsKnowledgeGraphEntityCapabilities. As entidades marcadas comCONTENT_TRENDING_INSIGHTSsão aceitas como tópicos emGenerateTrendingInsights.
Dados complementares e criadores de conteúdo locais
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 usasearch_topics(e o tema é uma entidade do Mapa de Informações marcada com o recursoCREATOR_TOPIC_INSIGHTS), definirsupplemental_datacomoLOCAL_CREATOR_DATApreenche o camporelated_local_creatorsnos objetosTrendInsightretornados 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 comsub_country_locations. - Sentimento da marca (
BRAND_SENTIMENT_DATA): quando sua solicitação de tendência usasearch_topicse o tópico da entidade do Mapa de informações solicitado tem o recursoBRAND, definirsupplemental_datacomoBRAND_SENTIMENT_DATApreenche o campobrand_sentiment_insightsnos objetosTrendInsightretornados.
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.
Metadados de insights em alta
O método GenerateTrendingInsights retorna uma lista
de objetos TrendInsight, cada um contendo:
trend_attribute: oAudienceInsightsAttributeMetadataprincipal da tendência.trend_metrics: as métricas da tendência, como a mudança percentual no período de comparação.trend: um valorInsightsTrend(EMERGING,RISING,SUSTAINEDouDECLINING) que indica a direção da tendência. Consultetrend_metrics.trend_change_percentpara saber o tamanho da mudança.trend_data_points: pontos de dados históricos da tendência. Preenchido apenas para tendências que usamsearch_topics.related_videos: uma lista de objetosAudienceInsightsAttributeMetadatapara vídeos em alta associados ao tema da tendência (preenchida apenas para tendências que usamsearch_topics). Para esses atributos, oYouTubeVideoAttributeMetadataaninhado é 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 objetosYouTubeCreatorInsightspara criadores relacionados ao tema da tendência (preenchida apenas para tendências que usamsearch_topics).related_local_creators: uma lista de objetosYouTubeCreatorInsightspara criadores locais relacionados ao tema da tendência que consentiram em compartilhar os dados de local. Preenchido apenas quandoLOCAL_CREATOR_DATAé solicitado (consulte Dados complementares, criadores locais e sentimento de marca).brand_sentiment_insights: uma lista de objetosBrandSentimentInsightpara a tendência (preenchida quando a solicitação usasearch_topicspara uma entidade com o recursoBRANDe solicitaBRAND_SENTIMENT_DATA). Cada objetoBrandSentimentInsightcontém:month: o mês que o sentimento da marca representa no formatoYYYY-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.
Referência de solicitação e resposta do GenerateTrendingInsights
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. |
Exemplo de solicitação e resposta REST do GenerateTrendingInsights
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:
- Fazer uma pergunta geral de suporte ou enviar feedback sobre a documentação
- Informar um bug técnico
- Enviar uma solicitação de recurso da API
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.