VideoCategories: list

فهرستی از دسته‌هایی را که می‌توان با ویدیوهای YouTube مرتبط کرد، برمی‌گرداند.

تاثیر سهمیه ای: فراخوانی به این روش هزینه سهمیه ای 1 واحدی دارد.

موارد استفاده رایج

درخواست

درخواست HTTP

GET https://www.googleapis.com/youtube/v3/videoCategories

مولفه های

جدول زیر پارامترهایی را که این کوئری پشتیبانی می کند فهرست می کند. تمام پارامترهای لیست شده پارامترهای پرس و جو هستند.

مولفه های
پارامترهای مورد نیاز
part string
پارامتر part ویژگی های منبع videoCategory را که پاسخ API شامل می شود را مشخص می کند. مقدار پارامتر را روی snippet تنظیم کنید.
فیلترها (دقیقا یکی از پارامترهای زیر را مشخص کنید)
id string
پارامتر id فهرستی از شناسه‌های دسته‌بندی ویدیویی جدا شده با کاما را برای منابعی که بازیابی می‌کنید مشخص می‌کند.
regionCode string
پارامتر regionCode به API دستور می دهد تا لیست دسته بندی های ویدئویی موجود در کشور مشخص شده را بازگرداند. مقدار پارامتر یک کد کشور ISO 3166-1 alpha-2 است.
پارامترهای اختیاری
hl string
پارامتر hl زبانی را مشخص می کند که باید برای مقادیر متن در پاسخ API استفاده شود. مقدار پیش فرض en_US است.

درخواست بدن

هنگام فراخوانی این روش، بدنه درخواست ارائه نکنید.

واکنش

در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:

{
  "kind": "youtube#videoCategoryListResponse",
  "etag": etag,
  "nextPageToken": string,
  "prevPageToken": string,
  "pageInfo": {
    "totalResults": integer,
    "resultsPerPage": integer
  },
  "items": [
    videoCategory resource
  ]
}

خواص

جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:

خواص
kind string
نوع منبع API را مشخص می کند. مقدار youtube#videoCategoryListResponse خواهد بود.
etag etag
Etag این منبع
nextPageToken string
نشانه ای که می تواند به عنوان مقدار پارامتر pageToken برای بازیابی صفحه بعدی در مجموعه نتایج استفاده شود.
prevPageToken string
نشانه ای که می تواند به عنوان مقدار پارامتر pageToken برای بازیابی صفحه قبلی در مجموعه نتایج استفاده شود.
pageInfo object
شی pageInfo اطلاعات صفحه‌بندی را برای مجموعه نتایج کپسوله می‌کند.
pageInfo. totalResults integer
تعداد کل نتایج در مجموعه نتایج.
pageInfo. resultsPerPage integer
تعداد نتایج موجود در پاسخ API.
items[] list
لیستی از دسته بندی های ویدیویی که می توانند با ویدیوهای YouTube مرتبط شوند. در این نقشه، شناسه دسته ویدیو، کلید نقشه است و مقدار آن، منبع مربوط به videoCategory است.

خطاها

جدول زیر پیام های خطایی را مشخص می کند که API می تواند در پاسخ به تماس با این روش بازگرداند. لطفاً برای جزئیات بیشتر به مستندات پیام خطا مراجعه کنید.

نوع خطا جزئیات خطا شرح
notFound (404) videoCategoryNotFound دسته ویدیویی که با پارامتر id مشخص شده است یافت نمی شود. از روش videoCategories.list برای بازیابی لیستی از مقادیر معتبر استفاده کنید.

آن را امتحان کنید!

از APIs Explorer برای فراخوانی این API و مشاهده درخواست و پاسخ API استفاده کنید.