Вызовы API с помощью пакетов SDK Microsoft Graph

Статья
2024-11-07

Библиотеки служб пакета SDK для Microsoft Graph предоставляют класс клиента, который будет использоваться в качестве отправной точки для создания всех запросов API. Существует два стиля клиентского класса: один использует интерфейс fluent для создания запроса (например, client.Users["user-id"].Manager), а другой принимает строку пути (например, api("/users/user-id/manager")). При наличии объекта запроса можно указать различные параметры, такие как фильтрация и сортировка, и, наконец, выбрать тип операции, которую вы хотите выполнить.

Существует также пакет SDK Для Microsoft Graph PowerShell, который не имеет клиентского класса. Вместо этого все запросы представлены в виде команд PowerShell. Например, чтобы получить диспетчер пользователя, команда имеет значение Get-MgUserManager. Дополнительные сведения о поиске команд для вызовов API см. в статье Навигация по пакету SDK Microsoft Graph PowerShell.

Чтение сведений из Microsoft Graph

Чтобы считывать сведения из Microsoft Graph, сначала необходимо создать объект запроса, а затем выполнить GET метод в запросе.

// GET https://graph.microsoft.com/v1.0/me
var user = await graphClient.Me
    .GetAsync();

// GET https://graph.microsoft.com/v1.0/me
result, _ := graphClient.Me().Get(context.Background(), nil)

// GET https://graph.microsoft.com/v1.0/me
final User user = graphClient.me().get();

// GET https://graph.microsoft.com/v1.0/me
/** @var Models\User $user */
$user = $graphClient->me()
    ->get()
    ->wait();

# GET https://graph.microsoft.com/v1.0/users/{user-id}

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"

$user = Get-MgUser -UserId $userId

# GET https://graph.microsoft.com/v1.0/me
user = await graph_client.me.get()

// GET https://graph.microsoft.com/v1.0/me
const user = await graphClient.api('/me').get();

Используйте $select для управления возвращаемыми свойствами

При получении сущности не все свойства извлекаются автоматически; иногда их необходимо явно выбрать. Кроме того, возвращать набор свойств по умолчанию не требуется в некоторых сценариях. Выбор только необходимых свойств может повысить производительность запроса. Вы можете настроить запрос, включив $select параметр запроса со списком свойств.

// GET https://graph.microsoft.com/v1.0/me?$select=displayName,jobTitle
var user = await graphClient.Me
    .GetAsync(requestConfiguration =>
    {
        requestConfiguration.QueryParameters.Select =
            ["displayName", "jobTitle"];
    });

// GET https://graph.microsoft.com/v1.0/me?$select=displayName,jobTitle

// import github.com/microsoftgraph/msgraph-sdk-go/users
query := users.UserItemRequestBuilderGetQueryParameters{
    Select: []string{"displayName", "jobTitle"},
}

options := users.UserItemRequestBuilderGetRequestConfiguration{
    QueryParameters: &query,
}

result, _ := graphClient.Me().Get(context.Background(), &options)

// GET https://graph.microsoft.com/v1.0/me?$select=displayName,jobTitle
final User user = graphClient.me().get( requestConfiguration -> {
    requestConfiguration.queryParameters.select = new String[] {"displayName", "jobTitle"};
});

// GET https://graph.microsoft.com/v1.0/me?$select=displayName,jobTitle
// Microsoft\Graph\Generated\Users\Item\UserItemRequestBuilderGetQueryParameters
$query = new UserItemRequestBuilderGetQueryParameters(
    select: ['displayName', 'jobTitle']);

// Microsoft\Graph\Generated\Users\Item\UserItemRequestBuilderGetRequestConfiguration
$config = new UserItemRequestBuilderGetRequestConfiguration(
    queryParameters: $query);

/** @var Models\User $user */
$user = $graphClient->me()
    ->get($config)
    ->wait();

# GET https://graph.microsoft.com/v1.0/users/{user-id}?$select=displayName,jobTitle

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"

# The -Property parameter causes a $select parameter to be included in the request
$user = Get-MgUser -UserId $userId -Property DisplayName,JobTitle

# GET https://graph.microsoft.com/v1.0/me?$select=displayName,jobTitle

# msgraph.generated.users.item.user_item_request_builder
query_params = UserItemRequestBuilder.UserItemRequestBuilderGetQueryParameters(
    select=['displayName', 'jobTitle']
)

