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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. क्रिएटर की अहम जानकारी (search_channels): search_channels फ़ील्ड का इस्तेमाल करके, YouTube चैनल आईडी, YouTube चैनल के हैंडल (youtube_channel_handles, v25 और इसके बाद के वर्शन में उपलब्ध है) या दोनों की सूची दें. एपीआई, उन चैनलों के बारे में अहम जानकारी दिखाता है.

ऑडियंस के जटिल कॉम्बिनेशन

GenerateCreatorInsights और GenerateTrendingInsights, दोनों में audience_combinations का इस्तेमाल करके, ऑडियंस के एट्रिब्यूट के बीच के जटिल संबंधों को तय किया जा सकता है. इस फ़ील्ड की मदद से, ऑडियंस एट्रिब्यूट को बूलियन लॉजिक (AND और OR) के साथ जोड़ा जा सकता है. यह audience_attributes के फ़्लैट यूनियन (OR) व्यवहार से अलग है:

  • audience_combinations में मौजूद हर InsightsAudienceAttributeGroup, अपने एट्रिब्यूट को लॉजिकल OR के साथ जोड़ता है.
  • audience_combinations में मौजूद कई InsightsAudienceAttributeGroup आइटम को लॉजिकल AND के साथ जोड़ा जाता है.

उदाहरण के लिए, ("Skin care" OR "Hair care") AND "Cosmetics" में दिलचस्पी रखने वाली ऑडियंस को टारगेट करने के लिए, audience_combinations में दो InsightsAudienceAttributeGroup आइटम शामिल करें:

  1. ग्रुप 1 में "Skin care" और "Hair care" के लिए, नॉलेज ग्राफ़ की इकाई के एट्रिब्यूट शामिल हैं.
  2. ग्रुप 2 में "Cosmetics" के लिए नॉलेज ग्राफ़ इकाई एट्रिब्यूट शामिल है (जैसे कि /m/014trl).

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

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

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

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

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

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

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

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

  • creator_name: यह इमेज बनाने वाले का नाम बताता है.
  • creator_channels: YouTubeChannelInsights ऑब्जेक्ट की सूची. चैनल की जानकारी और channel_metrics (YouTubeMetrics), creator_channels में मौजूद हर YouTubeChannelInsights ऑब्जेक्ट में दिखते हैं.

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

  • सदस्यों, व्यू, और वीडियो की संख्या
  • चैनल के सभी वीडियो पर मिले कुल लाइक, शेयर, और टिप्पणियों की संख्या
  • लाइफ़टाइम यूज़र ऐक्टिविटी रेट (कुल यूज़र ऐक्टिविटी को कुल व्यू से भाग देने पर मिलने वाली संख्या)
  • पिछले 28 दिनों में, हर वीडियो पर मिले व्यू, पसंद, शेयर, और टिप्पणियों की औसत संख्या
  • शॉर्ट वीडियो को मिले व्यू और वीडियो की संख्या
  • क्रिएटर, Shorts क्रिएटर या लाइव स्ट्रीम करने वाला क्रिएटर के तौर पर ऐक्टिव हो. इसके लिए, ज़रूरी है कि उसने पिछले 90 दिनों में कम से कम एक शॉर्ट वीडियो या लाइव स्ट्रीम पब्लिश की हो
  • पार्टनरशिप के अवसर

यूज़र ऐक्टिविटी की दर और हर वीडियो पर मिले व्यू, पसंद, और टिप्पणियों की औसत संख्या, सार्वजनिक तौर पर नहीं दिखाई जाने वाली मेट्रिक हैं. ये मेट्रिक सिर्फ़ तब दिखती हैं, जब क्रिएटर ने इन्हें शेयर करने की सहमति दी हो.

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

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

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

GenerateCreatorInsights अनुरोध और जवाब का रेफ़रंस

नीचे दिए गए एंडपॉइंट पर, ContentCreatorInsightsService को GenerateCreatorInsights कॉल करें:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights

यहां दी गई टेबल में, GenerateCreatorInsightsRequest पर मौजूद फ़ील्ड की खास जानकारी दी गई है:

