Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Actualice algunas o todas las propiedades de un objeto regionalAndLanguageSettings .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global |
Gobierno de EE. UU. L4 |
Us Government L5 (DOD) |
China operada por 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
User.ReadWrite |
User.ReadWrite.All |
| Delegado (cuenta personal) |
User.ReadWrite |
User.ReadWrite.All |
| Aplicación |
User.ReadWrite |
User.ReadWrite.All |
Solicitud HTTP
Para actualizar toda la configuración regional y de idioma de un usuario:
PUT /me/settings/regionalAndLanguageSettings
PUT /users/{user-id | userPrincipalName}/settings/regionalAndLanguageSettings
Nota:
Para llamar al punto de conexión /me, se requiere un usuario con la sesión iniciada y, por lo tanto, un permiso delegado. Los permisos de aplicación no se admiten cuando se usa el punto de /me conexión.
Para actualizar un subconjunto de las propiedades de la configuración regional y de idioma de un usuario:
PATCH /me/settings/regionalAndLanguageSettings
PATCH /users/{user-id | userPrincipalName}/settings/regionalAndLanguageSettings
Nota:
Para llamar al punto de conexión /me, se requiere un usuario con la sesión iniciada y, por lo tanto, un permiso delegado. Los permisos de aplicación no se admiten cuando se usa el punto de /me conexión.
| Encabezado |
Valor |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
PUT: en el cuerpo de la solicitud, proporcione un objeto regionalAndLanguageSettings .
PATCH: proporcione solo los valores de los campos pertinentes que se deben actualizar. Las propiedades existentes que no se incluyan en el cuerpo de la solicitud mantendrán los valores anteriores o se recalcularán según los cambios efectuados en otros valores de propiedad. Para obtener el mejor rendimiento no debe incluir valores existentes que no hayan cambiado.
Respuesta
Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.
Ejemplo
Ejemplo 1: Actualizar todo el objeto regionalAndLanguageSettings del usuario que ha iniciado sesión
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PUT https://graph.microsoft.com/beta/me/settings/regionalAndLanguageSettings
Content-type: application/json
{
"defaultDisplayLanguage": {
"locale": "en-US"
},
"authoringLanguages": [
{
"locale": "fr-FR"
},
{
"locale": "de-DE"
}
],
"defaultTranslationLanguage": {
"locale": "en-US"
},
"defaultSpeechInputLanguage": {
"locale": "en-US"
},
"defaultRegionalFormat": {
"locale": "en-GB"
},
"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"
}
]
}
}
const options = {
authProvider,
};
const client = Client.init(options);
const regionalAndLanguageSettings = {
defaultDisplayLanguage: {
locale: 'en-US'
},
authoringLanguages: [
{
locale: 'fr-FR'
},
{
locale: 'de-DE'
}
],
defaultTranslationLanguage: {
locale: 'en-US'
},
defaultSpeechInputLanguage: {
locale: 'en-US'
},
defaultRegionalFormat: {
locale: 'en-GB'
},
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'
}
]
}
};
await client.api('/me/settings/regionalAndLanguageSettings')
.version('beta')
.put(regionalAndLanguageSettings);
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content
Ejemplo 2: Actualización de las propiedades seleccionadas del usuario que ha iniciado sesión
Solicitud
En el ejemplo siguiente se muestra la solicitud.
PATCH https://graph.microsoft.com/beta/me/settings/regionalAndLanguageSettings
Content-type: application/json
{
"authoringLanguages": [
{
"locale": "en-US" },
{
"locale": "es-MX" }
],
"defaultRegionalFormat": {
"locale": "en-US"
}
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new RegionalAndLanguageSettings
{
AuthoringLanguages = new List<LocaleInfo>
{
new LocaleInfo
{
Locale = "en-US",
},
new LocaleInfo
{
Locale = "es-MX",
},
},
DefaultRegionalFormat = new LocaleInfo
{
Locale = "en-US",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Settings.RegionalAndLanguageSettings.PatchAsync(requestBody);
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
//other-imports
)
requestBody := graphmodels.NewRegionalAndLanguageSettings()
localeInfo := graphmodels.NewLocaleInfo()
locale := "en-US"
localeInfo.SetLocale(&locale)
localeInfo1 := graphmodels.NewLocaleInfo()
locale := "es-MX"
localeInfo1.SetLocale(&locale)
authoringLanguages := []graphmodels.LocaleInfoable {
localeInfo,
localeInfo1,
}
requestBody.SetAuthoringLanguages(authoringLanguages)
defaultRegionalFormat := graphmodels.NewLocaleInfo()
locale := "en-US"
defaultRegionalFormat.SetLocale(&locale)
requestBody.SetDefaultRegionalFormat(defaultRegionalFormat)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
regionalAndLanguageSettings, err := graphClient.Me().Settings().RegionalAndLanguageSettings().Patch(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
RegionalAndLanguageSettings regionalAndLanguageSettings = new RegionalAndLanguageSettings();
LinkedList<LocaleInfo> authoringLanguages = new LinkedList<LocaleInfo>();
LocaleInfo localeInfo = new LocaleInfo();
localeInfo.setLocale("en-US");
authoringLanguages.add(localeInfo);
LocaleInfo localeInfo1 = new LocaleInfo();
localeInfo1.setLocale("es-MX");
authoringLanguages.add(localeInfo1);
regionalAndLanguageSettings.setAuthoringLanguages(authoringLanguages);
LocaleInfo defaultRegionalFormat = new LocaleInfo();
defaultRegionalFormat.setLocale("en-US");
regionalAndLanguageSettings.setDefaultRegionalFormat(defaultRegionalFormat);
RegionalAndLanguageSettings result = graphClient.me().settings().regionalAndLanguageSettings().patch(regionalAndLanguageSettings);
const options = {
authProvider,
};
const client = Client.init(options);
const regionalAndLanguageSettings = {
authoringLanguages: [
{
locale: 'en-US' },
{
locale: 'es-MX' }
],
defaultRegionalFormat: {
locale: 'en-US'
}
};
await client.api('/me/settings/regionalAndLanguageSettings')
.version('beta')
.update(regionalAndLanguageSettings);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\RegionalAndLanguageSettings;
use Microsoft\Graph\Beta\Generated\Models\LocaleInfo;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new RegionalAndLanguageSettings();
$authoringLanguagesLocaleInfo1 = new LocaleInfo();
$authoringLanguagesLocaleInfo1->setLocale('en-US');
$authoringLanguagesArray []= $authoringLanguagesLocaleInfo1;
$authoringLanguagesLocaleInfo2 = new LocaleInfo();
$authoringLanguagesLocaleInfo2->setLocale('es-MX');
$authoringLanguagesArray []= $authoringLanguagesLocaleInfo2;
$requestBody->setAuthoringLanguages($authoringLanguagesArray);
$defaultRegionalFormat = new LocaleInfo();
$defaultRegionalFormat->setLocale('en-US');
$requestBody->setDefaultRegionalFormat($defaultRegionalFormat);
$result = $graphServiceClient->me()->settings()->regionalAndLanguageSettings()->patch($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Users
$params = @{
authoringLanguages = @(
@{
locale = "en-US"
}
@{
locale = "es-MX"
}
)
defaultRegionalFormat = @{
locale = "en-US"
}
}
# A UPN can also be used as -UserId.
Update-MgBetaUserSettingRegionalAndLanguageSetting -UserId $userId -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.regional_and_language_settings import RegionalAndLanguageSettings
from msgraph_beta.generated.models.locale_info import LocaleInfo
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = RegionalAndLanguageSettings(
authoring_languages = [
LocaleInfo(
locale = "en-US",
),
LocaleInfo(
locale = "es-MX",
),
],
default_regional_format = LocaleInfo(
locale = "en-US",
),
)
result = await graph_client.me.settings.regional_and_language_settings.patch(request_body)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 204 No Content