YouTube क्रिएटर के लिए अहम जानकारी

ध्यान दें: यह सुविधा बीटा वर्शन में है और सिर्फ़ उन डेवलपर के लिए उपलब्ध है जिन्हें अनुमति दी गई है.

क्रिएटर के बारे में अहम जानकारी पाने की सुविधा का इस्तेमाल करके, YouTube क्रिएटर्स के बारे में अहम जानकारी पाएं और उसे फ़ेच करें. यह उन एजेंसियों और विज्ञापन देने वाले लोगों या कंपनियों के लिए काम का हो सकता है जिन्हें अपनी टारगेट ऑडियंस से मिलते-जुलते क्रिएटर्स को ढूंढना है.

इस एपीआई के चार मुख्य फ़ंक्शन हैं:

1. क्रिएटर को खोजने की सुविधा: विषयों, डेमोग्राफ़िक, ऑडियंस या क्रिएटर की विशेषताओं के दिए गए सेट के लिए, काम के क्रिएटर्स ढूंढें.
2. क्रिएटर के विषय से जुड़ी अहम जानकारी: उन क्रिएटर्स के बारे में अहम जानकारी पाएं जो चुने गए विषयों पर कॉन्टेंट बनाते हैं.
3. क्रिएटर के बारे में अहम जानकारी: किसी YouTube चैनल के बारे में अहम जानकारी पाएं. जैसे, उसके सदस्यों की संख्या, व्यू की संख्या, और ऑडियंस के डेमोग्राफ़िक.
4. ट्रेंडिंग इनसाइट: किसी खास ऑडियंस या विषय के आधार पर, किसी खास ट्रेंड के बारे में अहम जानकारी पाएं.

विषय के हिसाब से क्रिएटर्स को खोजने या ट्रेंडिंग अहम जानकारी का इस्तेमाल करते समय, स्थानीय क्रिएटर्स को खोजने की सुविधा उपलब्ध होती है. इसके लिए, अतिरिक्त डेटा का अनुरोध करना होता है. स्थानीय क्रिएटर्स से हमारा मतलब ऐसे क्रिएटर्स से है जो किसी देश में रहते हैं या वहां से वीडियो पोस्ट करते हैं और उनके वीडियो उसी देश में देखे जाते हैं.

ज़रूरी शर्तें

GenerateCreatorInsights, Google Ads API का एक निजी कॉम्पोनेंट है. इसे बिना किसी खास अधिकार के, बिना रॉयल्टी वाले डेटा लाइसेंस के साथ उपलब्ध कराया जाता है. साइन किए गए पार्टनर, YouTube क्रिएटर्स और कॉन्टेंट को एक्सप्लोर करने के लिए, Google Ads की स्टैंडर्ड क्लाइंट लाइब्रेरी का इस्तेमाल कर सकते हैं. ज़रूरी शर्तें पूरी करने के लिए, पार्टनर को ये शर्तें पूरी करनी होंगी:

• आपके पास ऐसा प्लानिंग टूल या यूज़र इंटरफ़ेस होना चाहिए जो Google Ads API के साथ इंटिग्रेट हो.
• विज्ञापन दिखाने के संभावित मौकों के लिए, YouTube कॉन्टेंट और क्रिएटर्स को एक्सप्लोर करने के लिए, API का इस्तेमाल करें.
• ज़रूरी शर्तें पूरी करने के लिए, शुरुआती जांच असेसमेंट पूरा करें.
• डेटा के इस्तेमाल से जुड़ी ज़रूरी शर्तों का पालन करें. साथ ही, समय-समय पर होने वाले डेटा ऑडिट के लिए तैयार रहें.
• डेटा लाइसेंसिंग समझौते पर हस्ताक्षर करें. इससे डेटा के इस्तेमाल से जुड़ी कानूनी शर्तों को लागू किया जा सकेगा.
• Google Ads API की सेवा की शर्तें स्वीकार करें.

