Statistiche per i creator di YouTube

Nota: questa funzionalità è in versione beta ed è disponibile solo per gli sviluppatori inclusi in una lista consentita.

Scopri e ottieni informazioni sui creator di YouTube con la funzionalità di approfondimenti sui creator in ContentCreatorInsightsService. Questo servizio aiuta le agenzie e gli inserzionisti a trovare creator pertinenti per il loro pubblico di destinazione.

L'API ha quattro funzioni principali:

1. Rilevabilità dei creator: trova creator pertinenti per un determinato insieme di argomenti, dati demografici, segmenti di pubblico o attributi dei creator.
2. Approfondimenti sugli argomenti dei creator: recupera approfondimenti sui creator pertinenti che creano contenuti su argomenti specifici.
3. Approfondimenti sui creator: recupera approfondimenti su canali YouTube specifici, come il numero di iscritti, il numero di visualizzazioni e i dati demografici del pubblico.
4. Approfondimenti sulle tendenze: recupera approfondimenti su tendenze specifiche, in base a segmenti di pubblico o argomenti specifici.

La Creator Discovery locale (ovvero la ricerca di creator che risiedono o pubblicano contenuti in un determinato paese e che vengono visualizzati in quel paese) è supportata quando si utilizza la Creator Discovery basata su argomenti o gli insight sulle tendenze richiedendo dati supplementari. Puoi anche richiedere approfondimenti sul sentiment del brand per gli approfondimenti sulle tendenze basati su argomenti richiedendo dati supplementari.

Requisiti di idoneità

GenerateCreatorInsights è un componente privato dell'API Google Ads offerto con una licenza per i dati non esclusiva ed esente da royalty. I partner registrati possono utilizzare le librerie client di Google Ads standard per esplorare i creator e i contenuti di YouTube. Per essere idonei, i partner devono soddisfare le seguenti condizioni:

• Disporre di uno strumento di pianificazione o di un'interfaccia utente che integra l'API Google Ads.
• Utilizza l'API per esplorare i contenuti e i creator di YouTube per potenziali opportunità pubblicitarie.
• Completa una valutazione di pre-screening per verificare l'idoneità.
• Rispettare i requisiti di utilizzo dei dati e sottoporsi a controlli periodici dei dati.
• Accetta i Termini di servizio dell'API Google Ads e le norme di utilizzo dei dati associate.

Per saperne di più, contatta il tuo rappresentante di Google.

Genera insight per i creator

Per generare insight sui creator, invia una richiesta al metodo GenerateCreatorInsights. Questo metodo ha un limite di 5 query al secondo (QPS). Accetta criteri diversi a seconda che tu voglia la rilevabilità dei creator, la ricerca di creator basata su argomenti o gli approfondimenti sui creator specifici per canale. Devi fornire le località del paese di destinazione in country_locations.

1. Rilevabilità dei creator (search_attributes): fornisci un elenco di attributi del pubblico, come età, genere e interessi degli utenti (segmenti di pubblico di affinità, in-market ed eventi importanti), utilizzando il campo search_attributes per trovare i creator i cui segmenti di pubblico corrispondono a questi attributi. Puoi anche fornire attributi dei creator per filtrare i creator i cui contenuti corrispondono ad attributi specifici.

   Recupera gli attributi del pubblico disponibili utilizzando ListAudienceInsightsAttributes e specificando le dimensioni necessarie, ad esempio KNOWLEDGE_GRAPH per gli argomenti di interesse. Per combinare gli attributi utilizzando i gruppi booleani AND e OR, utilizza audience_combinations come descritto in Combinazioni di segmenti di pubblico complesse.

