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

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

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

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

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

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

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

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

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

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

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

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

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

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

   Google Ads API के वर्शन 23 से, 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 तरीके का इस्तेमाल करें.

   ध्यान दें: वर्शन 24.2 से, search_brand विकल्प का इस्तेमाल बंद कर दिया गया है. इसे वर्शन 25 में पूरी तरह से हटा दिया गया है. उपयोगकर्ताओं को इसके बजाय, search_topics का इस्तेमाल करना चाहिए.

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

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

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

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

स्थानीय क्रिएटर डिस्कवरी के लिए, इन खास बातों का ध्यान रखें:

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

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

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

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

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

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

• सदस्यों की संख्या
• व्यू की संख्या
• वीडियो की संख्या
• शॉर्ट वीडियो बनाने वाला सक्रिय क्रिएटर है या नहीं
• पार्टनरशिप के अवसर (वर्शन 23 से)

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

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

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

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

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

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

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

   KNOWLEDGE_GRAPH एट्रिब्यूट में, एक या उससे ज़्यादा InsightsKnowledgeGraphEntityCapabilities टैग होंगे. ट्रेंडिंग के बारे में अहम जानकारी के लिए उपलब्ध एट्रिब्यूट के जवाब के मेटाडेटा में, काम के टैग शामिल होंगे.

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

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

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

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

   Google Ads API के वर्शन 23 से, 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 का इस्तेमाल किया जा सकता है.

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

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

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

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