ज़्यादा जानकारी के लिए, अपने Google प्रतिनिधि से संपर्क करें.

क्रिएटर के बारे में अहम जानकारी जनरेट करना

क्रिएटर के बारे में अहम जानकारी जनरेट करने के लिए, GenerateCreatorInsights तरीके से अनुरोध भेजें. इस तरीके में, क्वेरी प्रति सेकंड (क्यूपीएस) की सीमा 5 है. यह अलग-अलग तरह के इनपुट लेता है. यह इस बात पर निर्भर करता है कि आपको क्रिएटर की खोज करनी है, विषयों के हिसाब से काम के क्रिएटर्स खोजने हैं या क्रिएटर के बारे में अहम जानकारी हासिल करनी है. आपको उन देशों की जानकारी देनी होगी जहां से आपको डेटा चाहिए.

1. क्रिएटर को खोजने की सुविधा: ऑडियंस के एट्रिब्यूट की सूची दी जा सकती है. जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी (इसमें अफ़िनिटी, इन-मार्केट, और लाइव इवेंट ऑडियंस शामिल हैं). एपीआई, उन क्रिएटर्स की सूची दिखाता है जिनकी ऑडियंस इन एट्रिब्यूट से मेल खाती है. क्रिएटर एट्रिब्यूट भी दिए जा सकते हैं. इससे उन क्रिएटर्स को फ़िल्टर किया जा सकता है जिनका कॉन्टेंट, आपके दिए गए क्रिएटर्स के एट्रिब्यूट से मेल खाता है.

   उपलब्ध ऑडियंस एट्रिब्यूट को वापस पाने के लिए, ListAudienceInsightsAttributes का इस्तेमाल किया जा सकता है. इसके लिए, उन डाइमेंशन की जानकारी दें जिनके लिए आपको एट्रिब्यूट चाहिए. जैसे, KNOWLEDGE_GRAPH दिलचस्पी के विषयों के लिए.

   Google Ads API v23 से, audience_combinations का इस्तेमाल करके ऑडियंस एट्रिब्यूट के जटिल संबंध तय किए जा सकते हैं. इस फ़ील्ड की मदद से, बूलियन लॉजिक (AND/OR) का इस्तेमाल करके ऑडियंस तय की जा सकती हैं. ऐसा audience_attributes की मदद से नहीं किया जा सकता.

   audience_attributes, यूनाइडेट (OR के साथ जोड़े गए) एट्रिब्यूट की सूची के आधार पर टारगेटिंग के लिए सही है.उदाहरण के लिए, "खेल-कूद" या "यात्रा" या ... में दिलचस्पी रखने वाले उपयोगकर्ता. वहीं, audience_combinations से ज़्यादा कंट्रोल मिलता है. audience_combinations में मौजूद हर InsightsAudienceAttributeGroup, एट्रिब्यूट को लॉजिकल OR के साथ जोड़ता है. इसके बाद, इन ग्रुप को लॉजिकल AND के साथ जोड़ा जाता है.

   उदाहरण के लिए, अगर आपको "स्किन केयर" या "बालों की देखभाल" में दिलचस्पी रखने वाले और "कॉस्मेटिक्स" में भी दिलचस्पी रखने वाले दर्शकों को टारगेट करना है, तो आपको audience_combinations में दो InsightsAudienceAttributeGroup आइटम इस्तेमाल करने होंगे. "स्किन केयर", "बालों की देखभाल", और "कॉस्मेटिक्स" दिलचस्पी के विषय हैं. इन्हें नॉलेज ग्राफ़ की इकाइयों के ज़रिए दिखाया जाता है. उदाहरण के लिए, कॉस्मेटिक्स के लिए /m/014trl. पहले ग्रुप में "स्किन केयर" और "बालों की देखभाल" के लिए, नॉलेज ग्राफ़ की इकाई के एट्रिब्यूट शामिल होंगे. वहीं, दूसरे ग्रुप में "कॉस्मेटिक्स" के लिए, नॉलेज ग्राफ़ की इकाई का एट्रिब्यूट शामिल होगा.

   ध्यान दें कि अगर आपने audience_attributes में नॉलेज ग्राफ़ की इकाइयां, प्रॉडक्ट और सेवा की कैटगरी या उपयोगकर्ता की दिलचस्पी के बारे में बताया है, तो audience_combinations का इस्तेमाल नहीं किया जा सकता. audience_combinations का इस्तेमाल करने पर, आपको इन एट्रिब्यूट की वैल्यू audience_combinations में देनी होगी, न कि audience_attributes में. हालांकि, audience_combinations के साथ-साथ audience_attributes का इस्तेमाल अन्य एट्रिब्यूट टाइप के लिए किया जा सकता है. जैसे, डेमोग्राफ़िक.

