با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
با ویژگی اطلاعات بینش سازندگان، اطلاعات آماری درباره سازندگان YouTube را کشف و واکشی کنید. این می تواند برای آژانس ها و تبلیغ کنندگانی که می خواهند سازندگان مرتبط با مخاطبان هدف خود را پیدا کنند مفید باشد.
API چهار عملکرد اصلی دارد:
قابلیت کشف سازندگان: برترین سازندگان را برای مجموعه‌ای از موضوعات، جمعیت‌شناسی، مخاطبان یا ویژگی‌های سازنده پیدا کنید.
اطلاعات بینش برند سازنده: بینش‌هایی درباره سازندگان مرتبط با یک برند خاص واکشی کنید.
اطلاعات بینش سازندگان: اطلاعات آماری درباره کانال‌های YouTube خاص، مانند تعداد مشترکان، تعداد بازدیدها، و جمعیت شناسی مخاطبان را واکشی کنید.
بینش های پرطرفدار: بینش هایی را در مورد روندهای خاص، بر اساس مخاطبان یا موضوعات خاص واکشی کنید.
برای اطلاعات بیشتر با نماینده Google خود تماس بگیرید.
بینش سازنده ایجاد کنید
برای ایجاد بینش سازنده، درخواستی را به روش ContentCreatorInsightsService.GenerateCreatorInsights ارسال کنید. این روش دارای محدودیت 5 پرس و جو در ثانیه (QPS) است و بسته به اینکه می‌خواهید قابلیت کشف سازندگان، بینش برند سازنده یا دریافت بینش سازنده را انجام دهید، سه نوع ورودی دریافت می‌کند. باید مکان‌های کشوری را که می‌خواهید داده‌ها را از آنجا دریافت کنید، ارائه کنید.
قابلیت کشف سازندگان: می‌توانید فهرستی از ویژگی‌های مخاطب، مانند سن، جنسیت، و علایق ارائه دهید. API فهرستی از سازندگانی را که مخاطبانشان با این ویژگی ها مطابقت دارند، برمی گرداند. همچنین می‌توانید ویژگی‌های ایجادکننده را برای فیلتر برای سازندگانی که محتوایشان به طور خاص با ویژگی‌های ایجادکننده ورودی شما مطابقت دارد، ارائه دهید.
اطلاعات بینش برند سازنده: یک نام تجاری برای جستجوی سازندگان برتر ارائه دهید. API اطلاعاتی درباره کانال‌های منطبق برمی‌گرداند.
Creator Insights: فهرستی از شناسه‌های کانال YouTube ارائه دهید. API بینش هایی را در مورد آن کانال های خاص برمی گرداند.
متد generateCreatorInsights یک شی GenerateCreatorInsightsResponse را برمی گرداند. این شی حاوی لیستی از اشیاء YouTubeCreatorInsights است. هر شی YouTubeCreatorInsights حاوی اطلاعات زیر در مورد یک سازنده است:
نام سازنده
کانال یوتیوب
کل معیارهای سازنده
لیست اطلاعات بینش کانال یوتیوب
شی YouTubeMetrics شامل معیارهای زیر است:
تعداد مشترکین
تعداد مشاهده
تعداد ویدیوها
خالق شورت فعال است
شی YouTubeChannelInsights حاوی اطلاعات زیر در مورد یک کانال YouTube است:
نام کانال
آیدی کانال
آدرس کانال
توضیحات کانال
معیارهای کانال
ویژگی‌های مخاطب کانال (مانند سن، جنسیت و تفکیک علاقه کاربر)
ویدیوهای برتر
نوع کانال
بینش های پرطرفدار ایجاد کنید
برای ایجاد بینش های پرطرفدار، یک درخواست به روش ContentCreatorInsightsService.GenerateTrendingInsights ارسال کنید. این روش دارای محدودیت 5 پرس و جو در ثانیه (QPS) است و بسته به اینکه می خواهید گرایش های مخاطب یا گرایش های موضوع را دریافت کنید، دو نوع ورودی دریافت می کند. شما باید مکان کشور خاصی را که می خواهید از آن ترندها دریافت کنید، ارائه دهید.
گرایش های مخاطب: می توانید فهرستی از ویژگی های مخاطب مانند سن، جنسیت و علایق ارائه دهید. API فهرستی از بینش‌های پرطرفدار را برای آن مخاطبان برمی‌گرداند.
گرایش های موضوع: فهرستی از موضوعات محتوا را ارائه دهید. API فهرستی از بینش‌های پرطرفدار را برای آن موضوعات برمی‌گرداند.
تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[[["\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."]]