2. Approfondimenti sugli argomenti dei creator (search_topics): fornisci un elenco di argomenti dei contenuti utilizzando il campo search_topics. L'API restituisce i creator pertinenti che creano contenuti sugli argomenti specificati. I dati vengono recuperati per il paese specificato in country_locations (questa opzione supporta un singolo paese per richiesta).

   Le entità supportate in search_topics devono essere taggate con la funzionalità CONTENT_TRENDING_INSIGHTS o CREATOR_TOPIC_INSIGHTS. Utilizza ListAudienceInsightsAttributes per recuperare le funzionalità delle entità supportate.

   Nota: l'opzione search_brand è stata ritirata in v24 e rimossa in v25. Utilizza invece search_topics.

3. Informazioni sui creator (search_channels): fornisci un elenco di ID canale YouTube, handle del canale YouTube (youtube_channel_handles, disponibile in v25 e versioni successive) o una combinazione di entrambi utilizzando il campo search_channels. L'API restituisce approfondimenti su questi canali specifici.

Combinazioni di segmenti di pubblico complesse

Sia in GenerateCreatorInsights che in GenerateTrendingInsights, puoi definire relazioni complesse tra gli attributi dei segmenti di pubblico utilizzando audience_combinations. Questo campo consente di combinare gli attributi del segmento di pubblico con la logica booleana (AND e OR) oltre al comportamento di unione semplice (OR) di audience_attributes:

• Ogni InsightsAudienceAttributeGroup all'interno di audience_combinations combina i propri attributi con un OR logico.
• Più elementi InsightsAudienceAttributeGroup in audience_combinations vengono combinati con un AND logico.

Ad esempio, per scegliere come target un pubblico interessato a ("Skin care" OR "Hair care") AND "Cosmetics", includi due elementi InsightsAudienceAttributeGroup in audience_combinations:

1. Gruppo 1 contenente gli attributi delle entità del Knowledge Graph per "Skin care" e "Hair care".
2. Gruppo 2 contenente l'attributo dell'entità Knowledge Graph per "Cosmetics" (ad esempio /m/014trl).

Nota: se specifichi entità del Knowledge Graph, categorie di prodotti e servizi o interessi degli utenti in audience_combinations, non puoi specificare anche questi tipi di attributi in audience_attributes. Puoi comunque utilizzare audience_attributes per i filtri demografici (come età e genere) insieme a audience_combinations.

Dati supplementari e creator locali

Per impostazione predefinita, vengono restituiti solo i dati degli insight principali. Puoi richiedere funzionalità facoltative e dati aggiuntivi nella risposta impostando il campo ripetuto supplemental_data.

Ad esempio, puoi richiedere i dati dei creator locali aggiungendo il valore enum LOCAL_CREATOR_DATA a supplemental_data. Se cerchi creator utilizzando search_topics (e l'argomento è un'entità del Knowledge Graph con tag della funzionalità CREATOR_TOPIC_INSIGHTS), l'API compila il campo local_creator_insights nella risposta con i creator locali che hanno acconsentito alla condivisione dei propri dati sulla posizione.

Tieni presente le seguenti specifiche per la Creator Discovery locale:

• Definizione: i creator locali sono creator che risiedono o pubblicano contenuti nel paese selezionato e vengono visualizzati in quel paese.
• Vincolo: il rilevamento dei creator locali non è supportato quando sub_country_locations è impostato nella richiesta.
• Capabilities: puoi recuperare l'elenco delle entità Knowledge Graph supportate e delle relative funzionalità utilizzando ListAudienceInsightsAttributes.

Il metodo GenerateCreatorInsights restituisce un oggetto GenerateCreatorInsightsResponse contenente i seguenti campi:

• creator_insights: un elenco di oggetti YouTubeCreatorInsights corrispondenti ai tuoi criteri principali.
• local_creator_insights: un elenco di oggetti YouTubeCreatorInsights per i creator locali. Questo campo viene compilato solo se è stato richiesto LOCAL_CREATOR_DATA e il criterio utilizzato era search_topics.

Ogni oggetto YouTubeCreatorInsights contiene:

• creator_name: il nome del creator.
• creator_channels: un elenco di oggetti YouTubeChannelInsights. I dettagli del canale e channel_metrics (YouTubeMetrics) vengono restituiti all'interno di ogni oggetto YouTubeChannelInsights in creator_channels.

