تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استكشاف إحصاءات عن صنّاع المحتوى في YouTube والحصول عليها باستخدام ميزة "إحصاءات صنّاع المحتوى". يمكن أن يكون ذلك مفيدًا للوكالات والمعلنين الذين يريدون العثور على صنّاع محتوى مناسبين لجمهورهم المستهدف.
تتضمّن واجهة برمجة التطبيقات أربع وظائف رئيسية:
إمكانية اكتشاف صنّاع المحتوى: يمكنك العثور على أبرز صنّاع المحتوى لمجموعة معيّنة من المواضيع أو التركيبة السكانية أو شرائح الجمهور أو سمات صنّاع المحتوى.
إحصاءات العلامة التجارية الخاصة بصنّاع المحتوى: يمكنك الحصول على إحصاءات حول صنّاع المحتوى المرتبطين بعلامة تجارية معيّنة.
إحصاءات صنّاع المحتوى: يمكنك الحصول على إحصاءات حول قنوات معيّنة على YouTube، مثل عدد المشتركين وعدد المشاهدات والتركيبة السكانية للجمهور.
إحصاءات حول المؤشرات الرائجة: يمكنك الحصول على إحصاءات حول مؤشرات معيّنة استنادًا إلى شرائح جمهور أو مواضيع محدّدة.
أن يتوفّر لديك أداة تخطيط أو واجهة مستخدم ستدمج واجهة برمجة التطبيقات.
استخدِم واجهة برمجة التطبيقات لاستكشاف المحتوى وصنّاع المحتوى على YouTube بحثًا عن فرص إعلانية محتملة.
أكمِل تقييمًا مسبقًا للتأكّد من أهليتك.
استيفاء متطلبات استخدام البيانات والاستعداد للخضوع لعمليات تدقيق دورية للبيانات
توقيع اتفاقية ترخيص بيانات تفرض قانونيًا متطلبات استخدام البيانات
يجب الموافقة على بنود خدمة واجهة برمجة التطبيقات مع "إعلانات Google".
تواصَل مع ممثل عن Google للحصول على مزيد من المعلومات.
إنشاء إحصاءات لصنّاع المحتوى
لإنشاء إحصاءات لصنّاع المحتوى، أرسِل طلبًا إلى الطريقة
ContentCreatorInsightsService.GenerateCreatorInsights. تتيح هذه الطريقة إجراء 5 طلبات بحث في الثانية كحدّ أقصى، وتتلقّى ثلاثة أنواع من الإدخالات استنادًا إلى ما إذا كنت تريد تسهيل عثور المستخدمين على صنّاع المحتوى أو الحصول على إحصاءات حول العلامات التجارية الخاصة بصنّاع المحتوى أو الحصول على إحصاءات حول صنّاع المحتوى. يجب تقديم المواقع الجغرافية للبلدان التي تريد الحصول على البيانات منها.
إمكانية عثور الجمهور على صنّاع المحتوى: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس والاهتمامات. تعرض واجهة برمجة التطبيقات قائمة بصنّاع المحتوى الذين تتطابق شرائح جمهورهم مع هذه السمات. يمكنك أيضًا تقديم سمات لصنّاع المحتوى
للفلترة حسب صنّاع المحتوى الذين يتطابق محتواهم تحديدًا مع سمات صنّاع المحتوى التي أدخلتها.
إحصاءات العلامات التجارية لصنّاع المحتوى: قدِّم علامة تجارية للبحث عن أبرز صنّاع المحتوى. تعرض واجهة برمجة التطبيقات إحصاءات حول القنوات المطابقة.
إحصاءات صنّاع المحتوى: قدِّم قائمة بمعرّفات قنوات YouTube. تعرض واجهة برمجة التطبيقات إحصاءات حول هذه القنوات المحدّدة.
تعرض الطريقة generateCreatorInsights كائن GenerateCreatorInsightsResponse. يحتوي هذا العنصر على قائمة تضمّ YouTubeCreatorInsights عنصرًا. يحتوي كل عنصر
YouTubeCreatorInsights على المعلومات التالية حول صانع محتوى:
اسم صانع المحتوى
قناة على YouTube
إجمالي مقاييس صنّاع المحتوى
قائمة بإحصاءات قنوات YouTube
يحتوي الكائن YouTubeMetrics على المقاييس التالية:
عدد المشتركين
عدد مرّات المشاهدة
عدد الفيديو
أن يكون صانع فيديوهات Shorts نشطًا
يحتوي الكائن YouTubeChannelInsights على المعلومات التالية حول قناة على YouTube:
اسم القناة
معرّف القناة
عنوان URL للقناة
وصف القناة
مقاييس القناة
سمات جمهور القناة (مثل العمر والجنس وتفاصيل اهتمامات المستخدمين)
أهم الفيديوهات
نوع القناة
إنشاء إحصاءات حول المواضيع الرائجة
لإنشاء إحصاءات حول المحتوى الرائج، أرسِل طلبًا إلى طريقة
ContentCreatorInsightsService.GenerateTrendingInsights. تتضمّن هذه الطريقة حدًا أقصى يبلغ 5 طلبات بحث في الثانية، وتتلقّى نوعَين من الإدخالات استنادًا إلى ما إذا كنت تريد الحصول على مؤشرات الجمهور أو مؤشرات المواضيع.
يجب تقديم الموقع الجغرافي للبلد المحدّد الذي تريد الحصول على المؤشرات منه.
مؤشرات الجمهور: يمكنك تقديم قائمة بسمات الجمهور، مثل العمر والجنس والاهتمامات. تعرض واجهة برمجة التطبيقات قائمة بالإحصاءات الرائجة لشرائح الجمهور هذه.
مؤشرات المواضيع: تقدّم هذه السمة قائمة بمواضيع المحتوى. تعرض واجهة برمجة التطبيقات قائمة
بالإحصاءات الرائجة لهذه المواضيع.
تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-27 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eDiscover top YouTube creators based on topics, demographics, and target audiences using the creator insights feature.\u003c/p\u003e\n"],["\u003cp\u003eAccess creator insights such as subscriber count, view count, and audience demographics for specific YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is currently in beta and requires meeting specific eligibility criteria, including a pre-screen assessment and data usage agreement.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003eContentCreatorInsightsService.GenerateCreatorInsights\u003c/code\u003e method to request either creator discovery or specific channel insights.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides data like creator name, channel details, metrics (subscriber count, view count), and audience attributes.\u003c/p\u003e\n"]]],[],null,["# YouTube creator insights\n\n| **Note:** This feature is in beta and is only available to developers on an allowlist.\n\nDiscover and fetch insights about YouTube creators with the creator insights\nfeature. This can be useful for agencies and advertisers who want to find\ncreators who are relevant to their target audience.\n\nThe API has four main functions:\n\n1. **Creator Discoverability:** Find the top creators for a given set of topics, demographics, audiences, or creator attributes.\n2. **Creator Brand Insights:** Fetch insights about creators relating to a specific brand.\n3. **Creator Insights:** Fetch insights about specific YouTube channels, such as their subscriber count, view count, and audience demographics.\n4. **Trending Insights:** Fetch insights about specific trends, based on specific audiences or topics.\n\nEligibility requirements\n------------------------\n\n[`ContentCreatorInsightsService.GenerateCreatorInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateCreatorInsights)\nis a private component of the Google Ads API offered with a non-exclusive, royalty-free\ndata license. Signed partners can use the standard\n[Google Ads client libraries](/google-ads/api/docs/client-libs) to explore YouTube creators and\ncontent. To be eligible, partners must satisfy the following conditions:\n\n- Have a planning tool or user interface that will integrate the API.\n- Use the API to explore YouTube content and creators for potential advertising opportunities.\n- Complete a pre-screen assessment to ensure eligibility.\n- Follow data usage requirements and be willing to undergo periodic data audits.\n- Sign a data-licensing agreement that legally enforces data usage requirements.\n- Accept the Google Ads API [terms of service](../../terms).\n\nContact your Google representative for more information.\n\nGenerate creator insights\n-------------------------\n\nTo generate creator insights, send a request to the\n[`ContentCreatorInsightsService.GenerateCreatorInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateCreatorInsights)\nmethod. This method has a limit of 5 queries per second (QPS) and takes three\ntypes of input depending on if you want to do creator discoverability, creator\nbrand insights or get creator insights. You must provide the country locations\nwhere you want to get data from.\n\n1. **Creator Discoverability:** You can provide a list of audience attributes, such as age, gender, and interests. The API returns a list of creators whose audiences match those attributes. You can also provide creator attributes to filter for creators whose content specifically matches your inputted creator attributes.\n2. **Creator Brand Insights:** Provide a brand to search for top creators. The API returns insights about matching channels.\n3. **Creator Insights:** Provide a list of YouTube channel IDs. The API returns insights about those specific channels.\n\nThe `generateCreatorInsights` method returns a `GenerateCreatorInsightsResponse`\nobject. This object contains a list of `YouTubeCreatorInsights` objects. Each\n`YouTubeCreatorInsights` object contains the following information about a\ncreator:\n\n- Creator name\n- YouTube channel\n- Total creator metrics\n- List of YouTube channel insights\n\nThe `YouTubeMetrics` object contains the following metrics:\n\n- Subscriber count\n- View count\n- Video count\n- Is Active Shorts Creator\n\nThe `YouTubeChannelInsights` object contains the following information about a\nYouTube channel:\n\n- Channel name\n- Channel ID\n- Channel URL\n- Channel description\n- Channel metrics\n- Channel audience attributes (such as age, gender, and user interest breakdown)\n- Top Videos\n- Channel type\n\nGenerate trending insights\n--------------------------\n\nTo generate trending insights, send a request to the\n[`ContentCreatorInsightsService.GenerateTrendingInsights`](/google-ads/api/reference/rpc/v21/ContentCreatorInsightsService/GenerateTrendingInsights)\nmethod. This method has a limit of 5 queries per second (QPS) and takes two\ntypes of input depending on if you want to get audience trends or topic trends.\nYou must provide the specific country location where you want to get trends\nfrom.\n\n1. **Audience Trends:** You can provide a list of audience attributes, such as age, gender, and interests. The API returns a list of trending insights for those audiences.\n2. **Topic Trends:** Provide a list of content topics. The API returns a list of trending insights for those topics."]]
