/gmail/v1/users/{userId}/settings/language
PUT
/gmail/v1/users/{userId}/settings/languageUpdates 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
User's email address. The special value "me" can be used to indicate the authenticated user.
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).
Request samples
Responses
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).
{
"displayLanguage": "string"
}