2. क्रिएटर के पसंदीदा विषय से जुड़ी अहम जानकारी: search_topics फ़ील्ड का इस्तेमाल करके, कॉन्टेंट के विषयों की सूची दें. एपीआई, उन क्रिएटर्स की जानकारी देता है जो चुने गए विषयों के बारे में कॉन्टेंट बनाते हैं. फ़ेच किया गया डेटा, country_locations में दिए गए देश के हिसाब से होता है. ध्यान दें कि इस विकल्प से, सिर्फ़ एक देश के लिए खोज की जा सकती है.

   SearchTopics फ़ील्ड में शामिल की गई इकाइयों को CONTENT_TRENDING_INSIGHTS या CREATOR_TOPIC_INSIGHTS सुविधा के साथ टैग किया जाना चाहिए. ज़रूरी शर्तें पूरी करने वाली इकाई की क्षमताओं को वापस पाने के लिए, ListAudienceInsightsAttributes तरीके का इस्तेमाल करें.

   ध्यान दें: search_brand विकल्प के इस्तेमाल पर v24.2 में रोक लगा दी गई थी और इसे v25 में हटा दिया गया था. इसके बजाय, search_topics का इस्तेमाल करें.

3. क्रिएटर से जुड़ी अहम जानकारी: search_channels फ़ील्ड का इस्तेमाल करके, YouTube चैनल आईडी की सूची दें. एपीआई, उन चैनलों के बारे में अहम जानकारी दिखाता है.

पूरक डेटा और स्थानीय क्रिएटर्स

डिफ़ॉल्ट रूप से, सिर्फ़ मुख्य अहम जानकारी का डेटा दिखता है. supplemental_data को बार-बार सेट करके, जवाब में वैकल्पिक सुविधाएं और अतिरिक्त डेटा पाने का अनुरोध किया जा सकता है.

उदाहरण के लिए, supplemental_data फ़ील्ड में LOCAL_CREATOR_DATA enum वैल्यू जोड़कर, स्थानीय क्रिएटर के डेटा का अनुरोध किया जा सकता है. अगर आपको search_topics का इस्तेमाल करके क्रिएटर्स ढूंढने हैं और विषय, नॉलेज ग्राफ़ की ऐसी इकाई है जिसे CREATOR_TOPIC_INSIGHTS केपबिलिटी के साथ टैग किया गया है, तो एपीआई, जवाब में local_creator_insights फ़ील्ड में स्थानीय क्रिएटर्स की जानकारी देगा. ये ऐसे क्रिएटर्स होंगे जिन्होंने अपनी जगह की जानकारी का डेटा शेयर करने की सहमति दी है.

स्थानीय क्रिएटर्स को खोजने की सुविधा के लिए, यहां दिए गए स्पेसिफ़िकेशन पर ध्यान दें:

• परिभाषा: "स्थानीय क्रिएटर्स" ऐसे क्रिएटर्स होते हैं जो चुने गए देश में रहते हैं या वहां से पोस्ट करते हैं. साथ ही, उनके वीडियो उसी देश में देखे जाते हैं.
• पाबंदी: अनुरोध में sub_country_locations सेट होने पर, स्थानीय क्रिएटर को खोजने की सुविधा नहीं काम करती.
• सुविधाएं: ListAudienceInsightsAttributes का इस्तेमाल करके, नॉलेज ग्राफ़ की उन इकाइयों की सूची और उनकी सुविधाओं को वापस पाया जा सकता है जिनका इस्तेमाल किया जा सकता है.

generateCreatorInsights वाला तरीका, GenerateCreatorInsightsResponse ऑब्जेक्ट दिखाता है. इस ऑब्जेक्ट में ये फ़ील्ड शामिल होते हैं:

• creator_insights: आपकी मुख्य शर्तों से मेल खाने वाले YouTubeCreatorInsights ऑब्जेक्ट की सूची.
• local_creator_insights: इसमें स्थानीय क्रिएटर्स के लिए YouTubeCreatorInsights ऑब्जेक्ट की सूची होती है. यह फ़ील्ड सिर्फ़ तब दिखता है, जब LOCAL_CREATOR_DATA का अनुरोध किया गया हो और इस्तेमाल की गई शर्त search_topics हो.

हर YouTubeCreatorInsights ऑब्जेक्ट में, क्रिएटर के बारे में यह जानकारी होती है:

• क्रिएटर का नाम
• YouTube चैनल
• क्रिएटर से जुड़ी कुल मेट्रिक
• YouTube चैनल की अहम जानकारी की सूची

YouTubeMetrics ऑब्जेक्ट में ये मेट्रिक शामिल होती हैं:

• सदस्यों की संख्या
• व्यू की संख्या
• वीडियो की संख्या
• Shorts पर ऐक्टिव क्रिएटर हो
• पार्टनरशिप के अवसर (v23 से शुरू)

यह पता लगाने के लिए कि कोई क्रिएटर, ओरिजनल ब्रैंडेड कॉन्टेंट पार्टनरशिप की ज़रूरी शर्तें पूरी करता है या नहीं, partnership_opportunities देखें. अगर सूची में CREATOR_PARTNERSHIPS वैल्यू मौजूद है, तो इसका मतलब है कि क्रिएटर ज़रूरी शर्तें पूरी करता है.

YouTubeChannelInsights ऑब्जेक्ट में, किसी YouTube चैनल के बारे में यह जानकारी शामिल होती है:

• चैनल का नाम
• चैनल आईडी
• चैनल का यूआरएल
• चैनल का ब्यौरा
• चैनल की मेट्रिक
• चैनल की ऑडियंस के एट्रिब्यूट (जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी के हिसाब से जानकारी)
• सबसे ज़्यादा देखे गए वीडियो
• चैनल प्रकार
• चैनल के कॉन्टेंट से जुड़ी भाषाएं
• विषय के रुझान की खोजों के लिए, काम का होने का स्कोर
• क्या क्रिएटर ने गैर-सार्वजनिक मेट्रिक शेयर करने की सहमति दी है

ट्रेंडिंग इनसाइट जनरेट करना

ट्रेंडिंग इनसाइट जनरेट करने के लिए, GenerateTrendingInsights तरीके का इस्तेमाल करके अनुरोध भेजें. इस तरीके में, क्वेरी प्रति सेकंड (क्यूपीएस) की सीमा 5 है. इसमें दो तरह के इनपुट लिए जाते हैं. यह इस बात पर निर्भर करता है कि आपको ऑडियंस के रुझान जानने हैं या विषय के रुझान. आपको उस देश की जगह की जानकारी देनी होगी जहां से आपको रुझान की जानकारी चाहिए.