L'oggetto YouTubeMetrics contiene:

• Numero di iscritti, visualizzazioni e video
• Numero totale di Mi piace, condivisioni e commenti per tutti i video del canale
• Tasso di coinvolgimento relativo al lifetime dell'utente (coinvolgimento totale diviso per le visualizzazioni totali)
• Media di visualizzazioni, Mi piace, condivisioni e commenti per video negli ultimi 28 giorni
• Conteggi delle visualizzazioni di Short e dei video
• Se il creator è un creator di Short attivo o un creator di live streaming attivo (ha pubblicato un contenuto negli ultimi 90 giorni)
• Opportunità di partnership

Il tasso di coinvolgimento e la media di visualizzazioni, Mi piace e commenti per video sono metriche non pubbliche che vengono compilate solo se il creator ha acconsentito a condividerle.

Per verificare se un creator è idoneo per le partnership per contenuti brandizzati originali, controlla partnership_opportunities; un creator è idoneo se l'elenco contiene CREATOR_PARTNERSHIPS.

L'oggetto YouTubeChannelInsights contiene le seguenti informazioni su un canale YouTube:

• Nome, ID, handle, URL, descrizione e URL della miniatura del canale
• Data di creazione del canale e paese associato
• Metriche del canale
• Attributi del pubblico del canale (ad esempio, età, genere e suddivisione degli interessi degli utenti)
• Attributi del canale (gli attributi associati ai contenuti del canale)
• Video principali
• Tipo di canale e lingue dei contenuti
• Punteggio di pertinenza (solo per le ricerche di tendenze degli argomenti)
• Se il creator ha dato il consenso alla condivisione di metriche non pubbliche

Riferimento per richieste e risposte GenerateCreatorInsights

Chiama GenerateCreatorInsights su ContentCreatorInsightsService al seguente endpoint:

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

La tabella seguente riassume i campi di GenerateCreatorInsightsRequest:

Percorso campo	Requisito	Formato e vincoli
customer_id	Obbligatorio	ID cliente di 10 cifre (string) senza trattini.
customer_insights_group	Obbligatorio	Nome definito dall'utente (string) del cliente o del brand per cui viene eseguita la pianificazione.
country_locations[]	Obbligatorio	Elenco di oggetti paese LocationInfo (geo_target_constant, ad esempio "geoTargetConstants/2840"). Deve contenere un singolo paese quando viene utilizzato search_topics.
sub_country_locations[]	Facoltativo	Filtri per regione LocationInfo; supportati solo con search_attributes e incompatibili con LOCAL_CREATOR_DATA.
search_attributes	criteria (oneof)	SearchAttributes contenente: • audience_attributes[]: age_range, gender, device, parental_status, income_range (più user_interest, entity o category quando audience_combinations non viene utilizzato). • audience_combinations[]: elementi AND-of-ORs InsightsAudienceAttributeGroup. • creator_attributes[]: elementi del Knowledge Graph entity con la funzionalità CREATOR_ATTRIBUTE.
search_topics	criteria (oneof)	SearchTopics contenente entities[] (AudienceInsightsEntity con knowledge_graph_machine_id taggato con CREATOR_TOPIC_INSIGHTS o CONTENT_TRENDING_INSIGHTS).
search_channels	criteria (oneof)	YouTubeChannels contenente youtube_channels[] (channel_id) e/o youtube_channel_handles[] (handle che iniziano con @, ad esempio "@youtubecreators").
supplemental_data[]	Facoltativo	Valori ContentCreatorInsightsSupplementalData. Imposta LOCAL_CREATOR_DATA su una richiesta search_topics per un singolo paese (per le entità con CREATOR_TOPIC_INSIGHTS) per compilare local_creator_insights[].
insights_application_info	Facoltativo	Metadati AdditionalApplicationInfo sull'applicazione che invia la richiesta.

