क्रिएटर के बारे में अहम जानकारी देने वाली सुविधा की मदद से, YouTube क्रिएटर्स के बारे में अहम जानकारी पाएं और उसे फ़ेच करें. यह उन एजेंसियों और विज्ञापन देने वाले लोगों या कंपनियों के लिए काम का हो सकता है जिन्हें अपनी टारगेट ऑडियंस के हिसाब से क्रिएटर्स ढूंढने हैं.
इस एपीआई के चार मुख्य फ़ंक्शन हैं:
- क्रिएटर को खोजने की सुविधा: विषयों, डेमोग्राफ़िक, ऑडियंस या क्रिएटर की विशेषताओं के किसी दिए गए सेट के लिए, टॉप क्रिएटर्स ढूंढें.
- क्रिएटर के ब्रैंड के बारे में अहम जानकारी: किसी ब्रैंड से जुड़े क्रिएटर्स के बारे में अहम जानकारी पाएं.
- क्रिएटर के बारे में अहम जानकारी: किसी YouTube चैनल के बारे में अहम जानकारी पाएं. जैसे, उसके सदस्यों की संख्या, व्यू की संख्या, और दर्शकों के डेमोग्राफ़िक.
- ट्रेंडिंग इनसाइट: किसी खास ऑडियंस या विषय के आधार पर, किसी ट्रेंड के बारे में अहम जानकारी पाएं.
ज़रूरी शर्तें
ContentCreatorInsightsService.GenerateCreatorInsights
Google Ads API का एक निजी कॉम्पोनेंट है. इसे बिना किसी खास अधिकार और बिना रॉयल्टी के
डेटा लाइसेंस के साथ उपलब्ध कराया जाता है. साइन किए गए पार्टनर, YouTube क्रिएटर्स और कॉन्टेंट को एक्सप्लोर करने के लिए, Google Ads की स्टैंडर्ड क्लाइंट लाइब्रेरी का इस्तेमाल कर सकते हैं. ज़रूरी शर्तें पूरी करने के लिए, पार्टनर को ये शर्तें पूरी करनी होंगी:
- आपके पास कोई प्लानिंग टूल या यूज़र इंटरफ़ेस होना चाहिए, जिसमें एपीआई को इंटिग्रेट किया जा सके.
- विज्ञापन दिखाने के संभावित मौकों के लिए, YouTube कॉन्टेंट और क्रिएटर्स को एक्सप्लोर करने के लिए, API का इस्तेमाल करें.
- ज़रूरी शर्तें पूरी करने के लिए, प्री-स्क्रीन असेसमेंट पूरा करें.
- डेटा के इस्तेमाल से जुड़ी ज़रूरी शर्तों का पालन करें. साथ ही, समय-समय पर होने वाले डेटा ऑडिट के लिए तैयार रहें.
- डेटा लाइसेंसिंग के कानूनी समझौते पर हस्ताक्षर करें. इससे डेटा के इस्तेमाल से जुड़ी ज़रूरी शर्तों को कानूनी तौर पर लागू किया जा सकेगा.
- Google Ads API की सेवा की शर्तें स्वीकार करें.
ज़्यादा जानकारी के लिए, अपने Google प्रतिनिधि से संपर्क करें.
क्रिएटर के बारे में अहम जानकारी जनरेट करना
क्रिएटर के बारे में अहम जानकारी जनरेट करने के लिए, ContentCreatorInsightsService.GenerateCreatorInsights तरीके से अनुरोध भेजें. इस तरीके में, हर सेकंड में पांच क्वेरी की सीमा होती है. साथ ही, इसमें तीन तरह के इनपुट लिए जाते हैं. ये इनपुट इस बात पर निर्भर करते हैं कि आपको क्रिएटर की खोज करने की सुविधा, क्रिएटर के ब्रैंड के बारे में अहम जानकारी या क्रिएटर के बारे में अहम जानकारी चाहिए. आपको उन देशों की जगह की जानकारी देनी होगी जहां से आपको डेटा चाहिए.
- क्रिएटर को खोजने की सुविधा: ऑडियंस के एट्रिब्यूट की सूची दी जा सकती है. जैसे, उम्र, लिंग, और दिलचस्पी (इसमें अफ़िनिटी, इन-मार्केट, और लाइफ़ इवेंट ऑडियंस शामिल हैं). एपीआई, उन क्रिएटर्स की सूची दिखाता है जिनकी ऑडियंस, उन एट्रिब्यूट से मैच करती है. क्रिएटर एट्रिब्यूट भी दिए जा सकते हैं, ताकि उन क्रिएटर्स को फ़िल्टर किया जा सके जिनका कॉन्टेंट, आपके दिए गए क्रिएटर एट्रिब्यूट से मेल खाता हो.
- क्रिएटर और ब्रैंड के बारे में अहम जानकारी: टॉप क्रिएटर्स को खोजने के लिए, कोई ब्रैंड चुनें. यह एपीआई, मिलते-जुलते चैनलों के बारे में अहम जानकारी दिखाता है.
- क्रिएटर के लिए अहम जानकारी: YouTube चैनल के आईडी की सूची दें. एपीआई, उन चैनलों के बारे में अहम जानकारी दिखाता है.
generateCreatorInsights वाला तरीका, GenerateCreatorInsightsResponse ऑब्जेक्ट दिखाता है. इस ऑब्जेक्ट में, YouTubeCreatorInsights ऑब्जेक्ट की सूची मौजूद है. हर YouTubeCreatorInsights ऑब्जेक्ट में, क्रिएटर के बारे में यह जानकारी होती है:
- क्रिएटर का नाम
- YouTube चैनल
- क्रिएटर से जुड़ी कुल मेट्रिक
- YouTube चैनल की अहम जानकारी की सूची
YouTubeMetrics ऑब्जेक्ट में ये मेट्रिक शामिल होती हैं:
- सदस्यों की संख्या
- व्यू की संख्या
- वीडियो की संख्या
- Is Active Shorts Creator
- पार्टनरशिप के अवसर (v23_2 से शुरू)
YouTubeChannelInsights ऑब्जेक्ट में, किसी YouTube चैनल के बारे में यह जानकारी शामिल होती है:
- चैनल का नाम
- चैनल आईडी
- चैनल का यूआरएल
- चैनल का ब्यौरा
- चैनल की मेट्रिक
- चैनल की ऑडियंस के एट्रिब्यूट (जैसे, उम्र, लिंग, और उपयोगकर्ता की दिलचस्पी के हिसाब से जानकारी)
- प्रमुख वीडियो
- चैनल प्रकार
- चैनल के कॉन्टेंट से जुड़ी भाषाएँ
- काम का स्कोर (सिर्फ़ विषय के रुझान से जुड़ी खोजों के लिए)
ट्रेंडिंग इनसाइट जनरेट करना
ट्रेंडिंग इनसाइट जनरेट करने के लिए, ContentCreatorInsightsService.GenerateTrendingInsights तरीके का इस्तेमाल करके अनुरोध भेजें. इस तरीके में, हर सेकंड में पांच क्वेरी (क्यूपीएस) की सीमा होती है. साथ ही, इसमें दो तरह के इनपुट लिए जाते हैं. यह इस बात पर निर्भर करता है कि आपको ऑडियंस के रुझान या विषय के रुझान के बारे में जानकारी चाहिए.
आपको उस देश की जगह की जानकारी देनी होगी जहां के रुझान आपको चाहिए.
- ऑडियंस के रुझान: ऑडियंस के एट्रिब्यूट की सूची दी जा सकती है. जैसे, उम्र, लिंग, और दिलचस्पी (इसमें अफ़िनिटी ऑडियंस (एक जैसी पसंद वाले दर्शक), इन-मार्केट ऑडियंस, और ऐसी ऑडियंस शामिल है जो अपनी ज़िंदगी के किसी खास पड़ाव का जश्न मना रही हो). एपीआई, उन ऑडियंस के लिए रुझान वाली अहम जानकारी की सूची दिखाता है. इसमें तुलना की अवधि के दौरान, रुझान की वैल्यू में हुए बदलाव के प्रतिशत जैसी मेट्रिक शामिल होती हैं.
- विषय से जुड़े रुझान: कॉन्टेंट के विषयों की सूची दें. एपीआई, उन विषयों के लिए ट्रेंडिंग इनसाइट की सूची दिखाता है. इसमें ऐसी मेट्रिक शामिल होती हैं जैसे कि तुलना की अवधि के दौरान, ट्रेंड की वैल्यू में हुए बदलाव का प्रतिशत.