फ़ील्ड पाथ आवश्यकता फ़ॉर्मैट और पाबंदियां
customer_id ज़रूरी है बिना हाइफ़न वाला 10 अंकों का ग्राहक आईडी (string).
customer_insights_group ज़रूरी है ग्राहक या ब्रैंड का उपयोगकर्ता के तय किया गया नाम (string), जिसके लिए प्लान बनाया जा रहा है.
country_locations[] ज़रूरी है देश LocationInfo ऑब्जेक्ट की सूची (geo_target_constant, जैसे कि "geoTargetConstants/2840"). search_topics का इस्तेमाल करने पर, इसमें सिर्फ़ एक देश शामिल होना चाहिए.
sub_country_locations[] वैकल्पिक देश के अंदर के इलाके LocationInfo के फ़िल्टर; सिर्फ़ search_attributes के साथ काम करते हैं और LOCAL_CREATOR_DATA के साथ काम नहीं करते.
search_attributes criteria (oneof) SearchAttributes में ये शामिल हैं:
• audience_attributes[]: age_range, gender, device, parental_status, income_range (audience_combinations का इस्तेमाल न होने पर, user_interest, entity या category भी).
• audience_combinations[]: AND-of-ORs InsightsAudienceAttributeGroup आइटम.
• creator_attributes[]: नॉलेज ग्राफ़ में entity आइटम मौजूद हैं. इनमें CREATOR_ATTRIBUTE की सुविधा है.
search_topics criteria (oneof) SearchTopics, जिसमें entities[] (AudienceInsightsEntity, जिसमें knowledge_graph_machine_id को CREATOR_TOPIC_INSIGHTS या CONTENT_TRENDING_INSIGHTS के साथ टैग किया गया है) शामिल है.
search_channels criteria (oneof) YouTubeChannels, जिसमें youtube_channels[] (channel_id) और/या youtube_channel_handles[] (@ से शुरू होने वाले हैंडल, जैसे कि "@youtubecreators") शामिल हों.
supplemental_data[] वैकल्पिक ContentCreatorInsightsSupplementalData वैल्यू. local_creator_insights[] को पॉप्युलेट करने के लिए, किसी एक देश के search_topics अनुरोध (CREATOR_TOPIC_INSIGHTS वाली इकाइयों के लिए) पर LOCAL_CREATOR_DATA सेट करें.
insights_application_info वैकल्पिक अनुरोध करने वाले ऐप्लिकेशन के बारे में AdditionalApplicationInfo मेटाडेटा.

GenerateCreatorInsightsResponse मैसेज से, ये फ़ील्ड मिलते हैं:

जानकारी का फ़ील्ड टाइप ब्यौरा
creator_insights[] YouTubeCreatorInsights आपकी मुख्य शर्तों (creator_name और creator_channels[]) से मैच करने वाले क्रिएटर्स.
local_creator_insights[] YouTubeCreatorInsights ऐसे स्थानीय क्रिएटर्स जिन्होंने जगह की जानकारी का डेटा शेयर करने की सहमति दी है. यह डेटा तब भरा जाता है, जब CREATOR_TOPIC_INSIGHTS वाली किसी इकाई पर search_topics के साथ LOCAL_CREATOR_DATA का अनुरोध किया जाता है.
creator_channels[] YouTubeChannelInsights मेटाडेटा: display_name, youtube_channel.channel_id, handle, channel_url, publish_date, country_location, और data_sharing_consent_given.
अहम जानकारी और कॉन्टेंट: channel_audience_attributes[] (सहमति मिलने पर ही उपलब्ध), channel_attributes[], top_videos[], language_distributions[], relevance_score (सिर्फ़ GenerateTrendingInsights के लिए उपलब्ध, जिसमें search_topics शामिल है), और channel_metrics.
channel_metrics YouTubeMetrics सार्वजनिक मेट्रिक: subscriber_count, views_count, video_count, likes_count, shares_count, comments_count, shorts_views_count, shorts_video_count, is_active_shorts_creator, is_active_live_stream_creator, और partnership_opportunities[].
सहमति मिलने के बाद दिखने वाली मेट्रिक: engagement_rate और हर वीडियो के लिए 28 दिनों का औसत (average_views_per_video, average_likes_per_video, average_shares_per_video, average_comments_per_video).

GenerateCreatorInsights REST अनुरोध और रिस्पॉन्स के उदाहरण