Il messaggio GenerateCreatorInsightsResponse restituisce i seguenti campi:

Campo di risposta	Tipo	Descrizione
creator_insights[]	YouTubeCreatorInsights	Creator che soddisfano i tuoi criteri principali (creator_name e creator_channels[]).
local_creator_insights[]	YouTubeCreatorInsights	Creator locali che hanno acconsentito alla condivisione dei dati sulla posizione (compilati quando LOCAL_CREATOR_DATA viene richiesto con search_topics su un'entità con CREATOR_TOPIC_INSIGHTS).
creator_channels[]	YouTubeChannelInsights	Metadati: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location e data_sharing_consent_given. Approfondimenti e contenuti: channel_audience_attributes[] (con consenso), channel_attributes[], top_videos[], language_distributions[], relevance_score (compilato solo per GenerateTrendingInsights con search_topics) e channel_metrics.
channel_metrics	YouTubeMetrics	Metriche pubbliche: 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[]. Metriche soggette a consenso: engagement_rate e medie per video di 28 giorni (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

Esempi di richieste e risposte REST GenerateCreatorInsights

L'esempio seguente individua i creator utilizzando searchAttributes con audienceAttributes demografico, 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"
        }
      }
    ]
  }
}

Per recuperare i creator basati su argomenti insieme ai creator locali, utilizza searchTopics e includi "LOCAL_CREATOR_DATA" in 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"
      }
    ]
  }
}