1. ऑडियंस के रुझान: ऑडियंस के एट्रिब्यूट की सूची दी जा सकती है. जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी (इसमें अफ़िनिटी ऑडियंस, इन-मार्केट ऑडियंस, और ज़िंदगी के खास पड़ाव वाली ऑडियंस शामिल हैं). एपीआई, उन ऑडियंस के लिए रुझान वाली अहम जानकारी की सूची दिखाता है. इसमें तुलना की अवधि के दौरान, रुझान की वैल्यू में हुए बदलाव के प्रतिशत जैसी मेट्रिक शामिल होती हैं.

   उपलब्ध ऑडियंस एट्रिब्यूट को वापस पाने के लिए, ListAudienceInsightsAttributes का इस्तेमाल किया जा सकता है. इसके लिए, उन डाइमेंशन की जानकारी दें जिनके लिए आपको एट्रिब्यूट चाहिए. जैसे, KNOWLEDGE_GRAPH दिलचस्पी के विषयों के लिए.

   Google Ads API v23 से, audience_combinations का इस्तेमाल करके ऑडियंस एट्रिब्यूट के जटिल संबंध तय किए जा सकते हैं. इस फ़ील्ड की मदद से, बूलियन लॉजिक (AND/OR) का इस्तेमाल करके ऑडियंस तय की जा सकती हैं. ऐसा audience_attributes की मदद से नहीं किया जा सकता.

   audience_attributes, यूनाइडेट (OR के साथ जोड़े गए) एट्रिब्यूट की सूची के आधार पर टारगेटिंग के लिए सही है.उदाहरण के लिए, "खेल-कूद" या "यात्रा" या ... में दिलचस्पी रखने वाले उपयोगकर्ता. वहीं, audience_combinations से ज़्यादा कंट्रोल मिलता है. audience_combinations में मौजूद हर InsightsAudienceAttributeGroup, एट्रिब्यूट को लॉजिकल OR के साथ जोड़ता है. इसके बाद, इन ग्रुप को लॉजिकल AND के साथ जोड़ा जाता है.

   उदाहरण के लिए, अगर आपको "स्किन केयर" या "बालों की देखभाल" में दिलचस्पी रखने वाले और "कॉस्मेटिक्स" में भी दिलचस्पी रखने वाले दर्शकों को टारगेट करना है, तो आपको audience_combinations में दो InsightsAudienceAttributeGroup आइटम इस्तेमाल करने होंगे. "स्किन केयर", "बालों की देखभाल", और "कॉस्मेटिक्स" दिलचस्पी के विषय हैं. इन्हें नॉलेज ग्राफ़ की इकाइयों के ज़रिए दिखाया जाता है. उदाहरण के लिए, कॉस्मेटिक्स के लिए /m/014trl. पहले ग्रुप में "स्किन केयर" और "बालों की देखभाल" के लिए, नॉलेज ग्राफ़ की इकाई के एट्रिब्यूट शामिल होंगे. वहीं, दूसरे ग्रुप में "कॉस्मेटिक्स" के लिए, नॉलेज ग्राफ़ की इकाई का एट्रिब्यूट शामिल होगा.

   ध्यान दें कि अगर आपने audience_attributes में नॉलेज ग्राफ़ की इकाइयां, प्रॉडक्ट और सेवा की कैटगरी या उपयोगकर्ता की दिलचस्पी के बारे में बताया है, तो audience_combinations का इस्तेमाल नहीं किया जा सकता. audience_combinations का इस्तेमाल करने पर, आपको इन एट्रिब्यूट की वैल्यू audience_combinations में देनी होगी, न कि audience_attributes में. हालांकि, audience_combinations के साथ-साथ audience_attributes का इस्तेमाल अन्य एट्रिब्यूट टाइप के लिए किया जा सकता है. जैसे, डेमोग्राफ़िक.

   KNOWLEDGE_GRAPH एट्रिब्यूट में एक या उससे ज़्यादा InsightsKnowledgeGraphEntityCapabilities टैग होंगे. ट्रेंडिंग इनसाइट के लिए काम करने वाले एट्रिब्यूट के जवाब के मेटाडेटा में, उनसे जुड़े टैग मौजूद होंगे.

   ध्यान दें कि जिन डेवलपर के पास ContentCreatorInsightsService का ऐक्सेस है उन्हें AudienceInsightsService.ListAudienceInsightsAttributes का ऐक्सेस अपने-आप मिल जाएगा. AudienceInsightsService में मौजूद अन्य एंडपॉइंट के लिए, अनुमति वाली सूची में शामिल होने की अलग प्रोसेस की ज़रूरत होती है.

   ListAudienceInsightsAttributes के बारे में ज़्यादा जानकारी, ऑडियंस के बारे में अहम जानकारी देने वाली गाइड में देखी जा सकती है.

