במאמר הזה מוסבר איך לנהל את הגדרות השפה באמצעות Gmail API.
אפשר להשתמש במשאב settings כדי להגדיר את הגדרות השפה בחשבון, וכך להגדיר את שפת התצוגה ב-Gmail.
הגדרת שפות
השיטות settings.getLanguage ו-settings.updateLanguage במשאב settings משתמשות באובייקט LanguageSettings. השדה displayLanguage של האובייקט LanguageSettings מגדיר את שפת התצוגה של Gmail. הפורמט של שפת התצוגה הוא תג שפה בפורמט RFC 3066.
לא בכל לקוחות Gmail אפשר להציג את אותה קבוצת שפות. אם שפת התצוגה של המשתמש לא זמינה בלקוח ספציפי, לקוח Gmail בוחר באופן אוטומטי את הגרסה הנתמכת הכי קרובה או ברירת מחדל סבירה.
ערכת שפות
מערך השפות הנתמכות משתנה עם הזמן. מידע נוסף על איתור רשימת השפות ב-Gmail מופיע במאמר בנושא שינוי הגדרות השפה ב-Gmail.
בטבלה הבאה מוצגת דוגמה לערכי שפה פוטנציאליים:
| שפה (אנגלית) | שפה (בהגדרות Gmail) | תג (RFC 3066) |
|---|---|---|
| אפריקאנס | אפריקאנס | af |
| אזרית | Azərbaycanca | az |
| אינדונזית | Bahasa Indonesia | id |
| מלאית | מלאית | ms |
| קטלאנית | Català | ca |
| צ'כית | Český | cs |
| וולשית | Cymraeg | cy |
| דנית | Dansk | da |
| גרמנית | Deutsch | de |
| אסטונית | Eesti keel | et |
| אנגלית (בריטניה) | אנגלית (בריטניה) | en-GB |
| אנגלית | אנגלית (ארה"ב) | en |
| ספרדית | Español | es |
| ספרדית (אמריקה הלטינית) | ספרדית (אמריקה הלטינית) | es-419 |
| בסקית | Euskara | eu |
| פיליפינית | פיליפינית | fil |
| צרפתית | Français | fr |
| צרפתית (קנדה) | צרפתית (קנדה) | fr-CA |
| אירית | Gaeilge | ga |
| Gallegan | Galego | gl |
| קרואטית | Hrvatski | hr |
| איטלקית | Italiano | it |
| זולו | IsiZulu | zu |
| איסלנדית | Íslenska | is |
| סווהילי | סוואהילית | sw |
| לטבית | Latviešu | lv |
| ליטאית | Lietuvių | lt |
| הונגרית | Magyar | hu |
| נורווגית | נורווגית (ספרותית) | no |
| הולנדית | Nederlands | nl |
| פולנית | Polski | pl |
| פורטוגזית (ברזיל) | Português (Brasil) | pt-BR |
| פורטוגזית (PT) | Português (Portugal) | pt-PT |
| רומנית | Română | ro |
| סלובקית | Slovenský | sk |
| סלובנית | Slovenščina | sl |
| פינית | Suomi | fi |
| שוודית | Svenska | sv |
| וייטנאמית | Tiếng Việt | vi |
| טורקית | Türkçe | tr |
| יוונית | Ελληνικά | el |
| בולגרית | Български | bg |
| מונגולית | מונגוליה | mn |
| רוסית | Русский | ru |
| סרבית | Српски | sr |
| אוקראינית | Українська | uk |
| ארמנית | Հայերեն | hy |
| עברית | עברית | he |
| אורדו | اردو | ur |
| ערבית | العربية | ar |
| פרסית | פרסית | fa |
| נפאלית | נפאלית (Nepali) | ne |
| מראטהית | मराठी | mr |
| הינדי | हिन्दी | hi |
| בנגלית | বাংলা | bn |
| גוג'ראטי | ગુજરાતી | gu |
| טמילית | தமிழ் | ta |
| טלוגו | తెలుగు | te |
| קנאדה | ಕನ್ನಡ | kn |
| מליאלאם | മലയാളം | ml |
| סינהלית | සිංහල (סינהלית) | si |
| תאית | ภาษาไทย | th |
| לאו | ພາສາລາວ (לאו) | lo |
| בורמזית | မြန်မာဘာသာ (Myanmar language) | my |
| גאורגית | ქართული | ka |
| אמהרית | אמהרית (Amharic) | am |
| צ'רוקי | ᏣᎳᎩ (צ'ירוקי) | chr |
| חמרית | ភាសាខ្មែរ (Khmer) | km |
| סינית (הונג קונג) | 中文 (香港) | zh-HK |
| סינית (סין) | 中文 (简体) | zh-CN |
| סינית (טאייוואן) | 中文 (繁體) | zh-TW |
| יפנית | 日本語 | ja |
| קוריאנית | 한국어 | ko |