ContentCreatorInsightsService में क्रिएटर की अहम जानकारी देने वाली सुविधा की मदद से, YouTube क्रिएटर्स को खोजें और उनके बारे में अहम जानकारी पाएं.
इस सेवा की मदद से, एजेंसियों और विज्ञापन देने वाले लोगों या कंपनियों को ऐसे क्रिएटर्स ढूंढने में मदद मिलती है जो उनकी टारगेट ऑडियंस के हिसाब से सही हों.
एपीआई के चार मुख्य फ़ंक्शन हैं:
- क्रिएटर को खोजने की सुविधा: विषयों, डेमोग्राफ़िक्स, ऑडियंस या क्रिएटर की विशेषताओं के आधार पर, अपने काम के क्रिएटर्स ढूंढें.
- क्रिएटर के विषय के बारे में अहम जानकारी: उन क्रिएटर्स के बारे में अहम जानकारी पाएं जो आपके चुने गए विषयों पर कॉन्टेंट बनाते हैं.
- क्रिएटर के बारे में अहम जानकारी: किसी YouTube चैनल के बारे में अहम जानकारी पाएं. जैसे, उसके सदस्यों की संख्या, व्यू की संख्या, और ऑडियंस की डेमोग्राफ़िक्स (उम्र, लिंग, आय, शिक्षा वगैरह).
- ट्रेंडिंग अहम जानकारी: खास ऑडियंस या विषयों के आधार पर, खास रुझानों के बारे में अहम जानकारी पाएं.
स्थानीय क्रिएटर डिस्कवरी (किसी देश में रहने वाले या वहां से पोस्ट करने वाले और उस देश में देखे जाने वाले क्रिएटर्स को ढूंढना) तब काम करती है, जब विषय के आधार पर क्रिएटर डिस्कवरी या ट्रेंडिंग अहम जानकारी का इस्तेमाल किया जाता है. इसके लिए, पूरक डेटा का अनुरोध करना पड़ता है. पूरक डेटा का अनुरोध करके, विषय के आधार पर ट्रेंडिंग से जुड़ी अहम जानकारी के लिए, ब्रैंड के बारे में लोगों की राय से जुड़ी अहम जानकारी का भी अनुरोध किया जा सकता है.
ज़रूरी शर्तें
GenerateCreatorInsights, Google Ads API का एक निजी कॉम्पोनेंट है. इसे नॉन-एक्सक्लूसिव और रॉयल्टी-फ़्री डेटा लाइसेंस के साथ उपलब्ध कराया जाता है. साइन इन किए हुए पार्टनर, YouTube क्रिएटर्स और कॉन्टेंट को एक्सप्लोर करने के लिए, स्टैंडर्ड Google Ads क्लाइंट लाइब्रेरी का इस्तेमाल कर सकते हैं. इस प्रोग्राम में शामिल होने के लिए, पार्टनर को ये ज़रूरी शर्तें पूरी करनी होंगी:
- Google Ads API को इंटिग्रेट करने वाला प्लानिंग टूल या यूज़र इंटरफ़ेस होना चाहिए.
- विज्ञापन दिखाने के संभावित अवसरों के लिए, YouTube कॉन्टेंट और क्रिएटर्स को एक्सप्लोर करने के लिए एपीआई का इस्तेमाल करें.
- आपको यह सुविधा मिल सकती है या नहीं, यह पता करने के लिए प्री-स्क्रीन असेसमेंट पूरा करें.
- डेटा के इस्तेमाल से जुड़ी ज़रूरी शर्तों का पालन करना और समय-समय पर डेटा ऑडिट करवाना.
- Google Ads API की सेवा की शर्तें और डेटा के इस्तेमाल से जुड़ी नीति को स्वीकार करें.
ज़्यादा जानकारी के लिए, अपने Google प्रतिनिधि से संपर्क करें.
क्रिएटर के बारे में अहम जानकारी जनरेट करना
क्रिएटर की अहम जानकारी जनरेट करने के लिए, GenerateCreatorInsights तरीके से अनुरोध भेजें. इस तरीके में, हर सेकंड पांच क्वेरी (क्यूपीएस) की सीमा होती है. यह इस बात पर निर्भर करता है कि आपको क्रिएटर को आसानी से नज़र में आने लायक बनाना है, विषय के आधार पर क्रिएटर को खोजना है या चैनल के हिसाब से क्रिएटर की अहम जानकारी चाहिए. आपको टारगेट किए गए देश की जगहों की जानकारी country_locations में देनी होगी.
क्रिएटर को खोजने की सुविधा (
search_attributes):search_attributesफ़ील्ड का इस्तेमाल करके, ऑडियंस की विशेषताओं की सूची दें. जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी (अफ़िनिटी, इन-मार्केट, और ज़िंदगी के खास पड़ाव वाली ऑडियंस). इससे उन क्रिएटर्स को ढूंढने में मदद मिलती है जिनकी ऑडियंस इन विशेषताओं से मैच करती है. क्रिएटर के एट्रिब्यूट भी दिए जा सकते हैं, ताकि उन क्रिएटर्स को फ़िल्टर किया जा सके जिनका कॉन्टेंट खास एट्रिब्यूट से मैच करता है.ListAudienceInsightsAttributesका इस्तेमाल करके, ऑडियंस के उपलब्ध एट्रिब्यूट वापस पाएं. इसके लिए, आपको अपनी ज़रूरत के हिसाब से डाइमेंशन की जानकारी देनी होगी. जैसे, दिलचस्पी के विषयों के लिएKNOWLEDGE_GRAPH. बूलियनANDऔरORग्रुप का इस्तेमाल करके एट्रिब्यूट को जोड़ने के लिए,audience_combinationsका इस्तेमाल करें. इसके बारे में ऑडियंस के जटिल कॉम्बिनेशन में बताया गया है.क्रिएटर के कॉन्टेंट के विषयों के बारे में अहम जानकारी (
search_topics):search_topicsफ़ील्ड का इस्तेमाल करके, कॉन्टेंट के विषयों की सूची दें. एपीआई, ऐसे क्रिएटर्स की जानकारी दिखाता है जो चुने गए विषयों के बारे में कॉन्टेंट बनाते हैं.country_locationsमें बताए गए देश के लिए डेटा फ़ेच किया जाता है. इस विकल्प के तहत, हर अनुरोध के लिए सिर्फ़ एक देश का डेटा फ़ेच किया जा सकता है.search_topicsमें इस्तेमाल की जा सकने वाली इकाइयों को,CONTENT_TRENDING_INSIGHTSयाCREATOR_TOPIC_INSIGHTSकी सुविधा के साथ टैग किया जाना चाहिए. इकाई की काम करने वाली सुविधाओं को वापस पाने के लिए,ListAudienceInsightsAttributesका इस्तेमाल करें.क्रिएटर की अहम जानकारी (
search_channels):search_channelsफ़ील्ड का इस्तेमाल करके, YouTube चैनल आईडी, YouTube चैनल के हैंडल (youtube_channel_handles,v25और इसके बाद के वर्शन में उपलब्ध है) या दोनों की सूची दें. एपीआई, उन चैनलों के बारे में अहम जानकारी दिखाता है.
ऑडियंस के जटिल कॉम्बिनेशन
GenerateCreatorInsights और GenerateTrendingInsights, दोनों में audience_combinations का इस्तेमाल करके, ऑडियंस के एट्रिब्यूट के बीच के जटिल संबंधों को तय किया जा सकता है. इस फ़ील्ड की मदद से, ऑडियंस एट्रिब्यूट को बूलियन लॉजिक (AND और OR) के साथ जोड़ा जा सकता है. यह audience_attributes के फ़्लैट यूनियन (OR) व्यवहार से अलग है:
audience_combinationsमें मौजूद हरInsightsAudienceAttributeGroup, अपने एट्रिब्यूट को लॉजिकलORके साथ जोड़ता है.audience_combinationsमें मौजूद कईInsightsAudienceAttributeGroupआइटम को लॉजिकलANDके साथ जोड़ा जाता है.
उदाहरण के लिए, ("Skin care" OR "Hair
care") AND "Cosmetics" में दिलचस्पी रखने वाली ऑडियंस को टारगेट करने के लिए, audience_combinations में दो InsightsAudienceAttributeGroup आइटम शामिल करें:
- ग्रुप 1 में
"Skin care"और"Hair care"के लिए, नॉलेज ग्राफ़ की इकाई के एट्रिब्यूट शामिल हैं. - ग्रुप 2 में
"Cosmetics"के लिए नॉलेज ग्राफ़ इकाई एट्रिब्यूट शामिल है (जैसे कि/m/014trl).
पूरक डेटा और स्थानीय क्रिएटर्स
डिफ़ॉल्ट रूप से, सिर्फ़ अहम जानकारी का मुख्य डेटा दिखता है. दोहराए गए फ़ील्ड supplemental_data को सेट करके, अपने जवाब में वैकल्पिक सुविधाओं और अतिरिक्त डेटा का अनुरोध किया जा सकता है.
उदाहरण के लिए, supplemental_data में LOCAL_CREATOR_DATA enum वैल्यू जोड़कर, स्थानीय क्रिएटर के डेटा का अनुरोध किया जा सकता है. अगर search_topics का इस्तेमाल करके क्रिएटर्स को खोजा जाता है और विषय, नॉलेज ग्राफ़ की ऐसी इकाई है जिसे CREATOR_TOPIC_INSIGHTS सुविधा के साथ टैग किया गया है, तो एपीआई, रिस्पॉन्स में local_creator_insights फ़ील्ड को उन स्थानीय क्रिएटर्स की जानकारी से भर देता है जिन्होंने अपनी जगह की जानकारी का डेटा शेयर करने की सहमति दी है.
स्थानीय क्रिएटर डिस्कवरी के लिए, इन बातों का ध्यान रखें:
- परिभाषा: स्थानीय क्रिएटर्स वे होते हैं जो चुने गए देश में रहते हैं या वहां से वीडियो पोस्ट करते हैं. साथ ही, उनके वीडियो उसी देश में देखे जाते हैं.
- पाबंदी: अगर अनुरोध में
sub_country_locationsसेट है, तो स्थानीय क्रिएटर डिस्कवरी की सुविधा काम नहीं करती. - Capabilities:
ListAudienceInsightsAttributesका इस्तेमाल करके, नॉलेज ग्राफ़ की उन इकाइयों की सूची और उनकी क्षमताओं की जानकारी हासिल की जा सकती है जो इस्तेमाल की जा सकती हैं.
GenerateCreatorInsights तरीका, एक GenerateCreatorInsightsResponse ऑब्जेक्ट लौटाता है. इसमें ये फ़ील्ड शामिल होते हैं:
creator_insights: आपकी मुख्य शर्तों से मैच करने वालेYouTubeCreatorInsightsऑब्जेक्ट की सूची.local_creator_insights: स्थानीय क्रिएटर्स के लिएYouTubeCreatorInsightsऑब्जेक्ट की सूची. यह सिर्फ़ तब भरा जाता है, जबLOCAL_CREATOR_DATAका अनुरोध किया गया हो और इस्तेमाल की गई शर्तsearch_topicsहो.
हर YouTubeCreatorInsights ऑब्जेक्ट में ये शामिल होते हैं:
creator_name: यह इमेज बनाने वाले का नाम बताता है.creator_channels:YouTubeChannelInsightsऑब्जेक्ट की सूची. चैनल की जानकारी औरchannel_metrics(YouTubeMetrics),creator_channelsमें मौजूद हरYouTubeChannelInsightsऑब्जेक्ट में दिखते हैं.
YouTubeMetrics ऑब्जेक्ट में ये शामिल हैं:
- सदस्यों, व्यू, और वीडियो की संख्या
- चैनल के सभी वीडियो पर मिले कुल लाइक, शेयर, और टिप्पणियों की संख्या
- लाइफ़टाइम यूज़र ऐक्टिविटी रेट (कुल यूज़र ऐक्टिविटी को कुल व्यू से भाग देने पर मिलने वाली संख्या)
- पिछले 28 दिनों में, हर वीडियो पर मिले व्यू, पसंद, शेयर, और टिप्पणियों की औसत संख्या
- शॉर्ट वीडियो को मिले व्यू और वीडियो की संख्या
- क्रिएटर, Shorts क्रिएटर या लाइव स्ट्रीम करने वाला क्रिएटर के तौर पर ऐक्टिव हो. इसके लिए, ज़रूरी है कि उसने पिछले 90 दिनों में कम से कम एक शॉर्ट वीडियो या लाइव स्ट्रीम पब्लिश की हो
- पार्टनरशिप के अवसर
यूज़र ऐक्टिविटी की दर और हर वीडियो पर मिले व्यू, पसंद, और टिप्पणियों की औसत संख्या, सार्वजनिक तौर पर नहीं दिखाई जाने वाली मेट्रिक हैं. ये मेट्रिक सिर्फ़ तब दिखती हैं, जब क्रिएटर ने इन्हें शेयर करने की सहमति दी हो.
कोई क्रिएटर, ओरिजनल ब्रैंडेड कॉन्टेंट के लिए पार्टनरशिप कर सकता है या नहीं, यह देखने के लिए partnership_opportunities की जांच करें. अगर सूची में CREATOR_PARTNERSHIPS शामिल है, तो क्रिएटर पार्टनरशिप कर सकता है.
YouTubeChannelInsights ऑब्जेक्ट में, YouTube चैनल के बारे में यह जानकारी शामिल होती है:
- चैनल का नाम, आईडी, हैंडल, यूआरएल, ब्यौरा, और थंबनेल का यूआरएल
- चैनल बनाने की तारीख और उससे जुड़ा देश
- चैनल की मेट्रिक
- चैनल की ऑडियंस की विशेषताएं (जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी के हिसाब से ब्यौरा)
- चैनल के एट्रिब्यूट (चैनल के कॉन्टेंट से जुड़े एट्रिब्यूट)
- सबसे ज़्यादा देखे गए वीडियो
- चैनल का टाइप और कॉन्टेंट की भाषाएं
- कितना सही है स्कोर (सिर्फ़ विषय के रुझान से जुड़ी खोजों के लिए)
- क्या क्रिएटर ने सार्वजनिक तौर पर उपलब्ध न होने वाली मेट्रिक शेयर करने की सहमति दी है
GenerateCreatorInsights अनुरोध और जवाब का रेफ़रंस
नीचे दिए गए एंडपॉइंट पर, ContentCreatorInsightsService को GenerateCreatorInsights कॉल करें:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
यहां दी गई टेबल में, GenerateCreatorInsightsRequest पर मौजूद फ़ील्ड की खास जानकारी दी गई है:
| फ़ील्ड पाथ | आवश्यकता | फ़ॉर्मैट और पाबंदियां |
|---|---|---|
customer_id |
ज़रूरी है | बिना हाइफ़न वाला 10 अंकों का ग्राहक आईडी (string). |
customer_insights_group |
ज़रूरी है | ग्राहक या ब्रैंड का उपयोगकर्ता के तय किया गया नाम (string), जिसके लिए प्लान बनाया जा रहा है. |
country_locations[] |
ज़रूरी है | देश LocationInfo ऑब्जेक्ट की सूची (geo_target_constant, जैसे कि "geoTargetConstants/2840"). search_topics का इस्तेमाल करने पर, इसमें सिर्फ़ एक देश शामिल होना चाहिए. |
sub_country_locations[] |
वैकल्पिक | देश के अंदर के इलाके LocationInfo के फ़िल्टर; सिर्फ़ search_attributes के साथ काम करते हैं और LOCAL_CREATOR_DATA के साथ काम नहीं करते. |
search_attributes |
criteria (oneof) |
SearchAttributes में ये शामिल हैं:• audience_attributes[]: age_range, gender, device, parental_status, income_range (audience_combinations का इस्तेमाल न होने पर, user_interest, entity या category भी).• audience_combinations[]: AND-of-ORs InsightsAudienceAttributeGroup आइटम.• creator_attributes[]: नॉलेज ग्राफ़ में entity आइटम मौजूद हैं. इनमें CREATOR_ATTRIBUTE की सुविधा है. |
search_topics |
criteria (oneof) |
SearchTopics, जिसमें entities[] (AudienceInsightsEntity, जिसमें knowledge_graph_machine_id को CREATOR_TOPIC_INSIGHTS या CONTENT_TRENDING_INSIGHTS के साथ टैग किया गया है) शामिल है. |
search_channels |
criteria (oneof) |
YouTubeChannels, जिसमें youtube_channels[] (channel_id) और/या youtube_channel_handles[] (@ से शुरू होने वाले हैंडल, जैसे कि "@youtubecreators") शामिल हों. |
supplemental_data[] |
वैकल्पिक | ContentCreatorInsightsSupplementalData वैल्यू. local_creator_insights[] को पॉप्युलेट करने के लिए, किसी एक देश के search_topics अनुरोध (CREATOR_TOPIC_INSIGHTS वाली इकाइयों के लिए) पर LOCAL_CREATOR_DATA सेट करें. |
insights_application_info |
वैकल्पिक | अनुरोध करने वाले ऐप्लिकेशन के बारे में AdditionalApplicationInfo मेटाडेटा. |
GenerateCreatorInsightsResponse मैसेज से, ये फ़ील्ड मिलते हैं:
| जानकारी का फ़ील्ड | टाइप | ब्यौरा |
|---|---|---|
creator_insights[] |
YouTubeCreatorInsights |
आपकी मुख्य शर्तों (creator_name और creator_channels[]) से मैच करने वाले क्रिएटर्स. |
local_creator_insights[] |
YouTubeCreatorInsights |
ऐसे स्थानीय क्रिएटर्स जिन्होंने जगह की जानकारी का डेटा शेयर करने की सहमति दी है. यह डेटा तब भरा जाता है, जब CREATOR_TOPIC_INSIGHTS वाली किसी इकाई पर search_topics के साथ LOCAL_CREATOR_DATA का अनुरोध किया जाता है. |
creator_channels[] |
YouTubeChannelInsights |
मेटाडेटा: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location, और data_sharing_consent_given.अहम जानकारी और कॉन्टेंट: channel_audience_attributes[] (सहमति मिलने पर ही उपलब्ध), channel_attributes[], top_videos[], language_distributions[], relevance_score (सिर्फ़ GenerateTrendingInsights के लिए उपलब्ध, जिसमें search_topics शामिल है), और channel_metrics. |
channel_metrics |
YouTubeMetrics |
सार्वजनिक मेट्रिक: 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, और partnership_opportunities[].सहमति मिलने के बाद दिखने वाली मेट्रिक: engagement_rate और हर वीडियो के लिए 28 दिनों का औसत (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video). |
GenerateCreatorInsights REST अनुरोध और रिस्पॉन्स के उदाहरण
यहां दिए गए उदाहरण में, searchAttributes का इस्तेमाल करके क्रिएटर्स को खोजने का तरीका बताया गया है. इसके लिए, डेमोग्राफ़िक audienceAttributes, बूलियन audienceCombinations ("Skin care"
OR "Hair care", AND "Cosmetics"), और 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"
}
}
]
}
}
स्थानीय क्रिएटर्स के साथ-साथ, विषय के आधार पर क्रिएटर्स को फ़िल्टर करने के लिए, searchTopics का इस्तेमाल करें. साथ ही, supplementalData में "LOCAL_CREATOR_DATA" को शामिल करें:
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"
}
]
}
}
चैनल आईडी या हैंडल के हिसाब से, YouTube के किसी चैनल की अहम जानकारी पाने के लिए, 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"
]
}
}
GenerateCreatorInsightsResponse के सफल होने पर, creatorInsights[] दिखता है. साथ ही, LOCAL_CREATOR_DATA का अनुरोध करने पर localCreatorInsights[] दिखता है:
{
"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": []
}
ट्रेंडिंग विषयों से जुड़ी अहम जानकारी जनरेट करना
रुझान वाली अहम जानकारी जनरेट करने के लिए, GenerateTrendingInsights तरीके से अनुरोध भेजें. इस तरीके में, हर सेकंड पांच क्वेरी (क्यूपीएस) की सीमा होती है. यह दो तरह के इनपुट स्वीकार करता है. यह इस बात पर निर्भर करता है कि आपको ऑडियंस के रुझान चाहिए या विषय के रुझान. साथ ही, इसके लिए टारगेट किए गए देश की जगह की जानकारी देना ज़रूरी है.
ऑडियंस के रुझान (
search_audience):search_audienceकेaudience_attributesफ़ील्ड में, ऑडियंस के एट्रिब्यूट (जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी) की सूची दें. साथ ही, बूलियनAND/ORलॉजिक के साथ एट्रिब्यूट को जोड़ने के लिए,audience_combinationsका इस्तेमाल करें. हालांकि, ऐसा करना ज़रूरी नहीं है. एपीआई, उन ऑडियंस के लिए रुझान वाली अहम जानकारी की सूची दिखाता है. इसमें तुलना की अवधि के दौरान, रुझान की वैल्यू में हुए बदलाव का प्रतिशत जैसी मेट्रिक शामिल होती हैं.जिन डेवलपर के पास
ContentCreatorInsightsServiceका ऐक्सेस है उनके पासAudienceInsightsServiceमेंListAudienceInsightsAttributesका ऐक्सेस अपने-आप होता है. ज़्यादा जानकारी के लिए, ऑडियंस के बारे में अहम जानकारी देने वाली गाइड देखें.AudienceInsightsServiceमें मौजूद अन्य एंडपॉइंट के लिए, अनुमति वाली एक अलग सूची की ज़रूरत होती है.ट्रेंड में चल रहे विषय (
search_topics):search_topicsफ़ील्ड में, कॉन्टेंट के विषयों की सूची दें. एपीआई, उन विषयों के लिए रुझान से जुड़ी अहम जानकारी दिखाता है. इसमें तुलना की अवधि के दौरान, रुझान की वैल्यू में हुए प्रतिशत बदलाव की जानकारी भी शामिल होती है.supplemental_dataसेट करके, स्थानीय क्रिएटर्स या ब्रैंड के बारे में लोगों की राय की अहम जानकारी का अनुरोध भी किया जा सकता है.ListAudienceInsightsAttributesसे मिलेKNOWLEDGE_GRAPHएट्रिब्यूट में, एक या उससे ज़्यादाInsightsKnowledgeGraphEntityCapabilitiesटैग शामिल होते हैं.CONTENT_TRENDING_INSIGHTSटैग वाली इकाइयों कोGenerateTrendingInsightsमें विषयों के तौर पर इस्तेमाल किया जा सकता है.
पूरक डेटा और स्थानीय क्रिएटर्स
क्रिएटर के लिए अहम जानकारी जनरेट करने की तरह ही, ट्रेंडिंग विषयों की अहम जानकारी में भी वैकल्पिक सुविधाओं का अनुरोध किया जा सकता है. इसके लिए, दोहराए गए फ़ील्ड supplemental_data को LOCAL_CREATOR_DATA या BRAND_SENTIMENT_DATA पर सेट करें:
- स्थानीय क्रिएटर्स (
LOCAL_CREATOR_DATA): जब ट्रेंडिंग अनुरोध मेंsearch_topicsका इस्तेमाल किया जाता है (और विषय, नॉलेज ग्राफ़ की ऐसी इकाई होता है जिसेCREATOR_TOPIC_INSIGHTSक्षमता के साथ टैग किया गया है), तोsupplemental_dataकोLOCAL_CREATOR_DATAपर सेट करने से, दिखाए गएTrendInsightऑब्जेक्ट परrelated_local_creatorsफ़ील्ड में, उन स्थानीय क्रिएटर्स की जानकारी अपने-आप भर जाती है जिन्होंने अपनी जगह की जानकारी का डेटा शेयर करने की सहमति दी है. स्थानीय क्रिएटर डिस्कवरी की सुविधा,sub_country_locationsके साथ काम नहीं करती. - ब्रैंड के बारे में लोगों की राय (
BRAND_SENTIMENT_DATA): जब ट्रेंडिंग के लिए किए गए आपके अनुरोध मेंsearch_topicsका इस्तेमाल किया जाता है और अनुरोध किए गए नॉलेज ग्राफ़ की इकाई के विषय मेंBRANDकी सुविधा होती है, तोsupplemental_dataकोBRAND_SENTIMENT_DATAपर सेट करने से, दिखाए गएTrendInsightऑब्जेक्ट परbrand_sentiment_insightsफ़ील्ड अपने-आप भर जाता है.
ब्रैंड के लिए लोगों के रुझान का आकलन करने के लिए, Gemini के एआई मॉडल का इस्तेमाल करके, ब्रैंड से जुड़े YouTube वीडियो कॉन्टेंट का विश्लेषण किया जाता है. इसके बाद, रुझान को अच्छा, खराब या सामान्य के तौर पर कैटगरी में बांटा जाता है. सिर्फ़ वीडियो वाले कॉन्टेंट का विश्लेषण किया जाता है. इसमें उपयोगकर्ताओं की टिप्पणियां शामिल नहीं होती हैं.
ट्रेंडिंग इनसाइट का मेटाडेटा
GenerateTrendingInsights वाला तरीका, TrendInsight ऑब्जेक्ट की सूची दिखाता है. हर ऑब्जेक्ट में ये शामिल होते हैं:
trend_attribute: ट्रेंड के लिए मुख्यAudienceInsightsAttributeMetadata.trend_metrics: रुझान के लिए मेट्रिक, जैसे कि तुलना की अवधि के दौरान प्रतिशत में बदलाव.trend:InsightsTrendवैल्यू (EMERGING,RISING,SUSTAINEDयाDECLINING), जो ट्रेंड की दिशा दिखाती है. बदलाव का साइज़ देखने के लिए,trend_metrics.trend_change_percentदेखें.trend_data_points: रुझान के लिए पुराने डेटा पॉइंट. सिर्फ़search_topicsका इस्तेमाल करने वाले रुझानों के लिए जानकारी अपने-आप भर जाती है.related_videos: ट्रेंडिंग वीडियो के लिए,AudienceInsightsAttributeMetadataऑब्जेक्ट की सूची. ये वीडियो, ट्रेंड के विषय से जुड़े होते हैं. यह सूची सिर्फ़search_topicsका इस्तेमाल करने वाले ट्रेंड के लिए भरी जाती है. इन एट्रिब्यूट के लिए, नेस्ट किए गएYouTubeVideoAttributeMetadataको वीडियो-लेवल के मेटाडेटा (यूआरएल, थंबनेल का यूआरएल, व्यू और पसंद की संख्या) और चैनल-लेवल के मेटाडेटा (चैनल आईडी, नाम, और यूआरएल) से भरा जाता है.related_creators: ट्रेंड के विषय से जुड़े क्रिएटर्स के लिए,YouTubeCreatorInsightsऑब्जेक्ट की सूची. यह सूची सिर्फ़search_topicsका इस्तेमाल करने वाले ट्रेंड के लिए भरी जाती है.related_local_creators: ट्रेंड के विषय से जुड़े स्थानीय क्रिएटर्स केYouTubeCreatorInsightsऑब्जेक्ट की सूची. इसमें वे क्रिएटर्स शामिल हैं जिन्होंने अपनी जगह की जानकारी का डेटा शेयर करने की सहमति दी है. यह जानकारी सिर्फ़ तब भरी जाती है, जबLOCAL_CREATOR_DATAका अनुरोध किया जाता है (पूरक डेटा, स्थानीय क्रिएटर्स, और ब्रैंड के बारे में लोगों की राय देखें).brand_sentiment_insights: रुझान के लिएBrandSentimentInsightऑब्जेक्ट की सूची. यह सूची तब भरी जाती है, जब अनुरोध में किसी ऐसी इकाई के लिएsearch_topicsका इस्तेमाल किया जाता है जिसमेंBRANDकी सुविधा हो औरBRAND_SENTIMENT_DATAका अनुरोध किया गया हो. हरBrandSentimentInsightऑब्जेक्ट में यह जानकारी शामिल होती है:month: वह महीना जिसके लिए ब्रैंड के बारे में लोगों की राय कोYYYY-MMफ़ॉर्मैट में दिखाया गया है.has_insufficient_data: ब्रैंड के लिए लोगों के रुझान का हिसाब लगाने के लिए, ज़रूरत के मुताबिक डेटा मौजूद है या नहीं.sentiment_distributions: सकारात्मक, नकारात्मक, और सामान्य रुझान के बीच का बंटवारा. इसका हिसाब, ब्रैंड से जुड़े वीडियो को मिले व्यू के अनुपात के आधार पर लगाया जाता है. इसमें हर रुझान को ध्यान में रखा जाता है.sentiment_summaries: ब्रैंड से जुड़े कॉन्टेंट में मौजूद पॉज़िटिव और नेगेटिव थीम की एआई से जनरेट की गई खास जानकारी. साथ ही, हर तरह की भावना के लिए सैंपल वीडियो. खास जानकारी सिर्फ़ अच्छे और खराब रुझान के लिए जनरेट की जाती है, सामान्य रुझान के लिए नहीं.
GenerateTrendingInsights अनुरोध और जवाब का रेफ़रंस
नीचे दिए गए एंडपॉइंट पर, ContentCreatorInsightsService को GenerateTrendingInsights कॉल करें:
POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights
यहां दी गई टेबल में, GenerateTrendingInsightsRequest पर मौजूद फ़ील्ड की खास जानकारी दी गई है:
| फ़ील्ड पाथ | आवश्यकता | फ़ॉर्मैट और पाबंदियां |
|---|---|---|
customer_id |
ज़रूरी है | बिना हाइफ़न वाला 10 अंकों का ग्राहक आईडी (string). |
customer_insights_group |
ज़रूरी है | ग्राहक या ब्रैंड का उपयोगकर्ता के तय किया गया नाम (string), जिसके लिए प्लान बनाया जा रहा है. |
country_location |
ज़रूरी है | एक देश LocationInfo (geo_target_constant, जैसे कि "geoTargetConstants/2840"). |
sub_country_locations[] |
वैकल्पिक | देश के अंदर के इलाके के लिए LocationInfo फ़िल्टर; सिर्फ़ search_audience के लिए काम करते हैं और LOCAL_CREATOR_DATA के साथ काम नहीं करते. |
search_audience |
criteria (oneof) |
SearchAudience में ये शामिल होने चाहिए:• audience_attributes[] (ज़रूरी है): age_range, gender, parental_status, income_range (audience_combinations का इस्तेमाल न होने पर, user_interest, entity या category भी).• audience_combinations[] (ज़रूरी नहीं): AND-of-ORs एट्रिब्यूट ग्रुप. |
search_topics |
criteria (oneof) |
SearchTopics, जिसमें entities[] शामिल है (AudienceInsightsEntity, जिसमें knowledge_graph_machine_id को CONTENT_TRENDING_INSIGHTS के साथ टैग किया गया है). |
supplemental_data[] |
वैकल्पिक | ContentCreatorInsightsSupplementalData वैल्यू:• LOCAL_CREATOR_DATA: CREATOR_TOPIC_INSIGHTS के साथ search_topics इकाइयों के लिए related_local_creators[] को पॉप्युलेट करता है.• BRAND_SENTIMENT_DATA: BRAND के साथ search_topics इकाइयों के लिए brand_sentiment_insights[] को पॉप्युलेट करता है. |
insights_application_info |
वैकल्पिक | अनुरोध करने वाले ऐप्लिकेशन के बारे में AdditionalApplicationInfo मेटाडेटा. |
GenerateTrendingInsightsResponse मैसेज, trend_insights[] में TrendInsight एंट्री दिखाता है:
TrendInsight फ़ील्ड |
टाइप | ब्यौरा |
|---|---|---|
trend_attribute |
AudienceInsightsAttributeMetadata |
ट्रेंड के लिए मुख्य एट्रिब्यूट (dimension, display_name, attribute). |
trend_metrics |
TrendInsightMetrics |
तुलना के लिए चुनी गई तीन महीने की अवधि (views_count और views_indexed_value, search_topics के लिए; audience_share, search_audience के लिए; trend_change_percent) के दौरान मेट्रिक. |
trend |
InsightsTrend |
रुझान की दिशा (EMERGING, RISING, SUSTAINED या DECLINING). |
trend_data_points[] |
TrendInsightDataPoint |
हर महीने का पुराना डेटा (YYYY-MM फ़ॉर्मैट में month और trend_metrics); search_topics के लिए भरा गया. |
related_videos[] |
AudienceInsightsAttributeMetadata |
YouTubeVideoAttributeMetadata वाले ट्रेंडिंग वीडियो; search_topics के लिए पॉप्युलेट किए गए. |
related_creators[] |
YouTubeCreatorInsights |
विषय से जुड़े क्रिएटर्स; search_topics के लिए जानकारी भरी गई. |
related_local_creators[] |
YouTubeCreatorInsights |
सहमति देने वाले स्थानीय क्रिएटर्स; search_topics के लिए पॉप्युलेट किया गया, जब CREATOR_TOPIC_INSIGHTS वाली इकाई पर LOCAL_CREATOR_DATA का अनुरोध किया जाता है. |
brand_sentiment_insights[] |
BrandSentimentInsight |
ब्रैंड के बारे में हर महीने की भावना (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); search_topics के लिए पॉप्युलेट किया जाता है, जब BRAND क्षमता वाली इकाई पर BRAND_SENTIMENT_DATA का अनुरोध किया जाता है. |
GenerateTrendingInsights REST अनुरोध और जवाब का उदाहरण
यहां दिए गए उदाहरण में, नॉलेज ग्राफ़ ब्रैंड इकाई (/g/11example_brand, जिसे CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS, और BRAND के साथ टैग किया गया है) के लिए, searchTopics का इस्तेमाल करके GenerateTrendingInsights को कॉल किया गया है. साथ ही, LOCAL_CREATOR_DATA और 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"
}
]
}
}
GenerateTrendingInsightsResponse के सही तरीके से काम करने पर, trendInsights[] में TrendInsight एंट्री दिखती हैं:
{
"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
Google Issue Tracker का इस्तेमाल करके, सहायता से जुड़े सवाल पूछें, गड़बड़ियों की शिकायत करें या सुविधाओं के लिए अनुरोध सबमिट करें. Google, आपके अनुरोधों को ट्रैक करता है, उन्हें प्राथमिकता देता है, और उनसे जुड़े अपडेट सीधे Issue Tracker में पोस्ट करता है. ज़्यादा जानकारी के लिए, Google Issue Tracker में कोई समस्या दर्ज करना लेख पढ़ें.
Issue Tracker के इनमें से किसी एक टेंप्लेट का इस्तेमाल करके, समस्या की जानकारी दें:
- सहायता पाने के लिए कोई सामान्य सवाल पूछना या दस्तावेज़ के बारे में अपनी शिकायत, सुझाव या राय सबमिट करना
- किसी तकनीकी गड़बड़ी की शिकायत करना
- एपीआई की सुविधा का अनुरोध सबमिट करना
टेंप्लेट के सभी फ़ील्ड में पूरी जानकारी भरें, ताकि Google आपके अनुरोध को फिर से जनरेट कर सके और उसे प्राथमिकता दे सके. Google, अधूरी रिपोर्ट बंद कर सकता है और आपसे नई समस्या सबमिट करने के लिए कह सकता है. इसमें आपको वह जानकारी देनी होगी जो आपने पहले नहीं दी थी.