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

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

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

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

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

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

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

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

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

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

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

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

   उपलब्ध ऑडियंस एट्रिब्यूट को वापस पाने के लिए, AudienceInsightsService.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. क्रिएटर के ब्रैंड के बारे में अहम जानकारी: सबसे लोकप्रिय क्रिएटर्स को खोजने के लिए, कोई ब्रैंड चुनें. यह एपीआई, मिलते-जुलते चैनलों के बारे में अहम जानकारी दिखाता है.

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

generateCreatorInsights वाला तरीका, GenerateCreatorInsightsResponse ऑब्जेक्ट दिखाता है. इस ऑब्जेक्ट में, YouTubeCreatorInsights ऑब्जेक्ट की सूची मौजूद है. हर YouTubeCreatorInsights ऑब्जेक्ट में, क्रिएटर के बारे में यह जानकारी होती है:

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

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

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

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

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

• चैनल का नाम
• चैनल आईडी
• चैनल का यूआरएल
• चैनल का ब्यौरा
• चैनल की मेट्रिक

• चैनल के दर्शकों के एट्रिब्यूट (जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी

  ब्रेकडाउन)

• सबसे ज़्यादा देखे गए वीडियो

• चैनल प्रकार

• चैनल के कॉन्टेंट से जुड़ी भाषाएं

• काम का स्कोर (सिर्फ़ विषय के रुझान से जुड़ी खोजों के लिए)

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

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

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

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