यहां दिए गए उदाहरण में, searchAttributes का इस्तेमाल करके क्रिएटर्स को खोजने का तरीका बताया गया है. इसके लिए, डेमोग्राफ़िक audienceAttributes, बूलियन audienceCombinations ("Skin care" OR "Hair care", AND "Cosmetics"), और creatorAttributes का इस्तेमाल किया गया है:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchAttributes": {
    "audienceAttributes": [
      {
        "ageRange": {
          "type": "AGE_RANGE_25_34"
        }
      },
      {
        "gender": {
          "type": "FEMALE"
        }
      }
    ],
    "audienceCombinations": [
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/015c4z"
            }
          },
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/018bb_"
            }
          }
        ]
      },
      {
        "attributes": [
          {
            "entity": {
              "knowledgeGraphMachineId": "/m/014trl"
            }
          }
        ]
      }
    ],
    "creatorAttributes": [
      {
        "entity": {
          "knowledgeGraphMachineId": "/m/014trl"
        }
      }
    ]
  }
}

स्थानीय क्रिएटर्स के साथ-साथ, विषय के आधार पर क्रिएटर्स को फ़िल्टर करने के लिए, searchTopics का इस्तेमाल करें. साथ ही, supplementalData में "LOCAL_CREATOR_DATA" को शामिल करें:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "supplementalData": [
    "LOCAL_CREATOR_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/m/014trl"
      }
    ]
  }
}

चैनल आईडी या हैंडल के हिसाब से, YouTube के किसी चैनल की अहम जानकारी पाने के लिए, searchChannels का इस्तेमाल करें:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateCreatorInsights
{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocations": [
    {
      "geoTargetConstant": "geoTargetConstants/2840"
    }
  ],
  "searchChannels": {
    "youtubeChannels": [
      {
        "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
      }
    ],
    "youtubeChannelHandles": [
      "@exampleskincare"
    ]
  }
}

GenerateCreatorInsightsResponse के सफल होने पर, creatorInsights[] दिखता है. साथ ही, LOCAL_CREATOR_DATA का अनुरोध करने पर localCreatorInsights[] दिखता है:

{
  "creatorInsights": [
    {
      "creatorName": "Example Skincare Creator",
      "creatorChannels": [
        {
          "displayName": "Example Skincare Channel",
          "youtubeChannel": {
            "channelId": "UCxxxxxxxxxxxxxxxxxxxxxx"
          },
          "channelUrl": "https://www.youtube.com/channel/UCxxxxxxxxxxxxxxxxxxxxxx",
          "handle": "@exampleskincare",
          "publishDate": "2020-03-15",
          "countryLocation": {
            "geoTargetConstant": "geoTargetConstants/2840"
          },
          "dataSharingConsentGiven": true,
          "channelMetrics": {
            "subscriberCount": "450000",
            "viewsCount": "38200000",
            "videoCount": "210",
            "likesCount": "1950000",
            "commentsCount": "84000",
            "engagementRate": 0.056,
            "averageViewsPerVideo": 62000.0,
            "shortsViewsCount": "14500000",
            "shortsVideoCount": "95",
            "isActiveShortsCreator": true,
            "isActiveLiveStreamCreator": false,
            "partnershipOpportunities": [
              "CREATOR_PARTNERSHIPS",
              "PARTNERSHIP_ADS"
            ]
          }
        }
      ]
    }
  ],
  "localCreatorInsights": []
}

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

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

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

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

    ListAudienceInsightsAttributes से मिले KNOWLEDGE_GRAPH एट्रिब्यूट में, एक या उससे ज़्यादा InsightsKnowledgeGraphEntityCapabilities टैग शामिल होते हैं. CONTENT_TRENDING_INSIGHTS टैग वाली इकाइयों को GenerateTrendingInsights में विषयों के तौर पर इस्तेमाल किया जा सकता है.

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

  • स्थानीय क्रिएटर्स (LOCAL_CREATOR_DATA): जब ट्रेंडिंग अनुरोध में search_topics का इस्तेमाल किया जाता है (और विषय, नॉलेज ग्राफ़ की ऐसी इकाई होता है जिसे CREATOR_TOPIC_INSIGHTS क्षमता के साथ टैग किया गया है), तो supplemental_data को LOCAL_CREATOR_DATA पर सेट करने से, दिखाए गए TrendInsight ऑब्जेक्ट पर related_local_creators फ़ील्ड में, उन स्थानीय क्रिएटर्स की जानकारी अपने-आप भर जाती है जिन्होंने अपनी जगह की जानकारी का डेटा शेयर करने की सहमति दी है. स्थानीय क्रिएटर डिस्कवरी की सुविधा, sub_country_locations के साथ काम नहीं करती.
  • ब्रैंड के बारे में लोगों की राय (BRAND_SENTIMENT_DATA): जब ट्रेंडिंग के लिए किए गए आपके अनुरोध में search_topics का इस्तेमाल किया जाता है और अनुरोध किए गए नॉलेज ग्राफ़ की इकाई के विषय में BRAND की सुविधा होती है, तो supplemental_data को BRAND_SENTIMENT_DATA पर सेट करने से, दिखाए गए TrendInsight ऑब्जेक्ट पर brand_sentiment_insights फ़ील्ड अपने-आप भर जाता है.