config = RequestConfiguration(
    query_parameters=query_params
)

user = await graph_client.me.get(config)

// GET https://graph.microsoft.com/v1.0/me?$select=displayName,jobTitle
const user = await graphClient
  .api('/me')
  .select(['displayName', 'jobTitle'])
  .get();

Получение списка сущностей

Получение списка сущностей аналогично получению одной сущности, за исключением других параметров для настройки запроса. Параметр $filter запроса может уменьшить результирующий набор только в тех строках, которые соответствуют предоставленному условию. Параметр $orderby запроса запрашивает, чтобы сервер предоставил список сущностей, отсортированных по указанным свойствам.

Примечание.

Для некоторых запросов Microsoft Entra ресурсов требуется использование расширенных возможностей запросов. Если вы получите ответ, указывающий на неправильный запрос, неподдерживаемый запрос или ответ, содержащий непредвиденные результаты, включая $count параметр запроса и ConsistencyLevel заголовок, может позволить запросу выполнить успешное выполнение. Дополнительные сведения и примеры см. в разделе Расширенные возможности запросов к объектам каталогов.

// GET https://graph.microsoft.com/v1.0/me/messages?
// $select=subject,sender&$filter=subject eq 'Hello world'
var messages = await graphClient.Me.Messages
    .GetAsync(requestConfig =>
    {
        requestConfig.QueryParameters.Select =
            ["subject", "sender"];
        requestConfig.QueryParameters.Filter =
            "subject eq 'Hello world'";
    });

// GET https://graph.microsoft.com/v1.0/me/messages?
// $select=subject,sender&$filter=subject eq 'Hello world'

// import github.com/microsoftgraph/msgraph-sdk-go/users
filterValue := "subject eq 'Hello world'"
query := users.ItemMessagesRequestBuilderGetQueryParameters{
    Select: []string{"subject", "sender"},
    Filter: &filterValue,
}

options := users.ItemMessagesRequestBuilderGetRequestConfiguration{
    QueryParameters: &query,
}

result, _ := graphClient.Me().Messages().
    Get(context.Background(), &options)

// GET https://graph.microsoft.com/v1.0/me/messages?
// $select=subject,sender&$filter=subject eq 'Hello world'
final MessageCollectionResponse messages = graphClient.me().messages().get( requestConfiguration -> {
    requestConfiguration.queryParameters.select = new String[] {"subject", "sender"};
    requestConfiguration.queryParameters.filter = "subject eq 'Hello world'";
});

// GET https://graph.microsoft.com/v1.0/me/messages?
// $select=subject,sender&$filter=subject eq 'Hello world'
// Microsoft\Graph\Generated\Users\Item\Messages\MessagesRequestBuilderGetQueryParameters
$query = new MessagesRequestBuilderGetQueryParameters(
    select: ['subject', 'sender'],
    filter: 'subject eq \'Hello world\''
);

// Microsoft\Graph\Generated\Users\Item\Messages\MessagesRequestBuilderGetRequestConfiguration
$config = new MessagesRequestBuilderGetRequestConfiguration(
    queryParameters: $query);

/** @var Models\MessageCollectionResponse $messages */
$messages = $graphClient->me()
    ->messages()
    ->get($config)
    ->wait();

# GET https://graph.microsoft.com/v1.0/users/{user-id}/messages?$select=subject,sender&
# $filter=<some condition>&orderBy=receivedDateTime

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"

