获取 regionalAndLanguageSettings

命名空间:microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

获取 regionalAndLanguageSettings 对象 的属性。

权限

需要以下权限之一才能调用此 API。要了解包括如何选择权限的详细信息,请参阅权限

权限类型 权限 (权限级别从最低到最多)
委派(工作或学校帐户) User.Read、User.Read.All
委派 (个人帐户) User.Read、User.Read.All
应用程序 User.Read、User.Read.All

HTTP 请求

GET /settings/regionalAndLanguageSettings

可选的查询参数

可以使用 获取特定的 $select regionalAndLanguageSettings 属性,包括默认情况下未返回的属性。

有关 OData 查询选项的详细信息,请参阅 OData 查询参数

请求头

标头
Authorization Bearer {token}。必需。

请求正文

请勿提供此方法的请求正文。

响应

如果成功,此方法在响应 200 OK 正文中返回 响应代码和 regionalAndLanguageSettings 对象。

示例

以下示例获取已登录用户的属性。

请求

GET https://graph.microsoft.com/beta/me/settings/regionalAndLanguageSettings

响应

注意: 为了提高可读性,可能缩短了此处显示的响应对象。

HTTP/1.1 200 OK
Content-type: application/json

{
    "defaultDisplayLanguage": {
        "locale": "en-US",
        "displayName": "English (United States)"
    },
    "authoringLanguages": [
        {
            "locale": "fr-FR",
            "displayName": "French (France)"
        },
        {
            "locale": "de-DE",
            "displayName": "German (Germany)"
        },
    ],
    "defaultTranslationLanguage": {
        "locale": "en-US",
        "displayName": "English (United States)"
    },
    "defaultSpeechInputLanguage": {
        "locale": "en-US",
        "displayName": "English (United States)"
    },
    "defaultRegionalFormat": {
        "locale": "en-GB",
        "displayName": "English (United Kingdom)"
    },
    "regionalFormatOverrides": {
        "calendar": "Gregorian Calendar",
        "firstDayOfWeek": "Sunday",
        "shortDateFormat": "yyyy-MM-dd",
        "longDateFormat": "dddd, MMMM d, yyyy",
        "shortTimeFormat": "HH:mm",
        "longTimeFormat": "h:mm:ss tt",
        "timeZone": "Pacific Standard Time"
    },
    "translationPreferences": {
        "translationBehavior": "Yes",
        "languageOverrides": [
            {
                "languageTag": "fr",
                "translationBehavior": "Yes" 
            }
        ],
        "untranslatedLanguages": ["de"]
     }
}