Découvrez des insights sur les créateurs YouTube grâce à la fonctionnalité d'insights sur les créateurs dans ContentCreatorInsightsService.
Ce service aide les agences et les annonceurs à trouver des créateurs pertinents pour leur audience cible.
L'API remplit quatre fonctions principales :
- Découverte de créateurs : trouvez des créateurs pertinents pour un ensemble donné de thèmes, de données démographiques, d'audiences ou d'attributs de créateurs.
- Insights sur les thèmes des créateurs : récupérez des insights sur les créateurs pertinents qui créent du contenu sur des thèmes spécifiques.
- Insights sur les créateurs : récupérez des insights sur des chaînes YouTube spécifiques, comme leur nombre d'abonnés, leur nombre de vues et les données démographiques de leur audience.
- Insights sur les tendances : récupérez des insights sur des tendances spécifiques, en fonction d'audiences ou de thèmes spécifiques.
La découverte de créateurs locaux (trouver des créateurs basés dans un pays donné ou qui publient depuis ce pays, et qui sont vus dans ce pays) est possible lorsque vous utilisez la découverte de créateurs basée sur des thèmes ou les insights sur les tendances en demandant des données supplémentaires. Vous pouvez également demander des insights sur l'opinion sur la marque pour les insights sur les tendances par thème en demandant des données supplémentaires.
Critères d'éligibilité
GenerateCreatorInsights est un composant privé de l'API Google Ads proposé avec une licence de données non exclusive et libre de droits. Les partenaires signés peuvent utiliser les bibliothèques clientes Google Ads standards pour explorer les créateurs et les contenus YouTube. Pour être éligibles, les partenaires doivent remplir les conditions suivantes :
- Disposer d'un outil de planification ou d'une interface utilisateur qui intègre l'API Google Ads.
- Utilisez l'API pour explorer les contenus et les créateurs YouTube afin de trouver des opportunités publicitaires potentielles.
- Effectuez une pré-évaluation pour vérifier votre éligibilité.
- Respecter les exigences d'utilisation des données et se soumettre à des audits de données périodiques
- Acceptez les Conditions d'utilisation de l'API Google Ads et les règles d'utilisation des données associées.
Pour plus d'informations, contactez votre représentant Google.
Générer des insights sur les créateurs
Pour générer des insights sur les créateurs, envoyez une requête à la méthode GenerateCreatorInsights. Cette méthode est limitée à cinq requêtes par seconde (RPS). Elle accepte différents critères selon que vous souhaitez découvrir des créateurs, rechercher des créateurs par thème ou obtenir des insights sur des créateurs spécifiques à une chaîne. Vous devez indiquer les emplacements des pays cibles dans country_locations.
Visibilité des créateurs (
search_attributes) : fournissez une liste d'attributs d'audience (par exemple, l'âge, le genre et les centres d'intérêt des utilisateurs, comme les audiences d'affinité, sur le marché et d'événements de la vie) à l'aide du champsearch_attributespour trouver des créateurs dont les audiences correspondent à ces attributs. Vous pouvez également fournir des attributs de créateur pour filtrer les créateurs dont le contenu correspond à des attributs spécifiques.Récupérez les attributs d'audience disponibles à l'aide de
ListAudienceInsightsAttributesen spécifiant les dimensions dont vous avez besoin, telles queKNOWLEDGE_GRAPHpour les thèmes d'intérêt. Pour combiner des attributs à l'aide de groupes booléensANDetOR, utilisezaudience_combinationscomme décrit dans Combinaisons d'audiences complexes.Insights sur les thèmes des créateurs (
search_topics) : fournissez une liste de thèmes de contenu à l'aide du champsearch_topics. L'API renvoie les créateurs pertinents qui publient du contenu sur les thèmes spécifiés. Les données sont extraites pour le pays spécifié danscountry_locations(cette option n'accepte qu'un seul pays par requête).Les entités compatibles dans
search_topicsdoivent être taguées avec la fonctionnalitéCONTENT_TRENDING_INSIGHTSouCREATOR_TOPIC_INSIGHTS. UtilisezListAudienceInsightsAttributespour récupérer les fonctionnalités d'entité compatibles.Insights sur les créateurs (
search_channels) : fournissez une liste d'ID de chaînes YouTube, d'identifiants de chaînes YouTube (youtube_channel_handles, disponibles dansv25et versions ultérieures) ou une combinaison des deux à l'aide du champsearch_channels. L'API renvoie des insights sur ces canaux spécifiques.
Combinaisons d'audiences complexes
Dans GenerateCreatorInsights et GenerateTrendingInsights, vous pouvez définir des relations d'attributs d'audience complexes à l'aide de audience_combinations. Ce champ vous permet de combiner des attributs d'audience avec une logique booléenne (AND et OR) au-delà du comportement d'union plate (OR) de audience_attributes :
- Chaque
InsightsAudienceAttributeGroupdansaudience_combinationscombine ses attributs avec unORlogique. - Plusieurs éléments
InsightsAudienceAttributeGroupdansaudience_combinationssont combinés avec unANDlogique.
Par exemple, pour cibler une audience intéressée par ("Skin care" OR "Hair
care") AND "Cosmetics", incluez deux éléments InsightsAudienceAttributeGroup dans audience_combinations :
- Groupe 1 contenant les attributs d'entité Knowledge Graph pour
"Skin care"et"Hair care". - Groupe 2 contenant l'attribut d'entité Knowledge Graph pour
"Cosmetics"(par exemple,/m/014trl).
Données supplémentaires et créateurs locaux
Par défaut, seules les données d'insights de base sont renvoyées. Vous pouvez demander des fonctionnalités facultatives et des données supplémentaires dans votre réponse en définissant le champ répété supplemental_data.
Par exemple, vous pouvez demander des données sur les créateurs locaux en ajoutant la valeur d'énumération LOCAL_CREATOR_DATA à supplemental_data. Si vous recherchez des créateurs à l'aide de search_topics (et que le sujet est une entité Knowledge Graph taguée avec la fonctionnalité CREATOR_TOPIC_INSIGHTS), l'API renseigne le champ local_creator_insights de la réponse avec les créateurs locaux qui ont accepté de partager leurs données de localisation.
Tenez compte des spécifications suivantes pour la découverte de créateurs locaux :
- Définition : les créateurs locaux sont des créateurs qui sont basés dans le pays sélectionné ou qui publient depuis ce pays, et dont les contenus sont visionnés dans ce pays.
- Contrainte : la découverte de créateurs locaux n'est pas possible lorsque
sub_country_locationsest défini dans la requête. - Capacités : vous pouvez récupérer la liste des entités Knowledge Graph compatibles et leurs capacités à l'aide de
ListAudienceInsightsAttributes.
La méthode GenerateCreatorInsights renvoie un objet GenerateCreatorInsightsResponse contenant les champs suivants :
creator_insights: liste d'objetsYouTubeCreatorInsightscorrespondant à vos critères principaux.local_creator_insights: liste d'objetsYouTubeCreatorInsightspour les créateurs locaux. Ce champ n'est renseigné que siLOCAL_CREATOR_DATAa été demandé et que le critère utilisé étaitsearch_topics.
Chaque objet YouTubeCreatorInsights contient les éléments suivants :
creator_name: nom du créateur.creator_channels: liste d'objetsYouTubeChannelInsights. Les détails de la chaîne etchannel_metrics(YouTubeMetrics) sont renvoyés dans chaque objetYouTubeChannelInsightsdecreator_channels.
L'objet YouTubeMetrics contient les éléments suivants :
- Nombre d'abonnés, de vues et de vidéos
- Nombre total de "J'aime", de partages et de commentaires sur toutes les vidéos de la chaîne
- Taux d'engagement depuis la première visite (nombre total d'engagements divisé par le nombre total de vues)
- Nombre moyen de vues, de J'aime, de partages et de commentaires par vidéo au cours des 28 derniers jours
- Nombre de vues de Shorts et de vidéos
- Indique si le créateur est un créateur actif de Shorts ou de diffusions en direct (il en a publié un au cours des 90 derniers jours).
- Opportunités de partenariat
Le taux d'engagement et le nombre moyen de vues, de J'aime et de commentaires par vidéo sont des métriques non publiques qui ne sont renseignées que si le créateur a accepté de les partager.
Pour vérifier si un créateur est éligible aux partenariats de contenu de marque original, inspectez partnership_opportunities. Un créateur est éligible si la liste contient CREATOR_PARTNERSHIPS.
L'objet YouTubeChannelInsights contient les informations suivantes sur une chaîne YouTube :
- Nom, ID, identifiant, URL, description et URL de la miniature de la chaîne
- Date de création de la chaîne et pays associé
- Métriques de la chaîne
- Attributs de l'audience de la chaîne (par exemple, répartition par âge, genre et centres d'intérêt des utilisateurs)
- Attributs de canal (attributs associés au contenu du canal)
- Vidéos les plus regardées
- Type de chaîne et langues du contenu
- Score de pertinence (uniquement pour les recherches de tendances par thème)
- Indique si le créateur a accepté de partager des métriques non publiques.
Référence des requêtes et réponses GenerateCreatorInsights
Appelez GenerateCreatorInsights sur ContentCreatorInsightsService au point de terminaison suivant :
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
Le tableau suivant récapitule les champs de GenerateCreatorInsightsRequest :
| Chemin d'accès du champ | Exigence | Format et contraintes |
|---|---|---|
customer_id |
Obligatoire | Numéro client à 10 chiffres (string) sans trait d'union. |
customer_insights_group |
Obligatoire | Nom défini par l'utilisateur (string) du client ou de la marque pour lequel ou laquelle la planification est effectuée. |
country_locations[] |
Obligatoire | Liste d'objets LocationInfo de pays (geo_target_constant, par exemple "geoTargetConstants/2840"). Doit contenir un seul pays lorsque search_topics est utilisé. |
sub_country_locations[] |
Facultatif | Filtres de sous-pays LocationInfo ; compatibles uniquement avec search_attributes et incompatibles avec LOCAL_CREATOR_DATA. |
search_attributes |
criteria (oneof) |
SearchAttributes contenant :• audience_attributes[] : age_range, gender, device, parental_status, income_range (plus user_interest, entity ou category lorsque audience_combinations n'est pas utilisé).• audience_combinations[] : éléments ET de OU InsightsAudienceAttributeGroup.• creator_attributes[] : éléments Knowledge Graph entity avec la fonctionnalité CREATOR_ATTRIBUTE. |
search_topics |
criteria (oneof) |
SearchTopics contenant entities[] (AudienceInsightsEntity avec knowledge_graph_machine_id tagué avec CREATOR_TOPIC_INSIGHTS ou CONTENT_TRENDING_INSIGHTS). |
search_channels |
criteria (oneof) |
YouTubeChannels contenant youtube_channels[] (channel_id) et/ou youtube_channel_handles[] (identifiants commençant par @, comme "@youtubecreators"). |
supplemental_data[] |
Facultatif | Valeurs ContentCreatorInsightsSupplementalData. Définissez LOCAL_CREATOR_DATA sur une requête search_topics pour un seul pays (pour les entités avec CREATOR_TOPIC_INSIGHTS) afin de renseigner local_creator_insights[]. |
insights_application_info |
Facultatif | Métadonnées AdditionalApplicationInfo sur l'application qui émet la requête. |
Le message GenerateCreatorInsightsResponse renvoie les champs suivants :
| Champ de réponse | Type | Description |
|---|---|---|
creator_insights[] |
YouTubeCreatorInsights |
Créateurs correspondant à vos critères principaux (creator_name et creator_channels[]). |
local_creator_insights[] |
YouTubeCreatorInsights |
Créateurs locaux ayant accepté de partager leurs données de localisation (renseignées lorsque LOCAL_CREATOR_DATA est demandé avec search_topics sur une entité avec CREATOR_TOPIC_INSIGHTS). |
creator_channels[] |
YouTubeChannelInsights |
Métadonnées : display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location et data_sharing_consent_given.Insights et contenu : channel_audience_attributes[] (soumis à consentement), channel_attributes[], top_videos[], language_distributions[], relevance_score (renseigné uniquement pour GenerateTrendingInsights avec search_topics) et channel_metrics. |
channel_metrics |
YouTubeMetrics |
Métriques publiques : 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 et partnership_opportunities[].Métriques soumises à consentement : engagement_rate et moyennes sur 28 jours par vidéo (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video). |
Exemples de requêtes et de réponses REST GenerateCreatorInsights
L'exemple suivant découvre des créateurs à l'aide de searchAttributes avec les critères démographiques audienceAttributes, booléens audienceCombinations ("Skin care"
OR "Hair care", AND "Cosmetics") et 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"
}
}
]
}
}
Pour récupérer les créateurs par thème ainsi que les créateurs locaux, utilisez searchTopics et incluez "LOCAL_CREATOR_DATA" dans 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"
}
]
}
}
Pour récupérer des insights pour des chaînes YouTube spécifiques par ID de la chaîne ou identifiant, utilisez 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"
]
}
}
Une requête GenerateCreatorInsightsResponse réussie renvoie creatorInsights[] (et localCreatorInsights[] lorsque LOCAL_CREATOR_DATA est demandé) :
{
"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": []
}
Générer des insights sur les tendances
Pour générer des insights sur les tendances, envoyez une requête à la méthode GenerateTrendingInsights. Cette méthode est limitée à cinq requêtes par seconde (RPS). Il accepte deux types d'entrées selon que vous souhaitez obtenir des tendances d'audience ou des tendances de thèmes, et nécessite un pays cible.
Tendances d'audience (
search_audience) : fournissez une liste d'attributs d'audience (tels que l'âge, le genre et les centres d'intérêt des utilisateurs) dans le champaudience_attributesdesearch_audienceet, si vous le souhaitez, utilisezaudience_combinationspour combiner les attributs avec la logique booléenneAND/OR. L'API renvoie une liste d'insights sur les tendances pour ces audiences, y compris des métriques telles que la variation en pourcentage de la valeur de la tendance sur la période de comparaison.Les développeurs ayant accès à
ContentCreatorInsightsServiceont automatiquement accès àListAudienceInsightsAttributesdansAudienceInsightsService(consultez le guide sur les insights sur l'audience). Les autres points de terminaison deAudienceInsightsServicenécessitent une liste d'autorisation distincte.Tendances des thèmes (
search_topics) : fournissez une liste de thèmes de contenu dans le champsearch_topics. L'API renvoie des insights sur les tendances pour ces thèmes, y compris la variation en pourcentage de la valeur de la tendance sur la période de comparaison. Vous pouvez également demander des insights sur les créateurs locaux ou sur l'opinion de la marque en définissantsupplemental_data.Les attributs
KNOWLEDGE_GRAPHrenvoyés parListAudienceInsightsAttributesincluent une ou plusieurs balisesInsightsKnowledgeGraphEntityCapabilities. Les entités taguéesCONTENT_TRENDING_INSIGHTSsont acceptées en tant que thèmes dansGenerateTrendingInsights.
Données supplémentaires et créateurs locaux
Comme pour générer des insights sur les créateurs, vous pouvez demander des fonctionnalités facultatives dans les insights sur les tendances en définissant le champ répété supplemental_data sur LOCAL_CREATOR_DATA ou BRAND_SENTIMENT_DATA :
- Créateurs locaux (
LOCAL_CREATOR_DATA) : lorsque votre requête de tendances utilisesearch_topics(et que le sujet est une entité du graphique de connaissances taguée avec la fonctionnalitéCREATOR_TOPIC_INSIGHTS), définirsupplemental_datasurLOCAL_CREATOR_DATArenseigne le champrelated_local_creatorssur les objetsTrendInsightrenvoyés avec les créateurs locaux associés qui ont accepté de partager leurs données de localisation. La découverte de créateurs locaux est incompatible avecsub_country_locations. - Sentiment de marque (
BRAND_SENTIMENT_DATA) : lorsque votre requête de tendance utilisesearch_topicset que le sujet de l'entité Knowledge Graph demandé dispose de la fonctionnalitéBRAND, définirsupplemental_datasurBRAND_SENTIMENT_DATArenseigne le champbrand_sentiment_insightssur les objetsTrendInsightrenvoyés.
La mesure du sentiment envers la marque utilise des modèles d'IA Gemini pour analyser le contenu des vidéos YouTube liées à la marque, en classant le sentiment comme positif, négatif ou neutre. Seul le contenu vidéo lui-même est analysé, les commentaires des utilisateurs ne sont pas inclus.
Métadonnées des insights sur les tendances
La méthode GenerateTrendingInsights renvoie une liste d'objets TrendInsight, chacun contenant :
trend_attribute:AudienceInsightsAttributeMetadataprincipal de la tendance.trend_metrics: métriques de la tendance, telles que la variation en pourcentage sur la période de comparaison.trend: valeurInsightsTrend(EMERGING,RISING,SUSTAINEDouDECLINING) indiquant la direction de la tendance. Consulteztrend_metrics.trend_change_percentpour connaître la taille de la modification.trend_data_points: points de données historiques pour la tendance. Renseigné uniquement pour les tendances utilisantsearch_topics.related_videos: liste d'objetsAudienceInsightsAttributeMetadatapour les vidéos tendance associées au thème de la tendance (uniquement renseigné pour les tendances utilisantsearch_topics). Pour ces attributs, l'objetYouTubeVideoAttributeMetadataimbriqué est renseigné avec des métadonnées au niveau de la vidéo (URL, URL de la miniature, nombre de vues et de J'aime) et des métadonnées au niveau de la chaîne (ID de la chaîne, nom et URL de la chaîne).related_creators: liste d'objetsYouTubeCreatorInsightspour les créateurs liés au thème de la tendance (uniquement renseignée pour les tendances utilisantsearch_topics).related_local_creators: liste d'objetsYouTubeCreatorInsightspour les créateurs locaux liés au sujet de la tendance qui ont accepté de partager leurs données de localisation. Renseigné uniquement lorsqueLOCAL_CREATOR_DATAest demandé (voir Données supplémentaires, créateurs locaux et sentiment de marque).brand_sentiment_insights: liste d'objetsBrandSentimentInsightpour la tendance (renseignée lorsque la requête utilisesearch_topicspour une entité avec la fonctionnalitéBRANDet demandeBRAND_SENTIMENT_DATA). Chaque objetBrandSentimentInsightcontient :month: mois représenté par la perception de la marque, au formatYYYY-MM.has_insufficient_data: indique si les données sont insuffisantes pour calculer la perception de la marque.sentiment_distributions: répartition du sentiment entre positif, négatif et neutre, calculée en fonction de la proportion de vues des vidéos correspondant à la marque pour chaque sentiment.sentiment_summaries: résumés générés par IA des thèmes positifs et négatifs dans les contenus liés à la marque, ainsi que des échantillons vidéo pour chaque sentiment. Les résumés ne sont générés que pour les sentiments positifs et négatifs, pas pour les sentiments neutres.
Référence des requêtes et réponses GenerateTrendingInsights
Appelez GenerateTrendingInsights sur ContentCreatorInsightsService au point de terminaison suivant :
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights
Le tableau suivant récapitule les champs de GenerateTrendingInsightsRequest :
| Chemin d'accès du champ | Exigence | Format et contraintes |
|---|---|---|
customer_id |
Obligatoire | Numéro client à 10 chiffres (string) sans trait d'union. |
customer_insights_group |
Obligatoire | Nom défini par l'utilisateur (string) du client ou de la marque pour lequel ou laquelle la planification est effectuée. |
country_location |
Obligatoire | Un seul pays LocationInfo (geo_target_constant, par exemple "geoTargetConstants/2840"). |
sub_country_locations[] |
Facultatif | Filtres de sous-pays LocationInfo : compatibles uniquement avec search_audience et incompatibles avec LOCAL_CREATOR_DATA. |
search_audience |
criteria (oneof) |
SearchAudience contenant :• audience_attributes[] (obligatoire) : age_range, gender, parental_status, income_range (plus user_interest, entity ou category lorsque audience_combinations n'est pas utilisé).• audience_combinations[] (facultatif) : groupes d'attributs ET-de-OU. |
search_topics |
criteria (oneof) |
SearchTopics contenant entities[] (AudienceInsightsEntity avec knowledge_graph_machine_id tagué avec CONTENT_TRENDING_INSIGHTS). |
supplemental_data[] |
Facultatif | Valeurs ContentCreatorInsightsSupplementalData :• LOCAL_CREATOR_DATA : renseigne related_local_creators[] pour les entités search_topics avec CREATOR_TOPIC_INSIGHTS.• BRAND_SENTIMENT_DATA : renseigne brand_sentiment_insights[] pour les entités search_topics avec BRAND. |
insights_application_info |
Facultatif | Métadonnées AdditionalApplicationInfo sur l'application qui émet la requête. |
Le message GenerateTrendingInsightsResponse renvoie des entrées TrendInsight dans trend_insights[] :
Champ TrendInsight |
Type | Description |
|---|---|---|
trend_attribute |
AudienceInsightsAttributeMetadata |
Attribut principal de la tendance (dimension, display_name, attribute). |
trend_metrics |
TrendInsightMetrics |
Métriques sur la période de comparaison de trois mois (views_count et views_indexed_value pour search_topics ; audience_share pour search_audience ; trend_change_percent). |
trend |
InsightsTrend |
Direction de la tendance (EMERGING, RISING, SUSTAINED ou DECLINING). |
trend_data_points[] |
TrendInsightDataPoint |
Données historiques mensuelles (month au format YYYY-MM et trend_metrics) ; renseignées pour search_topics. |
related_videos[] |
AudienceInsightsAttributeMetadata |
Vidéos tendance avec YouTubeVideoAttributeMetadata ; renseigné pour search_topics. |
related_creators[] |
YouTubeCreatorInsights |
Créateurs associés au thème (renseigné pour search_topics). |
related_local_creators[] |
YouTubeCreatorInsights |
Créateurs locaux consentants ; renseigné pour search_topics lorsque LOCAL_CREATOR_DATA est demandé sur une entité avec CREATOR_TOPIC_INSIGHTS. |
brand_sentiment_insights[] |
BrandSentimentInsight |
Sentiment mensuel envers la marque (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]) ; renseigné pour search_topics lorsque BRAND_SENTIMENT_DATA est demandé sur une entité avec la fonctionnalité BRAND. |
Exemple de requête et de réponse REST GenerateTrendingInsights
L'exemple suivant appelle GenerateTrendingInsights à l'aide de searchTopics pour une entité de marque Knowledge Graph (/g/11example_brand, taguée avec CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS et BRAND) et demande à la fois LOCAL_CREATOR_DATA et 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"
}
]
}
}
Une requête GenerateTrendingInsightsResponse réussie renvoie des entrées TrendInsight dans 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 Google
Utilisez Google Issue Tracker pour poser des questions à l'assistance, signaler des bugs ou envoyer des demandes de fonctionnalités. Google suit, hiérarchise et publie des mises à jour sur vos demandes directement dans Issue Tracker. Pour en savoir plus, consultez Créer un problème dans l'outil Issue Tracker de Google.
Créez un problème à l'aide de l'un des modèles Issue Tracker suivants :
- Poser une question d'ordre général à l'assistance ou envoyer des commentaires sur la documentation
- Signaler un bug technique
- Envoyer une demande de fonctionnalité d'API
Remplissez tous les champs du modèle avec des informations détaillées afin que Google puisse reproduire et hiérarchiser votre demande. Google peut clôturer les rapports incomplets et vous demander d'envoyer un nouveau problème avec les informations manquantes.