# -Sort is equivalent to $orderby
# -Filter is equivalent to $filter
$messages = Get-MgUserMessage -UserId $userId -Property Subject,Sender `
-Sort ReceivedDateTime -Filter "some condition"

# GET https://graph.microsoft.com/v1.0/me/messages?
# $select=subject,sender&$filter=subject eq 'Hello world'

# msgraph.generated.users.item.messages.messages_request_builder
query_params = MessagesRequestBuilder.MessagesRequestBuilderGetQueryParameters(
    select=['subject', 'sender'],
    filter='subject eq \'Hello world\''
)

config = RequestConfiguration(
    query_parameters=query_params
)

messages = await graph_client.me.messages.get(config)

// GET https://graph.microsoft.com/v1.0/me/messages?
// $select=subject,sender&$filter=subject eq 'Hello world'
const messages = await graphClient
  .api('/me/messages')
  .select(['subject', 'sender'])
  .filter(`subject eq 'Hello world'`)
  .get();

Объект, возвращаемый при получении списка сущностей, скорее всего, будет страничной коллекцией. Дополнительные сведения о том, как получить полный список сущностей, см. в разделе Разбиение по страницам по коллекции.

Доступ к элементу коллекции

Для пакетов SDK, поддерживающих стиль fluent, доступ к коллекциям сущностей можно получить с помощью индекса массива. Для пакетов SDK на основе шаблонов достаточно внедрить идентификатор элемента в сегмент пути, следующий за коллекцией. В PowerShell идентификаторы передаются в качестве параметров.

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
var message = await graphClient.Me.Messages[messageId]
    .GetAsync();

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
result, _ := graphClient.Me().Messages().
    ByMessageId(messageId).Get(context.Background(), nil)

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
final Message message = graphClient.me().messages().byMessageId(messageId).get();

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
/** @var Models\Message $message */
$message = $graphClient->me()
    ->messages()
    ->byMessageId($messageId)
    ->get()
    ->wait();

# GET https://graph.microsoft.com/v1.0/users/{user-id}/messages/{message-id}

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"
$messageId = "AQMkAGUy.."

$message = Get-MgUserMessage -UserId $userId -MessageId $messageId

# GET https://graph.microsoft.com/v1.0/me/messages/{message-id}
# message_id is a string containing the id property of the message
message = await graph_client.me.messages.by_message_id(message_id).get()

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
const message = await graphClient.api(`/me/messages/${messageId}`).get();

Фильтр можно использовать для $expand запроса связанной сущности или коллекции сущностей в то же время, когда вы запрашиваете main сущность.

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$expand=attachments
// messageId is a string containing the id property of the message
var message = await graphClient.Me.Messages[messageId]
    .GetAsync(requestConfig =>
        requestConfig.QueryParameters.Expand =
            ["attachments"]);

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$expand=attachments

// import github.com/microsoftgraph/msgraph-sdk-go/users
expand := users.ItemMessagesMessageItemRequestBuilderGetQueryParameters{
    Expand: []string{"attachments"},
}

options := users.ItemMessagesMessageItemRequestBuilderGetRequestConfiguration{
    QueryParameters: &expand,
}
// messageId is a string containing the id property of the message
result, _ := graphClient.Me().Messages().
    ByMessageId(messageId).Get(context.Background(), &options)

// GET
// https://graph.microsoft.com/v1.0/me/messages/{message-id}?$expand=attachments
// messageId is a string containing the id property of the message
final Message message = graphClient.me().messages().byMessageId(messageId).get( requestConfiguration -> {
    requestConfiguration.queryParameters.expand = new String[] {"attachments"};
});

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$expand=attachments
// messageId is a string containing the id property of the message
// Microsoft\Graph\Generated\Users\Item\Messages\Item\MessageItemRequestBuilderGetQueryParameters
$query = new MessageItemRequestBuilderGetQueryParameters(
    expand: ['attachments']
);

// Microsoft\Graph\Generated\Users\Item\Messages\Item\MessageItemRequestBuilderGetRequestConfiguration
$config = new MessageItemRequestBuilderGetRequestConfiguration(
    queryParameters: $query);

/** @var Models\Message $message */
$message = $graphClient->me()
    ->messages()
    ->byMessageId($messageId)
    ->get($config)
    ->wait();

# GET https://graph.microsoft.com/v1.0/users/{user-id}/messages?$expand=attachments

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"
$messageId = "AQMkAGUy.."

# -ExpandProperty is equivalent to $expand
$message = Get-MgUserMessage -UserId $userId -MessageId $messageId -ExpandProperty Attachments

# GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$expand=attachments
# message_id is a string containing the id property of the message

# msgraph.generated.users.item.messages.item.message_item_request_builder
query_params = MessageItemRequestBuilder.MessageItemRequestBuilderGetQueryParameters(
    expand=['attachments']
)

config = RequestConfiguration(
    query_parameters=query_params
)

message = await graph_client.me.messages.by_message_id(message_id).get(config)

// GET https://graph.microsoft.com/v1.0/me/messages/{message-id}?$expand=attachments
// messageId is a string containing the id property of the message
const message = await graphClient
  .api(`/me/messages/${messageId}`)
  .expand('attachments')
  .get();

Удаление сущности

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

// DELETE https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
await graphClient.Me.Messages[messageId]
    .DeleteAsync();

// DELETE https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
err := graphClient.Me().Messages().
    ByMessageId(messageId).Delete(context.Background(), nil)

// DELETE https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
graphClient.me().messages().byMessageId(messageId).delete();

// DELETE https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
$graphClient->me()
    ->messages()
    ->byMessageId($messageId)
    ->delete()
    ->wait();

# DELETE https://graph.microsoft.com/v1.0/users/{user-id}/messages/{message-id}

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"
$messageId = "AQMkAGUy.."

Remove-MgUserMessage -UserId $userId -MessageId $messageId

# DELETE https://graph.microsoft.com/v1.0/me/messages/{message-id}
# message_id is a string containing the id property of the message
await graph_client.me.messages.by_message_id(message_id).delete()

// DELETE https://graph.microsoft.com/v1.0/me/messages/{message-id}
// messageId is a string containing the id property of the message
await graphClient.api(`/me/messages/${messageId}`).delete();

Создание сущности с помощью POST

Для пакетов SDK на основе свободного стиля и шаблонов новые элементы можно добавлять в коллекции с помощью POST метода . В PowerShell команда принимает параметры, New-* сопоставляемые с добавляемой сущностью. Созданная сущность возвращается из вызова.

// POST https://graph.microsoft.com/v1.0/me/calendars
var calendar = new Calendar
{
    Name = "Volunteer",
};

var newCalendar = await graphClient.Me.Calendars
    .PostAsync(calendar);

// POST https://graph.microsoft.com/v1.0/me/calendars

calendar := models.NewCalendar()
name := "Volunteer"
calendar.SetName(&name)

result, _ := graphClient.Me().Calendars().Post(context.Background(), calendar, nil)

// POST https://graph.microsoft.com/v1.0/me/calendars
final Calendar calendar = new Calendar();
calendar.setName("Volunteer");

final Calendar newCalendar = graphClient.me().calendars().post(calendar);

// POST https://graph.microsoft.com/v1.0/me/calendars
$calendar = new Models\Calendar();
$calendar->setName('Volunteer');

/** @var Models\Calendar $newCalendar */
$newCalendar = $graphClient->me()
    ->calendars()
    ->post($calendar)
    ->wait();

# POST https://graph.microsoft.com/v1.0/users/{user-id}/calendars

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"

New-MgUserCalendar -UserId $userId -Name "Volunteer"

# POST https://graph.microsoft.com/v1.0/me/calendars

# msgraph.generated.models.calendar
calendar = Calendar()
calendar.name = 'Volunteer'

new_calendar = await graph_client.me.calendars.post(calendar)

// POST https://graph.microsoft.com/v1.0/me/calendars
const calendar: Calendar = {
  name: 'Volunteer',
};

const newCalendar = await graphClient.api('/me/calendars').post(calendar);

Обновление существующей сущности с помощью PATCH

Большинство обновлений в Microsoft Graph выполняется с помощью PATCH метода, поэтому необходимо только включить свойства, которые требуется изменить, в передаваемый объект.

// PATCH https://graph.microsoft.com/v1.0/teams/{team-id}
var team = new Team
{
    FunSettings = new TeamFunSettings
    {
        AllowGiphy = true,
        GiphyContentRating = GiphyRatingType.Strict,
    },
};

// teamId is a string containing the id property of the team
await graphClient.Teams[teamId]
    .PatchAsync(team);

// PATCH https://graph.microsoft.com/v1.0/teams/{team-id}

funSettings := models.NewTeamFunSettings()
allowGiphy := true
funSettings.SetAllowGiphy(&allowGiphy)
giphyRating := models.STRICT_GIPHYRATINGTYPE
funSettings.SetGiphyContentRating(&giphyRating)

team := models.NewTeam()
team.SetFunSettings(funSettings)

graphClient.Teams().ByTeamId(teamId).Patch(context.Background(), team, nil)

// PATCH https://graph.microsoft.com/v1.0/teams/{team-id}
final Team team = new Team();
final TeamFunSettings funSettings = new TeamFunSettings();
funSettings.setAllowGiphy(true);
funSettings.setGiphyContentRating(GiphyRatingType.Strict);
team.setFunSettings(funSettings);

// teamId is a string containing the id property of the team
graphClient.teams().byTeamId(teamId).patch(team);

// PATCH https://graph.microsoft.com/v1.0/teams/{team-id}
$funSettings = new Models\TeamFunSettings();
$funSettings->setAllowGiphy(true);
$funSettings->setGiphyContentRating(
    new Models\GiphyRatingType(Models\GiphyRatingType::STRICT));

$team = new Models\Team();
$team->setFunSettings($funSettings);

// $teamId is a string containing the id property of the team
$graphClient->teams()
    ->byTeamId($teamId)
    ->patch($team);

# PATCH https://graph.microsoft.com/v1.0/teams/{team-id}

$teamId = "71766077-aacc-470a-be5e-ba47db3b2e88"

Update-MgTeam -TeamId $teamId -FunSettings @{ AllowGiphy = $true; GiphyContentRating = "strict" }

# PATCH https://graph.microsoft.com/v1.0/teams/{team-id}

# msgraph.generated.models.team_fun_settings.TeamFunSettings
fun_settings = TeamFunSettings()
fun_settings.allow_giphy = True
# msgraph.generated.models.giphy_rating_type
fun_settings.giphy_content_rating = GiphyRatingType.Strict

# msgraph.generated.models.team.Team
team = Team()
team.fun_settings = fun_settings

# team_id is a string containing the id property of the team
await graph_client.teams.by_team_id(team_id).patch(team)

// PATCH https://graph.microsoft.com/v1.0/teams/{team-id}
const team: Team = {
  funSettings: {
    allowGiphy: true,
    giphyContentRating: 'strict',
  },
};

// teamId is a string containing the id property of the team
await graphClient.api(`/teams/${teamId}`).update(team);

Использование заголовков HTTP для управления поведением запросов

Пользовательские заголовки можно вложить в запрос с помощью Headers коллекции. В PowerShell добавление заголовков возможно только с помощью Invoke-GraphRequest метода . В некоторых сценариях Microsoft Graph для настройки поведения запроса используются пользовательские заголовки.

// GET https://graph.microsoft.com/v1.0/me/events
var events = await graphClient.Me.Events
    .GetAsync(requestConfig =>
    {
        requestConfig.Headers.Add(
            "Prefer", @"outlook.timezone=""Pacific Standard Time""");
    });

// GET https://graph.microsoft.com/v1.0/me/events

// import abstractions "github.com/microsoft/kiota-abstractions-go"
headers := abstractions.NewRequestHeaders()
headers.Add("Prefer", "outlook.timezone=\"Pacific Standard Time\"")

// import github.com/microsoftgraph/msgraph-sdk-go/users
options := users.ItemEventsRequestBuilderGetRequestConfiguration{
    Headers: headers,
}

result, _ := graphClient.Me().Events().Get(context.Background(), &options)

// GET https://graph.microsoft.com/v1.0/me/events
final EventCollectionResponse events = graphClient.me().events().get( requestConfiguration -> {
    requestConfiguration.headers.add("Prefer", "outlook.timezone=\"Pacific Standard Time\"");
});

// GET https://graph.microsoft.com/v1.0/me/events
// Microsoft\Graph\Generated\Users\Item\Events\EventsRequestBuilderGetRequestConfiguration
$config = new EventsRequestBuilderGetRequestConfiguration(
    headers: ['Prefer' => 'outlook.timezone="Pacific Standard Time"']
);

/** @var Models\EventCollectionResponse $events */
$events = $graphClient->me()
    ->events()
    ->get($config)
    ->wait();

# GET https://graph.microsoft.com/v1.0/users/{user-id}/events

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"
$requestUri = "/v1.0/users/" + $userId + "/events"

$events = Invoke-GraphRequest -Method GET -Uri $requestUri `
-Headers @{ Prefer = "outlook.timezone=""Pacific Standard Time""" }