2. विषय से जुड़े रुझान: कॉन्टेंट के विषयों की सूची उपलब्ध कराएं. एपीआई, उन विषयों के लिए ट्रेंडिंग इनसाइट की सूची दिखाता है. इसमें ऐसी मेट्रिक शामिल होती हैं जैसे कि तुलना की अवधि के दौरान, ट्रेंड की वैल्यू में हुए बदलाव का प्रतिशत.

पूरक डेटा और स्थानीय क्रिएटर्स

क्रिएटर इनसाइट जनरेट करने की तरह ही, ट्रेंडिंग इनसाइट में वैकल्पिक सुविधाओं का अनुरोध किया जा सकता है. इसके लिए, दोहराए गए फ़ील्ड supplemental_data को LOCAL_CREATOR_DATA पर सेट करें.

अगर ट्रेंडिंग अनुरोध में search_topics का इस्तेमाल किया जाता है, तो इससे जवाब में मिले TrendInsight ऑब्जेक्ट में मौजूद related_local_creators फ़ील्ड भर जाएगा. इसमें अनुरोध किए गए विषय से जुड़े स्थानीय क्रिएटर्स की जानकारी होगी. इन क्रिएटर्स ने अपनी जगह की जानकारी का डेटा शेयर करने की सहमति दी है. लोकल क्रिएटर खोजने की सुविधा पर भी वही परिभाषा और शर्तें लागू होती हैं. जैसे, यह सुविधा sub_country_locations के साथ काम नहीं करती.

ट्रेंडिंग से जुड़ी अहम जानकारी का मेटाडेटा

GenerateTrendingInsights तरीका, TrendInsight ऑब्जेक्ट की सूची दिखाता है. हर ऑब्जेक्ट में ये शामिल होते हैं:

• trend_attribute: ट्रेंड के लिए प्राइमरी AudienceInsightsAttributeMetadata.
• trend_metrics: ट्रेंड के लिए मेट्रिक, जैसे कि तुलना की अवधि में प्रतिशत बदलाव.
• trend_data_points: रुझान के लिए ऐतिहासिक डेटा पॉइंट. सिर्फ़ search_topics का इस्तेमाल करके रुझानों के लिए जानकारी अपने-आप भर जाती है.
• related_videos: इसमें ट्रेंड के विषय से जुड़े ट्रेंडिंग वीडियो के AudienceInsightsAttributeMetadata ऑब्जेक्ट की सूची होती है. यह सिर्फ़ search_topics का इस्तेमाल करके ट्रेंड के लिए अपने-आप भर जाता है. इन एट्रिब्यूट के लिए, नेस्ट किया गया YouTubeVideoAttributeMetadata फ़ील्ड भरा जाता है. इसमें वीडियो-लेवल का मेटाडेटा (जैसे, वीडियो का यूआरएल, थंबनेल का यूआरएल, और व्यू या पसंद किए जाने की संख्या) और चैनल-लेवल का मेटाडेटा (जैसे, चैनल आईडी, नाम, और यूआरएल) शामिल होता है.