ما در حال به‌روزرسانی Data API هستیم تا با نحوه شمارش بازدیدهای YouTube برای Shorts مطابقت داشته باشد.
بیشتر بدانید
GuideCategories
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
توجه: این یک اعلامیه منسوخ شدن است.
منبع guideCategories و روش guideCategories.list هر دو از 9 سپتامبر 2020 منسوخ شده اند.
منبع guideCategory دسته‌ای را مشخص می‌کند که YouTube به‌طور الگوریتمی بر اساس محتوای کانال یا شاخص‌های دیگر، مانند محبوبیت کانال، به آن اختصاص می‌دهد. این فهرست مشابه دسته‌های ویدیو است، با این تفاوت که آپلودکننده ویدیو می‌تواند یک دسته ویدیو را اختصاص دهد اما فقط YouTube می‌تواند یک دسته کانال را اختصاص دهد.
روش ها
API از روش های زیر برای منابع guideCategories پشتیبانی می کند:
- list
- فهرستی از دسته‌هایی را که می‌توان با کانال‌های YouTube مرتبط کرد، برمی‌گرداند. اکنون آن را امتحان کنید .
نمایندگی منابع
ساختار JSON زیر فرمت یک منبع guideCategories را نشان می دهد:
{
"kind": "youtube#guideCategory",
"etag": etag,
"id": string,
"snippet": {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"title": string
}
} خواص
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
| خواص |
|---|
kind | string
نوع منبع API را مشخص می کند. مقدار youtube#guideCategory خواهد بود. |
etag | etag
Etag این منبع |
id | string
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد دسته راهنما استفاده می‌کند. |
snippet | object
شی snippet حاوی جزئیات اساسی در مورد دسته است، مانند عنوان آن. |
snippet. channelId | string
شناسه‌ای که YouTube برای شناسایی منحصربه‌فرد کانال منتشرکننده دسته راهنما استفاده می‌کند. |
snippet. title | string
عنوان دسته |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe \u003ccode\u003eguideCategories\u003c/code\u003e resource and \u003ccode\u003eguideCategories.list\u003c/code\u003e method were deprecated on September 9, 2020.\u003c/p\u003e\n"],["\u003cp\u003eA guide category is a classification assigned by YouTube to a channel based on its content or other indicators.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eguideCategories.list\u003c/code\u003e method provided a list of categories applicable to YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eguideCategory\u003c/code\u003e resource contains an ID, a snippet with basic details like a title, and other metadata such as the category's etag.\u003c/p\u003e\n"],["\u003cp\u003eUnlike video categories that are assigned by uploaders, channel categories are exclusively assigned by YouTube.\u003c/p\u003e\n"]]],["The `guideCategories` resource and its `list` method were deprecated on September 9, 2020. A `guideCategory` represents a YouTube-assigned category for a channel. The `list` method previously returned categories associated with YouTube channels. The resource's JSON structure included `kind`, `etag`, `id`, and a `snippet` object with `channelId` and `title` properties. Only YouTube could assign these categories, unlike video categories, which could be assigned by the uploader.\n"],null,["# GuideCategories\n\n**Note:** This is a deprecation announcement. \n\nThe `guideCategories` resource and the `guideCategories.list` method have both been deprecated as of September 9, 2020.\nA **guideCategory** resource identifies a category that YouTube algorithmically assigns based on a channel's content or other indicators, such as the channel's popularity. The list is similar to [video categories](/youtube/v3/docs/videoCategories), with the difference being that a video's uploader can assign a video category but only YouTube can assign a channel category.\n\nMethods\n-------\n\nThe API supports the following methods for `guideCategories` resources:\n\n[list](/youtube/v3/docs/guideCategories/list)\n: Returns a list of categories that can be associated with YouTube channels.\n [Try it now](/youtube/v3/docs/guideCategories/list#try-it).\n\nResource representation\n-----------------------\n\nThe JSON structure below shows the format of a `guideCategories` resource: \n\n```text\n{\n \"kind\": \"youtube#guideCategory\",\n \"etag\": etag,\n \"id\": string,\n \"snippet\": {\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"title\": string\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|---------------------|---------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the API resource's type. The value will be `youtube#guideCategory`. |\n| `etag` | `etag` The Etag of this resource. |\n| `id` | `string` The ID that YouTube uses to uniquely identify the guide category. |\n| `snippet` | `object` The `snippet` object contains basic details about the category, such as its title. |\n| snippet.`channelId` | `string` The ID that YouTube uses to uniquely identify the channel publishing the guide category. |\n| snippet.`title` | `string` The category's title. |"]]