# GET https://graph.microsoft.com/v1.0/me/events

# msgraph.generated.users.item.events.events_request_builder
config = RequestConfiguration()
config.headers.add('Prefer', 'outlook.timezone="Pacific Standard Time"')

events = await graph_client.me.events.get(config)

// GET https://graph.microsoft.com/v1.0/me/events
const events = await graphClient
  .api('/me/events')
  .header('Prefer', 'outlook.timezone="Pacific Standard Time"')
  .get();

Предоставление настраиваемых параметров запроса

Для пакетов SDK, поддерживающих стиль fluent, можно указать пользовательские QueryParameters значения параметров запроса с помощью объекта . Для пакетов SDK на основе шаблонов параметры кодируются в формате URL-адреса и добавляются в URI запроса. Для PowerShell и Go определенные параметры запроса для заданного API предоставляются в качестве параметров для соответствующей команды.

// GET https://graph.microsoft.com/v1.0/me/calendarView?
// startDateTime=2023-06-14T00:00:00Z&endDateTime=2023-06-15T00:00:00Z
var events = await graphClient.Me.CalendarView
    .GetAsync(requestConfiguration =>
    {
        requestConfiguration.QueryParameters.StartDateTime =
            "2023-06-14T00:00:00Z";
        requestConfiguration.QueryParameters.EndDateTime =
            "2023-06-15T00:00:00Z";
    });

