یک منبع i18nRegion یک منطقه جغرافیایی را شناسایی میکند که کاربر YouTube میتواند بهعنوان منطقه محتوای ترجیحی انتخاب کند. منطقه محتوا را میتوان بهعنوان منطقه زبانی محتوا نیز نامید. برای وبسایت YouTube، یک منطقه محتوا میتواند بهطور خودکار براساس اکتشافاتی مانند دامنه YouTube یا مکان IP کاربر انتخاب شود. کاربر همچنین میتواند بهصورت دستی منطقه محتوای موردنظر را از پاورقی سایت YouTube انتخاب کند.
هر منبع i18nRegion یک کد منطقه و یک نام را شناسایی میکند. کد منطقه میتواند بهعنوان مقدار پارامتر regionCode هنگام فراخوانی روشهای API مانند search.list، videos.list، activities.list، و videoCategories.list استفاده شود.
روشها
این میانای برنامهسازی کاربردی از روشهای زیر برای منابع i18nRegions پشتیبانی میکند:
- فهرست
- فهرستی از مناطق محتوایی را که وبسایت YouTube پشتیبانی میکند برمیگرداند. اکنون امتحان کنید.
نمایش منبع
ساختار JSON زیر قالب منبع i18nRegions را نشان میدهد:
{
"kind": "youtube#i18nRegion",
"etag": etag,
"id": string,
"snippet": {
"gl": string,
"name": string
}
}مشخصات
جدول زیر ویژگیهایی را که در این منبع ظاهر میشوند تعریف میکند:
| مشخصات | |
|---|---|
kind |
stringنوع منبع میانای برنامهسازی کاربردی را مشخص میکند. مقدار youtube#i18nRegion خواهد بود. |
etag |
etagEtag این منبع. |
id |
stringشناسهای که YouTube برای شناسایی یکتای منطقه i18n استفاده میکند. |
snippet |
objectشیء snippet حاوی جزئیات پایه درباره منطقه i18n، مانند کد و نام منطقه است. |
snippet.gl |
stringکد کشور دوحرفی ISO که منطقه را مشخص میکند. |
snippet.name |
stringنام منطقه. |