Edit

Share via

regionalAndLanguageSettings resource type

  • Article

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

An open type that represents a user's preferences for languages in various contexts, and for regional locale and formatting that drives the default calendar, and formatting for date and time.

Methods

Method Return Type Description
Get regionalAndLanguageSettings Read properties of a regionalAndLanguageSettings object.
Update regionalAndLanguageSettings Update all or a subset of the properties of the regionalAndLanguageSettings object for a user.

Properties

Property Type Description
defaultDisplayLanguage localeInfo The user's preferred user interface language (menus, buttons, ribbons, warning messages) for Microsoft web applications.

Returned by default. Not nullable.
authoringLanguages localeInfo collection Prioritized list of languages the user reads and authors in.

Returned by default. Not nullable.
defaultTranslationLanguage localeInfo The language a user expects to have documents, emails, and messages translated into.

Returned by default.
defaultSpeechInputLanguage localeInfo The language a user expected to use as input for text to speech scenarios.

Returned by default.
defaultRegionalFormat localeInfo The locale that drives the default date, time, and calendar formatting.

Returned by default.
regionalFormatOverrides regionalFormatOverrides Allows a user to override their defaultRegionalFormat with field specific formats.

Returned by default.
translationPreferences translationPreferences The user's preferred settings when consuming translated documents, emails, messages, and websites.

Returned by default. Not nullable.

JSON representation

The following is a JSON definition of the resource.

{
    "defaultDisplayLanguage": {"@odata.type":"microsoft.graph.localeInfo"},
    "authoringLanguages": [{"@odata.type":"microsoft.graph.localeInfo"}],
    "defaultTranslationLanguage": {"@odata.type":"microsoft.graph.localeInfo"},
    "defaultSpeechInputLanguage": {"@odata.type":"microsoft.graph.localeInfo"},
    "defaultRegionalFormat": {"@odata.type":"microsoft.graph.localeInfo"},
    "regionalFormatOverrides": {"@odata.type":"microsoft.graph.regionalFormatOverrides"},
    "translationPreferences":{"@odata.type":"microsoft.graph.translationPreferences"}
}