// GET https://graph.microsoft.com/v1.0/me/calendarView?
// startDateTime=2023-06-14T00:00:00Z&endDateTime=2023-06-15T00:00:00Z

startDateTime := "2023-06-14T00:00:00"
endDateTime := "2023-06-15T00:00:00Z"

// import github.com/microsoftgraph/msgraph-sdk-go/users
query := users.ItemCalendarViewRequestBuilderGetQueryParameters{
    StartDateTime: &startDateTime,
    EndDateTime:   &endDateTime,
}

options := users.ItemCalendarViewRequestBuilderGetRequestConfiguration{
    QueryParameters: &query,
}

result, _ := graphClient.Me().CalendarView().Get(context.Background(), &options)

// GET https://graph.microsoft.com/v1.0/me/calendarView?
// startDateTime=2023-06-14T00:00:00Z&endDateTime=2023-06-15T00:00:00Z
final EventCollectionResponse events = graphClient.me().calendarView().get( requestConfiguration -> {
    requestConfiguration.queryParameters.startDateTime = "2023-06-14T00:00:00Z";
    requestConfiguration.queryParameters.endDateTime = "2023-06-15T00:00:00Z";
});

// GET https://graph.microsoft.com/v1.0/me/calendarView?
// startDateTime=2023-06-14T00:00:00Z&endDateTime=2023-06-15T00:00:00Z
// Microsoft\Graph\Generated\Users\Item\CalendarView\CalendarViewRequestBuilderGetQueryParameters
$query = new CalendarViewRequestBuilderGetQueryParameters(
    startDateTime: '2023-06-14T00:00:00Z',
    endDateTime: '2023-06-15T00:00:00Z');

