outlookUser: supportedTimeZones

Статья
10/31/2023

Пространство имен: microsoft.graph

Получение списка поддерживаемых часовых поясов, которые настроены на сервере почтовых ящиков пользователя.

Вы можете явно указать, чтобы часовые пояса возвращались в формате часового пояса Windows или в формате часового пояса IANA (также известного как часовой пояс Олсона). Формат Windows используется по умолчанию.

Настраивая клиент Outlook, пользователь выбирает часовой пояс из этого списка. После этого вы можете получить выбранный часовой пояс вместе с настройками почтового ящика пользователя.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба	Правительство США L4	Правительство США L5 (DOD)	Китай управляется 21Vianet
✅	✅	✅	✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения	Разрешения с наименьшими привилегиями	Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)	User.Read	User.Read.All, User.ReadBasic.All
Делегированные (личная учетная запись Майкрософт)	User.Read	Недоступно.
Для приложений	Не поддерживается.	Не поддерживается.

HTTP-запрос

GET /me/outlook/supportedTimeZones
GET /users/{id|userPrincipalName}/outlook/supportedTimeZones

GET /me/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'{timezone_format}')
GET /users/{id|userPrincipalName}/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'{timezone_format}')

Параметры функции

Параметр	Тип	Описание
TimeZoneStandard	timeZoneStandard	Формат часовых поясов. Поддерживаемые значение: `Windows` и `Iana`. Необязательный параметр.

Заголовки запросов

Имя	Тип	Описание
Authorization	string	Bearer {token}. Обязательно.

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения этот метод возвращает код ответа 200 OK и коллекцию объектов timeZoneInformation в тексте ответа.

Пример

Запрос 1

В приведенном ниже примере не указывается параметр timeZoneStandard и считывается список поддерживаемых часовых поясов, представленных в формате часовых поясов Windows.

GET https://graph.microsoft.com/v1.0/me/outlook/supportedTimeZones


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Me.Outlook.SupportedTimeZones.GetAsSupportedTimeZonesGetResponseAsync();


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc users outlook supported-time-zones get --user-id {user-id}



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



supportedTimeZones, err := graphClient.Me().Outlook().SupportedTimeZones().GetAsSupportedTimeZonesGetResponse(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

var result = graphClient.me().outlook().supportedTimeZones().get();


const options = {
	authProvider,
};

const client = Client.init(options);

let supportedTimeZones = await client.api('/me/outlook/supportedTimeZones')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->me()->outlook()->supportedTimeZones()->get()->wait();


Import-Module Microsoft.Graph.Users.Functions

# A UPN can also be used as -UserId.
Invoke-MgTimeUserOutlook -UserId $userId


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.me.outlook.supported_time_zones.get()

Отклик 1

Ниже показан пример отклика.

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

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.timeZoneInformation)",
  "value":[
    {
      "alias":"Dateline Standard Time",
      "displayName":"(UTC-12:00) International Date Line West"
    },
    {
      "alias":"Samoa Standard Time",
      "displayName":"(UTC+13:00) Samoa"
    },
    {
       "alias":"UTC-11",
       "displayName":"(UTC-11:00) Coordinated Universal Time-11"
    },
    {
      "alias":"Aleutian Standard Time",
      "displayName":"(UTC-10:00) Aleutian Islands"
    }
  ]
}

Запрос 2

В приведенном ниже примере для параметра TimeZoneStandard задается значение Iana и считывается список поддерживаемых часовых поясов в формате IANA.

GET https://graph.microsoft.com/v1.0/me/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'Iana')

Snippet not available

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let supportedTimeZones = await client.api('/me/outlook/supportedTimeZones(TimeZoneStandard=microsoft.graph.timeZoneStandard'Iana')')
	.get();

Snippet not available

Snippet not available

Snippet not available

Отклик 2

Ниже приводится пример отклика.

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

{
  "@odata.context":"https://graph.microsoft.com/v1.0/$metadata#Collection(microsoft.graph.timeZoneInformation)",
  "value":[
    {
      "alias":"Etc/GMT+12",
      "displayName":"Etc/GMT+12"
    },
    {
      "alias":"US/Samoa",
      "displayName":"US/Samoa"
    },
    {
      "alias":"Etc/GMT+11",
      "displayName":"Etc/GMT+11"
    },
    {
      "alias":"US/Aleutian",
      "displayName":"US/Aleutian"
    }
  ]
}