ब्रैंड के लिए लोगों के रुझान का आकलन करने के लिए, Gemini के एआई मॉडल का इस्तेमाल करके, ब्रैंड से जुड़े YouTube वीडियो कॉन्टेंट का विश्लेषण किया जाता है. इसके बाद, रुझान को अच्छा, खराब या सामान्य के तौर पर कैटगरी में बांटा जाता है. सिर्फ़ वीडियो वाले कॉन्टेंट का विश्लेषण किया जाता है. इसमें उपयोगकर्ताओं की टिप्पणियां शामिल नहीं होती हैं.

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

  • trend_attribute: ट्रेंड के लिए मुख्य AudienceInsightsAttributeMetadata.
  • trend_metrics: रुझान के लिए मेट्रिक, जैसे कि तुलना की अवधि के दौरान प्रतिशत में बदलाव.
  • trend: InsightsTrend वैल्यू (EMERGING, RISING, SUSTAINED या DECLINING), जो ट्रेंड की दिशा दिखाती है. बदलाव का साइज़ देखने के लिए, trend_metrics.trend_change_percent देखें.
  • trend_data_points: रुझान के लिए पुराने डेटा पॉइंट. सिर्फ़ search_topics का इस्तेमाल करने वाले रुझानों के लिए जानकारी अपने-आप भर जाती है.
  • related_videos: ट्रेंडिंग वीडियो के लिए, AudienceInsightsAttributeMetadata ऑब्जेक्ट की सूची. ये वीडियो, ट्रेंड के विषय से जुड़े होते हैं. यह सूची सिर्फ़ search_topics का इस्तेमाल करने वाले ट्रेंड के लिए भरी जाती है. इन एट्रिब्यूट के लिए, नेस्ट किए गए YouTubeVideoAttributeMetadata को वीडियो-लेवल के मेटाडेटा (यूआरएल, थंबनेल का यूआरएल, व्यू और पसंद की संख्या) और चैनल-लेवल के मेटाडेटा (चैनल आईडी, नाम, और यूआरएल) से भरा जाता है.
  • related_creators: ट्रेंड के विषय से जुड़े क्रिएटर्स के लिए, YouTubeCreatorInsights ऑब्जेक्ट की सूची. यह सूची सिर्फ़ search_topics का इस्तेमाल करने वाले ट्रेंड के लिए भरी जाती है.
  • related_local_creators: ट्रेंड के विषय से जुड़े स्थानीय क्रिएटर्स के YouTubeCreatorInsights ऑब्जेक्ट की सूची. इसमें वे क्रिएटर्स शामिल हैं जिन्होंने अपनी जगह की जानकारी का डेटा शेयर करने की सहमति दी है. यह जानकारी सिर्फ़ तब भरी जाती है, जब LOCAL_CREATOR_DATA का अनुरोध किया जाता है (पूरक डेटा, स्थानीय क्रिएटर्स, और ब्रैंड के बारे में लोगों की राय देखें).
  • brand_sentiment_insights: रुझान के लिए BrandSentimentInsight ऑब्जेक्ट की सूची. यह सूची तब भरी जाती है, जब अनुरोध में किसी ऐसी इकाई के लिए search_topics का इस्तेमाल किया जाता है जिसमें BRAND की सुविधा हो और BRAND_SENTIMENT_DATA का अनुरोध किया गया हो. हर BrandSentimentInsight ऑब्जेक्ट में यह जानकारी शामिल होती है:
    • month: वह महीना जिसके लिए ब्रैंड के बारे में लोगों की राय को YYYY-MM फ़ॉर्मैट में दिखाया गया है.
    • has_insufficient_data: ब्रैंड के लिए लोगों के रुझान का हिसाब लगाने के लिए, ज़रूरत के मुताबिक डेटा मौजूद है या नहीं.
    • sentiment_distributions: सकारात्मक, नकारात्मक, और सामान्य रुझान के बीच का बंटवारा. इसका हिसाब, ब्रैंड से जुड़े वीडियो को मिले व्यू के अनुपात के आधार पर लगाया जाता है. इसमें हर रुझान को ध्यान में रखा जाता है.
    • sentiment_summaries: ब्रैंड से जुड़े कॉन्टेंट में मौजूद पॉज़िटिव और नेगेटिव थीम की एआई से जनरेट की गई खास जानकारी. साथ ही, हर तरह की भावना के लिए सैंपल वीडियो. खास जानकारी सिर्फ़ अच्छे और खराब रुझान के लिए जनरेट की जाती है, सामान्य रुझान के लिए नहीं.

