Updates language settings. If 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.
Request Request Example
Shell
JavaScript
Java
Swift
curl--location--request PUT 'https://gmail.googleapis.com//gmail/v1/users//settings/language' \
--header'Content-Type: application/json' \
--data-raw''
Response Response Example
{"displayLanguage":"string"}
Request
Path Params
userId
string
required
User's email address. The special value "me" can be used to indicate the authenticated user.
Body Params application/json
Language settings for an account. These settings correspond to the "Language settings" feature in the web interface.
displayLanguage
string
optional
The language to display Gmail in, formatted as an RFC 3066 Language Tag (for example en-GB, fr or ja for British English, French, or Japanese respectively). The set of languages supported by Gmail evolves over time, so please refer to the "Language" dropdown in the Gmail settings for all available options, as described in the language settings help article. A table of sample values is also provided in the Managing Language Settings guide Not all Gmail clients can display the same set of languages. In the case that a user's display language is not available for use on a particular client, said client automatically chooses to display in the closest supported variant (or a reasonable default).
Examples
Responses
🟢200Successful response
application/json
Body
Language settings for an account. These settings correspond to the "Language settings" feature in the web interface.
displayLanguage
string
optional
The language to display Gmail in, formatted as an RFC 3066 Language Tag (for example en-GB, fr or ja for British English, French, or Japanese respectively). The set of languages supported by Gmail evolves over time, so please refer to the "Language" dropdown in the Gmail settings for all available options, as described in the language settings help article. A table of sample values is also provided in the Managing Language Settings guide Not all Gmail clients can display the same set of languages. In the case that a user's display language is not available for use on a particular client, said client automatically chooses to display in the closest supported variant (or a reasonable default).