Per recuperare gli approfondimenti per canali YouTube specifici in base all'ID canale o all'handle, utilizza 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 richiesta GenerateCreatorInsightsResponse riuscita restituisce creatorInsights[] (e localCreatorInsights[] quando viene richiesto 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 insight di tendenza

Per generare insight sulle tendenze, invia una richiesta al metodo GenerateTrendingInsights. Questo metodo ha un limite di 5 query al secondo (QPS). Accetta due tipi di input a seconda che tu voglia tendenze del pubblico o tendenze degli argomenti e richiede una località del paese di destinazione.

1. Tendenze del pubblico (search_audience): fornisci un elenco di attributi del pubblico (come età, genere e interessi degli utenti) nel campo audience_attributes di search_audience e, facoltativamente, utilizza audience_combinations per combinare gli attributi con la logica booleana AND/OR. L'API restituisce un elenco di insight sulle tendenze per questi segmenti di pubblico, incluse metriche come la variazione percentuale del valore della tendenza nel periodo di confronto.

   Gli sviluppatori con accesso a ContentCreatorInsightsService hanno accesso automatico a ListAudienceInsightsAttributes in AudienceInsightsService (consulta la guida alle statistiche sul pubblico). Altri endpoint in AudienceInsightsService richiedono una lista consentita separata.

2. Tendenze degli argomenti (search_topics): fornisci un elenco di argomenti dei contenuti nel campo search_topics. L'API restituisce insight sulle tendenze per questi argomenti, inclusa la variazione percentuale del valore della tendenza nel periodo di confronto. Puoi anche richiedere approfondimenti sui creator locali o sul sentiment del brand impostando supplemental_data.

   Gli attributi KNOWLEDGE_GRAPH restituiti da ListAudienceInsightsAttributes includono uno o più tag InsightsKnowledgeGraphEntityCapabilities; le entità con tag CONTENT_TRENDING_INSIGHTS sono supportate come argomenti in GenerateTrendingInsights.

Dati supplementari e creator locali

Analogamente alla generazione di insight sui creator, puoi richiedere funzionalità facoltative negli insight sulle tendenze impostando il campo ripetuto supplemental_data su LOCAL_CREATOR_DATA o BRAND_SENTIMENT_DATA:

• Creator locali (LOCAL_CREATOR_DATA): quando la richiesta di tendenza utilizza search_topics (e l'argomento è un'entità del Knowledge Graph taggata con la funzionalità CREATOR_TOPIC_INSIGHTS), l'impostazione di supplemental_data su LOCAL_CREATOR_DATA compila il campo related_local_creators negli oggetti TrendInsight restituiti con i creator locali correlati che hanno acconsentito a condividere i propri dati sulla posizione. La funzionalità Creator Discovery locale non è compatibile con sub_country_locations.
• Sentimento del marchio (BRAND_SENTIMENT_DATA ): Quando la tua richiesta di tendenza utilizzasearch_topics e l'argomento dell'entità Knowledge Graph richiesto ha ilBRAND capacità, impostazionesupplemental_data ABRAND_SENTIMENT_DATA popola ilbrand_sentiment_insights campo sul restituitoTrendInsight oggetti.

La misurazione del sentiment del brand utilizza i modelli di Gemini AI per analizzare i contenuti video di YouTube correlati al brand, classificando il sentiment come positivo, negativo o neutro. Vengono analizzati solo i contenuti video, non i commenti degli utenti.

Metadati degli insight di tendenza

Il metodo GenerateTrendingInsights restituisce un elenco di oggetti TrendInsight, ciascuno contenente:

• trend_attribute: l'AudienceInsightsAttributeMetadata principale per la tendenza.
• trend_metrics: le metriche per la tendenza, ad esempio la variazione percentuale rispetto al periodo di confronto.
• trend: un valore InsightsTrend (EMERGING, RISING, SUSTAINED o DECLINING) che indica la direzione della tendenza. Consulta trend_metrics.trend_change_percent per conoscere l'entità della modifica.
• trend_data_points: i punti dati storici per la tendenza. Compilato solo per le tendenze che utilizzano search_topics.
• related_videos: un elenco di oggetti AudienceInsightsAttributeMetadata per i video di tendenza associati all'argomento della tendenza (compilato solo per le tendenze che utilizzano search_topics). Per questi attributi, l'oggetto YouTubeVideoAttributeMetadata nidificato viene compilato con i metadati a livello di video (URL, URL della miniatura, numero di visualizzazioni e Mi piace) e i metadati a livello di canale (ID canale, nome e URL del canale).
• related_creators: un elenco di oggetti YouTubeCreatorInsights per i creator correlati all'argomento della tendenza (compilato solo per le tendenze che utilizzano search_topics).
• related_local_creators: un elenco di oggetti YouTubeCreatorInsights per i creator locali correlati all'argomento della tendenza che hanno acconsentito a condividere i propri dati sulla posizione. Viene compilato solo quando viene richiesto LOCAL_CREATOR_DATA (consulta Dati supplementari, creator locali e sentiment del brand).
• brand_sentiment_insights: un elenco di oggetti BrandSentimentInsight per la tendenza (compilato quando la richiesta utilizza search_topics per un'entità con la funzionalità BRAND e richiede BRAND_SENTIMENT_DATA). Ogni oggetto BrandSentimentInsight contiene:
  • month: il mese rappresentato dal sentiment del brand nel formato YYYY-MM.
  • has_insufficient_data: indica se i dati sono insufficienti per calcolare il sentiment del brand.
  • sentiment_distributions: distribuzione del sentiment tra positivo, negativo e neutro, calcolata come la proporzione di visualizzazioni dei video corrispondenti al brand con ciascun sentiment.
  • sentiment_summaries: riepiloghi generati dall'AI dei temi positivi e negativi nei contenuti correlati al brand, insieme a video di esempio per ogni sentiment. I riepiloghi vengono generati solo per il sentiment positivo e negativo, non per quello neutro.

Riferimento per richieste e risposte GenerateTrendingInsights

Chiama GenerateTrendingInsights su ContentCreatorInsightsService al seguente endpoint:

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

La tabella seguente riassume i campi di GenerateTrendingInsightsRequest:

Percorso campo	Requisito	Formato e vincoli
customer_id	Obbligatorio	ID cliente di 10 cifre (string) senza trattini.
customer_insights_group	Obbligatorio	Nome definito dall'utente (string) del cliente o del brand per cui viene eseguita la pianificazione.
country_location	Obbligatorio	Singolo paese LocationInfo (geo_target_constant, ad esempio "geoTargetConstants/2840").
sub_country_locations[]	Facoltativo	Filtri per regioni LocationInfo; supportati solo per search_audience e incompatibili con LOCAL_CREATOR_DATA.
search_audience	criteria (oneof)	SearchAudience contenente: • audience_attributes[] (obbligatorio): age_range, gender, parental_status, income_range (più user_interest, entity o category quando audience_combinations non viene utilizzato). • audience_combinations[] (facoltativo): gruppi di attributi AND-of-OR.
search_topics	criteria (oneof)	SearchTopics contenente entities[] (AudienceInsightsEntity con knowledge_graph_machine_id taggato con CONTENT_TRENDING_INSIGHTS).
supplemental_data[]	Facoltativo	Valori di ContentCreatorInsightsSupplementalData: • LOCAL_CREATOR_DATA: compila related_local_creators[] per le entità search_topics con CREATOR_TOPIC_INSIGHTS. • BRAND_SENTIMENT_DATA: compila brand_sentiment_insights[] per le entità search_topics con BRAND.
insights_application_info	Facoltativo	Metadati AdditionalApplicationInfo sull'applicazione che invia la richiesta.

Il messaggio GenerateTrendingInsightsResponse restituisce le voci TrendInsight in trend_insights[]:

Campo TrendInsight	Tipo	Descrizione
trend_attribute	AudienceInsightsAttributeMetadata	Attributo principale della tendenza (dimension, display_name, attribute).
trend_metrics	TrendInsightMetrics	Metriche nel periodo di confronto di 3 mesi (views_count e views_indexed_value per search_topics; audience_share per search_audience; trend_change_percent).
trend	InsightsTrend	Direzione della tendenza (EMERGING, RISING, SUSTAINED o DECLINING).
trend_data_points[]	TrendInsightDataPoint	Dati storici mensili (month in formato YYYY-MM e trend_metrics); compilati per search_topics.
related_videos[]	AudienceInsightsAttributeMetadata	Video di tendenza con YouTubeVideoAttributeMetadata; compilato per search_topics.
related_creators[]	YouTubeCreatorInsights	Creator correlati all'argomento; compilato per search_topics.
related_local_creators[]	YouTubeCreatorInsights	Creator locali che hanno dato il consenso; compilato per search_topics quando LOCAL_CREATOR_DATA viene richiesto su un'entità con CREATOR_TOPIC_INSIGHTS.
brand_sentiment_insights[]	BrandSentimentInsight	Sentiment mensile del brand (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); compilato per search_topics quando BRAND_SENTIMENT_DATA viene richiesto su un'entità con la funzionalità BRAND.

Esempio di richiesta e risposta REST GenerateTrendingInsights

L'esempio seguente chiama GenerateTrendingInsights utilizzando searchTopics per un'entità del brand del Knowledge Graph (/g/11example_brand, taggata con CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS e BRAND) e richiede sia LOCAL_CREATOR_DATA che 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 riuscito restituisce voci TrendInsight in 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": []
    }
  ]
}

Google Issue Tracker

Utilizza Google Issue Tracker per porre domande di assistenza, segnalare bug o inviare richieste di funzionalità. Google monitora, assegna la priorità e pubblica gli aggiornamenti sulle tue richieste direttamente in Issue Tracker. Per saperne di più, consulta Crea un problema in Google Issue Tracker.

Crea un problema utilizzando uno dei seguenti modelli di Issue Tracker:

• Fai una domanda di assistenza generale o invia un feedback sulla documentazione
• Segnala un bug tecnico
• Invia una richiesta di funzionalità API

Compila tutti i campi del modello con informazioni dettagliate in modo che Google possa riprodurre e dare priorità alla tua richiesta. Google potrebbe chiudere le segnalazioni incomplete e chiederti di inviare un nuovo problema con i dettagli mancanti.