Effectuer des appels d’API à l’aide des Kits de développement logiciel (SDK) Microsoft Graph

Les bibliothèques de service du Kit de développement logiciel (SDK) Microsoft Graph fournissent une classe cliente à utiliser comme point de départ pour créer toutes les demandes d’API. Il existe deux styles de classe client : l’un utilise une interface Fluent pour créer la requête (par exemple, client.Users["user-id"].Manager) et l’autre accepte une chaîne de chemin d’accès (par exemple, api("/users/user-id/manager")). Lorsque vous avez un objet de requête, vous pouvez spécifier différentes options, telles que le filtrage et le tri, et enfin, vous sélectionnez le type d’opération que vous souhaitez effectuer.

Il existe également le Kit de développement logiciel (SDK) Microsoft Graph PowerShell, qui n’a pas de classe cliente. Au lieu de cela, toutes les requêtes sont représentées sous forme de commandes PowerShell. Par exemple, pour obtenir le responsable d’un utilisateur, la commande est Get-MgUserManager. Pour plus d’informations sur la recherche de commandes pour les appels d’API, consultez Navigation dans le Kit de développement logiciel (SDK) Microsoft Graph PowerShell.

Lire les informations de Microsoft Graph

Pour lire des informations à partir de Microsoft Graph, vous devez d’abord créer un objet de requête, puis exécuter la GET méthode sur la requête.

C#

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

Go

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

Java

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

PHP

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

PowerShell

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

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

$user = Get-MgUser -UserId $userId

Python

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

TypeScript

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

Utiliser $select pour contrôler les propriétés retournées

Lors de la récupération d’une entité, toutes les propriétés ne sont pas récupérées automatiquement ; parfois, ils doivent être explicitement sélectionnés. En outre, le renvoi du jeu de propriétés par défaut n’est pas nécessaire dans certains scénarios. Sélectionner uniquement les propriétés requises peut améliorer les performances de la requête. Vous pouvez personnaliser la demande pour inclure le $select paramètre de requête avec une liste de propriétés.

C#

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

Go

// 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)

Java

// 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"};
});

PHP

// 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();

PowerShell

# 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

Python

# 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)

TypeScript

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

Récupérer une liste d’entités

La récupération d’une liste d’entités est similaire à la récupération d’une seule entité, sauf qu’il existe d’autres options pour configurer la requête. Le $filter paramètre de requête peut réduire le jeu de résultats uniquement aux lignes qui correspondent à la condition fournie. Le $orderby paramètre de requête demande au serveur de fournir la liste des entités triées par les propriétés spécifiées.

Remarque

Certaines demandes de ressources Microsoft Entra nécessitent l’utilisation de fonctionnalités de requête avancées. Si vous obtenez une réponse indiquant une requête incorrecte, une requête non prise en charge ou une réponse qui inclut des résultats inattendus, y compris le paramètre de requête et ConsistencyLevel l’en-tête $count peut permettre à la requête de réussir. Pour plus d’informations et d’exemples, consultez Fonctionnalités de requête avancées sur les objets d’annuaire.

C#

// 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'";
    });

Go

// 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)

Java

// 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'";
});

PHP

// 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();

PowerShell

# 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"

Python

# 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)

TypeScript

// 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();

L’objet retourné lors de la récupération d’une liste d’entités sera probablement une collection paginée. Pour plus d’informations sur la façon d’obtenir la liste complète des entités, consultez Pagination dans une collection.

Accéder à un élément d’une collection

Pour les sdk qui prennent en charge un style Fluent, les collections d’entités sont accessibles à l’aide d’un index de tableau. Pour les sdk basés sur des modèles, il suffit d’incorporer l’identificateur d’élément dans le segment de chemin d’accès suivant la collection. Pour PowerShell, les identificateurs sont passés en tant que paramètres.

C#

// 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();

Go

// 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)

Java

// 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();

PHP

// 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();

PowerShell

# 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

Python

# 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()

TypeScript

// 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();

Utiliser $expand pour accéder aux entités associées

Vous pouvez utiliser le $expand filtre pour demander une entité ou une collection d’entités associées en même temps que vous demandez l’entité main.

C#

// 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"]);

Go

// 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)

Java

// 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"};
});

PHP

// 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();

PowerShell

# 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

Python

# 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)

TypeScript

// 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();

Supprimer une entité

Les demandes de suppression sont construites de la même façon que les demandes de récupération d’une entité, mais utilisez une DELETE requête au lieu d’un GET.

C#

// 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();

Go

// 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)

Java

// 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();

PHP

// 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();

PowerShell

# 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

Python

# 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()

TypeScript

// 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();

Création d’une entité avec POST

Pour les kits SDK fluent style et basés sur des modèles, de nouveaux éléments peuvent être ajoutés aux collections à l’aide d’une POST méthode . Pour PowerShell, une New-* commande accepte les paramètres qui sont mappés à l’entité à ajouter. L’entité créée est retournée à partir de l’appel.

C#

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

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

Go

// 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)

Java

// 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);

PHP

// 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();

PowerShell

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

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

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

Python

# 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)

TypeScript

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

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

Mise à jour d’une entité existante avec PATCH

La plupart des mises à jour dans Microsoft Graph sont effectuées à l’aide d’une PATCH méthode . Par conséquent, il est uniquement nécessaire d’inclure les propriétés que vous souhaitez modifier dans l’objet que vous passez.

C#

// 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);

Go

// 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)

Java

// 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);

PHP

// 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);

PowerShell

# 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" }

Python

# 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)

TypeScript

// 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);

Utiliser des en-têtes HTTP pour contrôler le comportement des requêtes

Vous pouvez attacher des en-têtes personnalisés à une requête à l’aide de la Headers collection . Pour PowerShell, l’ajout d’en-têtes n’est possible qu’avec la Invoke-GraphRequest méthode . Certains scénarios Microsoft Graph utilisent des en-têtes personnalisés pour ajuster le comportement de la requête.

C#

// 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""");
    });

Go

// 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)

Java

// 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\"");
});

PHP

// 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();

PowerShell

# 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""" }

Python

# 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)

TypeScript

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

Fournir des paramètres de requête personnalisés

Pour les sdk qui prennent en charge le style Fluent, vous pouvez fournir des valeurs de paramètres de requête personnalisées à l’aide de l’objet QueryParameters . Pour les sdk basés sur des modèles, les paramètres sont encodés dans une URL et ajoutés à l’URI de la requête. Pour PowerShell et Go, les paramètres de requête définis pour une API donnée sont exposés en tant que paramètres à la commande correspondante.

C#

// 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";
    });

Go

// 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)

Java

// 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";
});

PHP

// 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();

PowerShell

# 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"

Python

# 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)

TypeScript

// 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();