/gmail/v1/users/{userId}/settings/language

PUT

users

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 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 '{
    "displayLanguage": "string"
}'

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

/gmail/v1/users/{userId}/settings/language

/gmail/v1/users/{userId}/settings/pop