في حال نجاح العملية، يحتوي العنصر المُعاد على displayLanguage الذي تم حفظه للمستخدم، وقد يختلف عن القيمة التي تم تمريرها إلى الطلب. ويرجع ذلك إلى أنّ displayLanguage المطلوبة قد لا تكون متوافقة مباشرةً مع Gmail ولكن لديها صيغة مشابهة متوافقة، وبالتالي قد يتم اختيار الصيغة وحفظها بدلاً من ذلك.
طلب HTTP
PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/language
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: users.settings.updateLanguage\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates language settings.\n\nIf successful, the return object contains the `displayLanguage` that was saved for the user, which may differ from the value passed into the request. This is because the requested `displayLanguage` may not be directly supported by Gmail but have a close variant that is, and so the variant may be chosen and saved instead.\n\n### HTTP request\n\n`PUT https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/language`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------------------------------------------------------------------------------|\n| `userId` | `string` User's email address. The special value \"me\" can be used to indicate the authenticated user. |\n\n### Request body\n\nThe request body contains an instance of [LanguageSettings](/workspace/gmail/api/reference/rest/v1/LanguageSettings).\n\n### Response body\n\nIf successful, the response body contains an instance of [LanguageSettings](/workspace/gmail/api/reference/rest/v1/LanguageSettings).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/gmail.settings.basic`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
