نحن بصدد تعديل Data API لتتطابق مع طريقة YouTube في احتساب مشاهدات Shorts.
مزيد من المعلومات
GuideCategories: list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ملاحظة: هذا إشعار بإيقاف نهائي.
تم إيقاف كل من مورد guideCategories وطريقة guideCategories.list نهائيًا اعتبارًا من 9 سبتمبر 2020.
تعرض هذه الطريقة قائمة بالفئات التي يمكن ربطها بقنوات YouTube.
تأثير الحصة: تبلغ تكلفة الحصة لطلب البيانات من هذه الطريقة وحدة واحدة.
طلب
طلب HTTP
GET https://www.googleapis.com/youtube/v3/guideCategories
المعلمات
يسرد الجدول أدناه المَعلمات التي يتيحها طلب البحث هذا. جميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.
| المعلمات |
| المَعلمات المطلوبة |
part |
string
تحدّد المَعلمة part خصائص المورد guideCategory التي سيتضمّنها ردّ واجهة برمجة التطبيقات. اضبط قيمة المَعلمة على snippet.
|
| الفلاتر (حدِّد مَعلمة واحدة فقط من المَعلمات التالية) |
id |
string
تحدّد المَعلمة id قائمة بمعرّفات فئات قنوات YouTube مفصولة بفواصل للموارد التي يتم استردادها. في مورد guideCategory، تحدّد السمة id رقم تعريف فئة قناة YouTube. |
regionCode |
string
تطلب المَعلمة regionCode من واجهة برمجة التطبيقات عرض قائمة بفئات الدليل المتوفّرة في البلد المحدّد. قيمة المَعلمة هي رمز البلد وفقًا لمعيار ISO 3166-1 alpha-2. |
| المَعلمات الاختيارية |
hl |
string
تحدّد المَعلمة hl اللغة التي سيتم استخدامها للقيم النصية في استجابة واجهة برمجة التطبيقات. القيمة التلقائية هي en-US. |
نص الطلب
لا تقدِّم نص طلب عند استدعاء هذه الطريقة.
الردّ
في حال نجاح العملية، تعرض هذه الطريقة نص استجابة بالبنية التالية:
{
"kind": "youtube#guideCategoryListResponse",
"etag": etag,
"nextPageToken": string,
"prevPageToken": string,
"pageInfo": {
"totalResults": integer,
"resultsPerPage": integer
},
"items": [
guideCategory resource
]
}
الخصائص
يحدّد الجدول التالي السمات التي تظهر في هذا المرجع:
| الخصائص |
kind |
string
تحدّد هذه السمة نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#guideCategoryListResponse. |
etag |
etag
تمثّل هذه السمة علامة Etag الخاصة بهذا المرجع. |
nextPageToken |
string
الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة التالية في مجموعة النتائج. |
prevPageToken |
string
الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة السابقة في مجموعة النتائج. |
pageInfo |
object
يحتوي العنصر pageInfo على معلومات حول تقسيم مجموعة النتائج إلى صفحات. |
pageInfo.totalResults |
integer
تمثّل هذه السمة إجمالي عدد النتائج في مجموعة النتائج. |
pageInfo.resultsPerPage |
integer
عدد النتائج المُضمَّنة في الردّ من واجهة برمجة التطبيقات. |
items[] |
list
قائمة بالفئات التي يمكن ربطها بقنوات YouTube. في هذه الخريطة، يكون معرّف الفئة هو مفتاح الخريطة، وتكون قيمته هي مورد guideCategory المقابل. |
الأخطاء
يوضّح الجدول أدناه رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على طلب تم إرساله إلى هذه الطريقة. يُرجى الاطّلاع على مستندات رسالة الخطأ لمزيد من التفاصيل.
| نوع الخطأ |
تفاصيل الخطأ |
الوصف |
notFound (404) |
notFound |
لا يمكن العثور على فئة الدليل المحدّدة بواسطة المَعلمة id. استخدِم طريقة guideCategories.list لاسترداد قائمة بالقيم الصالحة. |
جرّب الآن
استخدِم APIs Explorer لطلب بيانات من واجهة برمجة التطبيقات هذه والاطّلاع على طلب البيانات والاستجابة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe \u003ccode\u003eguideCategories\u003c/code\u003e resource and \u003ccode\u003eguideCategories.list\u003c/code\u003e method have been deprecated as of September 9, 2020.\u003c/p\u003e\n"],["\u003cp\u003eThis API method, when functional, returned a list of categories associated with YouTube channels.\u003c/p\u003e\n"],["\u003cp\u003eA call to this method has a quota cost of 1 unit.\u003c/p\u003e\n"],["\u003cp\u003eThe API request requires the \u003ccode\u003epart\u003c/code\u003e parameter with the value \u003ccode\u003esnippet\u003c/code\u003e, and either the \u003ccode\u003eid\u003c/code\u003e or \u003ccode\u003eregionCode\u003c/code\u003e as a filtering parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe method's response, when functional, included properties such as \u003ccode\u003ekind\u003c/code\u003e, \u003ccode\u003eetag\u003c/code\u003e, \u003ccode\u003enextPageToken\u003c/code\u003e, \u003ccode\u003eprevPageToken\u003c/code\u003e, and \u003ccode\u003epageInfo\u003c/code\u003e, along with a list of \u003ccode\u003eguideCategory\u003c/code\u003e resources in the \u003ccode\u003eitems\u003c/code\u003e property.\u003c/p\u003e\n"]]],["The `guideCategories` resource and `guideCategories.list` method were deprecated on September 9, 2020. This method previously returned a list of YouTube channel categories. Key parameters included `part` (specifying properties), `id` (category IDs), and `regionCode` (country-specific categories). The method had a quota cost of 1 unit and did not use a request body. A successful response included metadata like `kind`, `etag`, `pageInfo`, and a list of `guideCategory` resources.\n"],null,["# GuideCategories: list\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.\nReturns a list of categories that can be associated with YouTube channels.\n\n**Quota impact:** A call to this method has a [quota cost](/youtube/v3/getting-started#quota) of 1 unit.\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/youtube/v3/guideCategories\n```\n\n### Parameters\n\nThe table below lists the parameters that this query supports. All of the parameters listed are query parameters.\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| **Required parameters** |||\n| `part` | `string` The **part** parameter specifies the `guideCategory` resource properties that the API response will include. Set the parameter value to `snippet`. |\n| **Filters (specify exactly one of the following parameters)** |||\n| `id` | `string` The **id** parameter specifies a comma-separated list of the YouTube channel category ID(s) for the resource(s) that are being retrieved. In a `guideCategory` resource, the `id` property specifies the YouTube channel category ID. |\n| `regionCode` | `string` The **regionCode** parameter instructs the API to return the list of guide categories available in the specified country. The parameter value is an [ISO 3166-1 alpha-2](http://www.iso.org/iso/country_codes/iso_3166_code_lists/country_names_and_code_elements.htm) country code. |\n| **Optional parameters** |||\n| `hl` | `string` The **hl** parameter specifies the language that will be used for text values in the API response. The default value is `en-US`. |\n\n### Request body\n\nDo not provide a request body when calling this method.\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure: \n\n```objective-c\n{\n \"kind\": \"youtube#guideCategoryListResponse\",\n \"etag\": etag,\n \"nextPageToken\": string,\n \"prevPageToken\": string,\n \"pageInfo\": {\n \"totalResults\": integer,\n \"resultsPerPage\": integer\n },\n \"items\": [\n guideCategory resource\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#guideCategoryListResponse`. |\n| `etag` | `etag` The Etag of this resource. |\n| `nextPageToken` | `string` The token that can be used as the value of the `pageToken` parameter to retrieve the next page in the result set. |\n| `prevPageToken` | `string` The token that can be used as the value of the `pageToken` parameter to retrieve the previous page in the result set. |\n| `pageInfo` | `object` The `pageInfo` object encapsulates paging information for the result set. |\n| pageInfo.`totalResults` | `integer` The total number of results in the result set. |\n| pageInfo.`resultsPerPage` | `integer` The number of results included in the API response. |\n| `items[]` | `list` A list of categories that can be associated with YouTube channels. In this map, the category ID is the map key, and its value is the corresponding `guideCategory` resource. |\n\nErrors\n------\n\nThe table below identifies error messages that the API could return in response to a call to this method. Please see the [error message](/youtube/v3/docs/errors) documentation for more detail.\n\n| Error type | Error detail | Description |\n|------------------|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `notFound (404)` | `notFound` | The guide category identified by the `id` parameter cannot be found. Use the [guideCategories.list](/youtube/v3/docs/guideCategories/list) method to retrieve a list of valid values. |\n\nTry it!\n-------\n\nUse the APIs Explorer to call this API and see the API request and response."]]