नीचे दिए गए एंडपॉइंट पर, ContentCreatorInsightsService को GenerateTrendingInsights कॉल करें:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights

यहां दी गई टेबल में, GenerateTrendingInsightsRequest पर मौजूद फ़ील्ड की खास जानकारी दी गई है:

फ़ील्ड पाथ आवश्यकता फ़ॉर्मैट और पाबंदियां
customer_id ज़रूरी है बिना हाइफ़न वाला 10 अंकों का ग्राहक आईडी (string).
customer_insights_group ज़रूरी है ग्राहक या ब्रैंड का उपयोगकर्ता के तय किया गया नाम (string), जिसके लिए प्लान बनाया जा रहा है.
country_location ज़रूरी है एक देश LocationInfo (geo_target_constant, जैसे कि "geoTargetConstants/2840").
sub_country_locations[] वैकल्पिक देश के अंदर के इलाके के लिए LocationInfo फ़िल्टर; सिर्फ़ search_audience के लिए काम करते हैं और LOCAL_CREATOR_DATA के साथ काम नहीं करते.
search_audience criteria (oneof) SearchAudience में ये शामिल होने चाहिए:
• audience_attributes[] (ज़रूरी है): age_range, gender, parental_status, income_range (audience_combinations का इस्तेमाल न होने पर, user_interest, entity या category भी).
• audience_combinations[] (ज़रूरी नहीं): AND-of-ORs एट्रिब्यूट ग्रुप.
search_topics criteria (oneof) SearchTopics, जिसमें entities[] शामिल है (AudienceInsightsEntity, जिसमें knowledge_graph_machine_id को CONTENT_TRENDING_INSIGHTS के साथ टैग किया गया है).
supplemental_data[] वैकल्पिक ContentCreatorInsightsSupplementalData वैल्यू:
• LOCAL_CREATOR_DATA: CREATOR_TOPIC_INSIGHTS के साथ search_topics इकाइयों के लिए related_local_creators[] को पॉप्युलेट करता है.
• BRAND_SENTIMENT_DATA: BRAND के साथ search_topics इकाइयों के लिए brand_sentiment_insights[] को पॉप्युलेट करता है.
insights_application_info वैकल्पिक अनुरोध करने वाले ऐप्लिकेशन के बारे में AdditionalApplicationInfo मेटाडेटा.

GenerateTrendingInsightsResponse मैसेज, trend_insights[] में TrendInsight एंट्री दिखाता है:

