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