I18nRegions: list

فهرستی از مناطق محتوایی که وب‌سایت YouTube پشتیبانی می‌کند را برمی‌گرداند.

تأثیر سهمیه: تماس با این روش هزینه سهمیه ۱ واحدی دارد.

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

درخواست

درخواست HTTP

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

پارامترها

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

پارامترها
پارامترهای الزامی
part	string پارامتر part مشخص می‌کند که پاسخ API شامل کدام ویژگی‌های منبع i18nRegion خواهد بود. مقدار پارامتر را روی snippet تنظیم کنید.
پارامترهای اختیاری
hl	string پارامتر hl زبانی را مشخص می‌کند که باید برای مقادیر نوشتاری در پاسخ میانای برنامه‌سازی کاربردی استفاده شود. مقدار پیش‌فرض en_US است.

متن درخواست

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

پاسخ

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

{
  "kind": "youtube#i18nRegionListResponse",
  "etag": etag,
  "items": [
    i18nRegion resource
  ]
}

مشخصات

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

مشخصات
kind	string نوع منبع میانای برنامه‌سازی کاربردی را مشخص می‌کند. مقدار youtube#i18nRegionListResponse خواهد بود.
etag	etag Etag این منبع.
items[]	list فهرست مناطقی که YouTube در آن‌ها دردسترس است. در این نقشه، شناسه منطقه i18n کلید نقشه است و مقدار آن منبع i18nRegion مربوطه است.

خطاها

این میانای برنامه‌سازی کاربردی هیچ پیام خطایی را که مختص این روش میانای برنامه‌سازی کاربردی باشد تعریف نمی‌کند. بااین‌حال، این روش همچنان می‌تواند خطاهای عمومی API را که در سند پیام خطا فهرست شده است برگرداند.

امتحان کنید!

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