TrendInsight फ़ील्ड टाइप ब्यौरा
trend_attribute AudienceInsightsAttributeMetadata ट्रेंड के लिए मुख्य एट्रिब्यूट (dimension, display_name, attribute).
trend_metrics TrendInsightMetrics तुलना के लिए चुनी गई तीन महीने की अवधि (views_count और views_indexed_value, search_topics के लिए; audience_share, search_audience के लिए; trend_change_percent) के दौरान मेट्रिक.
trend InsightsTrend रुझान की दिशा (EMERGING, RISING, SUSTAINED या DECLINING).
trend_data_points[] TrendInsightDataPoint हर महीने का पुराना डेटा (YYYY-MM फ़ॉर्मैट में month और trend_metrics); search_topics के लिए भरा गया.
related_videos[] AudienceInsightsAttributeMetadata YouTubeVideoAttributeMetadata वाले ट्रेंडिंग वीडियो; search_topics के लिए पॉप्युलेट किए गए.
related_creators[] YouTubeCreatorInsights विषय से जुड़े क्रिएटर्स; search_topics के लिए जानकारी भरी गई.
related_local_creators[] YouTubeCreatorInsights सहमति देने वाले स्थानीय क्रिएटर्स; search_topics के लिए पॉप्युलेट किया गया, जब CREATOR_TOPIC_INSIGHTS वाली इकाई पर LOCAL_CREATOR_DATA का अनुरोध किया जाता है.
brand_sentiment_insights[] BrandSentimentInsight ब्रैंड के बारे में हर महीने की भावना (month, has_insufficient_data, sentiment_distributions[], sentiment_summaries[]); search_topics के लिए पॉप्युलेट किया जाता है, जब BRAND क्षमता वाली इकाई पर BRAND_SENTIMENT_DATA का अनुरोध किया जाता है.

यहां दिए गए उदाहरण में, नॉलेज ग्राफ़ ब्रैंड इकाई (/g/11example_brand, जिसे CONTENT_TRENDING_INSIGHTS, CREATOR_TOPIC_INSIGHTS, और BRAND के साथ टैग किया गया है) के लिए, searchTopics का इस्तेमाल करके GenerateTrendingInsights को कॉल किया गया है. साथ ही, LOCAL_CREATOR_DATA और BRAND_SENTIMENT_DATA, दोनों का अनुरोध किया गया है:

POST https://googleads.googleapis.com/v26/customers/{customer_id}:generateTrendingInsights
{
  "customerInsightsGroup": "Spring Skincare Campaign",
  "countryLocation": {
    "geoTargetConstant": "geoTargetConstants/2840"
  },
  "supplementalData": [
    "LOCAL_CREATOR_DATA",
    "BRAND_SENTIMENT_DATA"
  ],
  "searchTopics": {
    "entities": [
      {
        "knowledgeGraphMachineId": "/g/11example_brand"
      }
    ]
  }
}

GenerateTrendingInsightsResponse के सही तरीके से काम करने पर, trendInsights[] में TrendInsight एंट्री दिखती हैं:

{
  "trendInsights": [
    {
      "trendAttribute": {
        "dimension": "KNOWLEDGE_GRAPH",
        "displayName": "Example Skincare Brand",
        "attribute": {
          "entity": {
            "knowledgeGraphMachineId": "/g/11example_brand"
          }
        }
      },
      "trendMetrics": {
        "viewsCount": "18500000",
        "viewsIndexedValue": "82",
        "trendChangePercent": 0.24
      },
      "trend": "RISING",
      "trendDataPoints": [
        {
          "month": "2026-05",
          "trendMetrics": {
            "viewsCount": "18500000",
            "viewsIndexedValue": "82",
            "trendChangePercent": 0.08
          }
        }
      ],
      "brandSentimentInsights": [
        {
          "month": "2026-05",
          "hasInsufficientData": false,
          "sentimentDistributions": [
            {
              "sentiment": "SENTIMENT_POSITIVE",
              "sentimentShare": 0.68
            },
            {
              "sentiment": "SENTIMENT_NEUTRAL",
              "sentimentShare": 0.25
            },
            {
              "sentiment": "SENTIMENT_NEGATIVE",
              "sentimentShare": 0.07
            }
          ]
        }
      ],
      "relatedVideos": [],
      "relatedCreators": [],
      "relatedLocalCreators": []
    }
  ]
}

Google Issue Tracker

Google Issue Tracker का इस्तेमाल करके, सहायता से जुड़े सवाल पूछें, गड़बड़ियों की शिकायत करें या सुविधाओं के लिए अनुरोध सबमिट करें. Google, आपके अनुरोधों को ट्रैक करता है, उन्हें प्राथमिकता देता है, और उनसे जुड़े अपडेट सीधे Issue Tracker में पोस्ट करता है. ज़्यादा जानकारी के लिए, Google Issue Tracker में कोई समस्या दर्ज करना लेख पढ़ें.

Issue Tracker के इनमें से किसी एक टेंप्लेट का इस्तेमाल करके, समस्या की जानकारी दें:

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