משאב i18nRegion מזהה אזור גיאוגרפי שמשתמש ב-YouTube יכול לבחור בתור אזור התוכן המועדף. אפשר גם להתייחס לאזור התוכן בתור 'אזור תוכן'. באתר YouTube, אזור התוכן יכול להיבחר באופן אוטומטי על סמך שיטות ניתוח כמו הדומיין של YouTube או מיקום כתובת ה-IP של המשתמש. משתמשים יכולים גם לבחור באופן ידני את אזור התוכן הרצוי בכותרת התחתונה של אתר YouTube.
כל משאב i18nRegion מזהה קוד אזור ושם. אפשר להשתמש בקוד האזור כערך של הפרמטר regionCode כשקוראים לשיטות API כמו search.list, videos.list, activities.list ו-videoCategories.list.
Methods
ה-API תומך בשיטות הבאות למשאבי i18nRegions:
- list
- הפונקציה מחזירה רשימה של אזורי תוכן שנתמכים באתר YouTube. כדאי לנסות עכשיו.
ייצוג משאבים
המבנה הבא של JSON מציג את הפורמט של משאב i18nRegions:
{
"kind": "youtube#i18nRegion",
"etag": etag,
"id": string,
"snippet": {
"gl": string,
"name": string
}
}מאפיינים
בטבלה הבאה מפורטים המאפיינים שמופיעים במשאב הזה:
| מאפיינים | |
|---|---|
kind |
stringמזהה את סוג משאב ה-API. הערך יהיה youtube#i18nRegion. |
etag |
etagה-Etag של המשאב הזה. |
id |
stringהמזהה שמשמש את YouTube לזיהוי ייחודי של אזור ה-i18n. |
snippet |
objectהאובייקט snippet מכיל פרטים בסיסיים על אזור ה-i18n, כמו שם האזור וקידוד האזור. |
snippet.gl |
stringקוד מדינה בן שתי אותיות לפי תקן ISO שמזהה את האזור. |
snippet.name |
stringשם האזור. |