// Microsoft\Graph\Generated\Users\Item\CalendarView\CalendarViewRequestBuilderGetRequestConfiguration
$config = new CalendarViewRequestBuilderGetRequestConfiguration(
    queryParameters: $query);

/** @var Models\EventCollectionResponse $events */
$events = $graphClient->me()
    ->calendarView()
    ->get($config)
    ->wait();

# GET https://graph.microsoft.com/v1.0/users/{user-id}/calendars/{calendar-id}/calendarView

$userId = "71766077-aacc-470a-be5e-ba47db3b2e88"
$calendarId = "AQMkAGUy..."

$events = Get-MgUserCalendarView -UserId $userId -CalendarId $calendarId `
-StartDateTime "2020-08-31T00:00:00Z" -EndDateTime "2020-09-02T00:00:00Z"

# GET https://graph.microsoft.com/v1.0/me/calendarView?
# startDateTime=2023-06-14T00:00:00Z&endDateTime=2023-06-15T00:00:00Z

# msgraph.generated.users.item.calendar_view.calendar_view_request_builder
query_params = CalendarViewRequestBuilder.CalendarViewRequestBuilderGetQueryParameters(
    start_date_time='2023-06-14T00:00:00Z',
    end_date_time='2023-06-15T00:00:00Z'
)

config = RequestConfiguration(
    query_parameters=query_params
)

events = await graph_client.me.calendar_view.get(config)

// GET https://graph.microsoft.com/v1.0/me/calendarView?
// startDateTime=2023-06-14T00:00:00Z&endDateTime=2023-06-15T00:00:00Z
const events = await graphClient
  .api('me/calendar/calendarView')
  .query({
    startDateTime: '2023-06-14T00:00:00Z',
    endDateTime: '2023-06-15T00:00:00Z',
  })
  .get();