Partager ou déléguer un calendrier dans Outlook

Dans Outlook, un propriétaire de calendrier peut partager le calendrier avec un autre utilisateur. Le propriétaire peut spécifier les informations dans les événements non privés qui peuvent être consultés et peut accorder l’accès en écriture au calendrier aux utilisateurs au sein de la même organisation.

Le propriétaire peut également déléguer un autre utilisateur pour gérer les réunions dans le calendrier principal. Les délégués sont des destinataires de partage qui peuvent afficher toutes les informations dans et avoir un accès en écriture à des événements non privés. Ils reçoivent également les demandes de réunion et les réponses, et répondent aux demandes de réunion au nom du propriétaire. De plus, le propriétaire peut accorder des autorisations explicites aux délégués pour afficher les événements privés du propriétaire dans le calendrier.

Avant que le partage ou la délégation de calendrier puisse prendre effet, le propriétaire envoie un destinataire de partage ou délègue une invitation, et le destinataire ou délégué du partage accepte l’invitation, ou ajoute explicitement le calendrier partagé ou délégué pour l’accès. L’invitation et l’ajout d’un calendrier partagé ou délégué se produisent dans un client Outlook.

Une fois le partage ou la délégation configuré dans Outlook, les applications peuvent utiliser l’API Microsoft Graph pour gérer le partage et la délégation.

Le reste de cet article est basé sur le scénario d’exemple suivant :

• Alex Charron a délégué Aline Dupuy à son calendrier principal, et j’ai également autorisé Aline à afficher les événements privés dans ce calendrier.
• Alain a partagé un calendrier « Fêtes d’enfants » avec Adele Vance et Aline Dupuy, et a octroyé Aline et Megan read les autorisations à tous les détails des événements non privés sur le calendrier « Fêtes d’enfants » et le statut de disponibilité pour les événements privés.

Cet article décrit l’exécution des tâches suivantes à l’aide d’un calendrier partagé ou délégué :

• Obtenir des informations de calendrier sur les destinataires de partage, les délégués et les autorisations autorisées, et mettre à jour les autorisations individuelles
• Accédez aux propriétés qui décrivent le partage ou la délégation du calendrier.
• Obtenez ou définissez les paramètres de boîte aux lettres pour recevoir des demandes de réunion et des réponses pour un calendrier délégué.
• Supprimer un destinataire de partage ou un délégué d’un calendrier.

Les applications peuvent également effectuer les opérations suivantes à l’aide de l’API généralement disponible :

• Obtenir un calendrier ou des événements Outlook partagés ou délégués
• Créer des événements Outlook dans un calendrier partagé ou délégué

Remarque

Les propriétés et API de partage et de délégation de calendrier décrites dans cette rubrique sont actuellement disponibles dans le point de terminaison v1.0, à l’exception des propriétés de calendrier isShared et isSharedWithMe. Ces deux propriétés sont exposées uniquement dans le point de terminaison bêta.

Obtenir des informations de calendrier sur les destinataires et les délégués de partage, et mettre à jour les autorisations individuelles

Dans cette section :

• Propriétaire du calendrier : obtenir des informations et des autorisations de partage ou de délégation
• Propriétaire du calendrier : mettre à jour les autorisations d’un destinataire ou d’un délégué de partage existant sur un calendrier

Chaque calendrier est associé à une collection d’objets calendarPermission , chacun d’eux décrivant un destinataire ou délégué de partage et l’autorisation associée que le propriétaire du calendrier a configurée. L’énumération calendierRôleType définit la plage d’autorisations prises en charge par Microsoft Graph :

• none Cette valeur s’applique uniquement My Organization à qui n’a pas d’autorisations sur le calendrier. Il ne s’applique pas à des utilisateurs individuels, car seuls les utilisateurs dotés d’autorisations sont associés à un objet calendrierPermission pour le calendrier.
• freeBusyReadLe destinataire du partage peut afficher les status de disponibilité du propriétaire, mais pas d’autres détails sur le calendrier.
• limitedReadLe destinataire du partage peut afficher les status de disponibilité du propriétaire, ainsi que les titres et les emplacements des événements non privés dans le calendrier.
• readLe destinataire du partage peut afficher les status de disponibilité du propriétaire dans les événements privés, ainsi que tous les détails des événements non privés dans le calendrier.
• writeLe destinataire du partage peut afficher les status de disponibilité du propriétaire dans les événements privés, et peut afficher tous les détails et modifier (créer, mettre à jour ou supprimer) les événements non privés sur le calendrier.
• delegateWithoutPrivateEventAccess Le délégué peut afficher l’état de la disponibilité du propriétaire dans les événements privés et a accès write aux événements non privés dans le calendrier.
• delegateWithPrivateEventAccess Ledélégué peut afficher les détails des événements privés et non privés du propriétaire, et a accès write à tous les événements du calendrier.

Le calendrier principal d’un utilisateur est toujours partagé avec « mon organisation », qui représente les utilisateurs de la même organisation que le propriétaire. Par défaut, ils peuvent lire l’état de disponibilité du propriétaire sur ce calendrier et disposer de l’autorisation freeBusyRead.

Propriétaire du calendrier : obtenir des informations et des autorisations de partage ou de délégation

L’exemple s’affiche avec le consentement d’Alain ou d’un administrateur, comment obtenir les objets calendarPermission associés au calendrier principal d’Alain. La requête renvoie deux objets d’autorisation :

• Le premier objet calendrierPermission est affectée au délégué, Aline et contient les valeurs de propriété suivantes :

  • peutêtreSupprimé a la valeur vrai, ce qui permet à Alain d’annuler la délégation.
  • estàl’Interieurdel’Organization est vrai, car seuls les utilisateurs au sein d’une même organisation peuvent être délégués.
  • le rôle pour Aline est delegateWithPrivateEventAccess, comme l’a été configuré par Alex.
  • lesRolespermisinclut les types de rôles delegateWithoutPrivateEventAccess et delegateWithPrivateEventAccess qui prennent en charge la délégation.
  • l’adresseEmail spécifie Aline.

• Le deuxième objet calendrierPermission est un objet par défaut affecté à « mon organisation » et contient les valeurs de propriété suivantes :

  • peutÊtreSupprimé est paramétré sur false, dans la mesure où le calendrier principal est toujours partagé avec l’organisation du propriétaire.
  • estàl’Interieurdel’Organisation est true.
  • le Rôle est freeBusyRead, soit le paramètre par défaut « mon organisation ».
  • l’adresseEmail spécifie le nom sous-propriété sous la forme « mon organisation ». adresse pour « mon organisation » est null par défaut.

Autorisations Microsoft Graph

Utiliser les autorisations déléguées ou d'application les moins privilégiées, Calendars.Read, le cas échéant, pour cette opération. Pour plus d’informations, reportez-vous à la rubrique Autorisations de calendrier.

HTTP

GET https://graph.microsoft.com/beta/users/AlexW@contoso.com/calendar/calendarPermissions

C#

// 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.Users["{user-id}"].Calendar.CalendarPermissions.GetAsync();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc-beta users calendar calendar-permissions list --user-id {user-id}

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
calendarPermissions, err := graphClient.Users().ByUserId("user-id").Calendar().CalendarPermissions().Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

CalendarPermissionCollectionResponse result = graphClient.users().byUserId("{user-id}").calendar().calendarPermissions().get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let calendarPermissions = await client.api('/users/AlexW@contoso.com/calendar/calendarPermissions')
	.version('beta')
	.get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


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


$result = $graphServiceClient->users()->byUserId('user-id')->calendar()->calendarPermissions()->get()->wait();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Beta.Calendar

Get-MgBetaUserCalendarPermission -UserId $userId

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

from msgraph_beta import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.users.by_user_id('user-id').calendar.calendar_permissions.get()

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('64339082-ed84-4b0b-b4ab-004ae54f3747')/calendar/calendarPermissions",
    "value": [
        {
            "id": "L289RXhjaGFuZ2VMYWJTWVnYW5C",
            "isRemovable": true,
            "isInsideOrganization": true,
            "role": "delegateWithPrivateEventAccess",
            "allowedRoles": [
                "freeBusyRead",
                "limitedRead",
                "read",
                "write",
                "delegateWithoutPrivateEventAccess",
                "delegateWithPrivateEventAccess"
            ],
            "emailAddress": {
                "name": "Megan Bowen",
                "address": "MeganB@contoso.com"
            }
        },
        {
            "id": "RGVmYXVsdA==",
            "isRemovable": false,
            "isInsideOrganization": true,
            "role": "freeBusyRead",
            "allowedRoles": [
                "none",
                "freeBusyRead",
                "limitedRead",
                "read",
                "write"
            ],
            "emailAddress": {
                "name": "My Organization"
            }
        }
    ]
}

Propriétaire du calendrier : mettre à jour les autorisations d’un destinataire ou d’un délégué de partage existant sur un calendrier

Avec le consentement d’Alex ou de l’administrateur, vous pouvez mettre à jour les autorisations affectées à un destinataire ou délégué de partage existant (spécifié par la propriété de rôle ), à condition que les nouvelles autorisations soient prises en charge par les rôles autorisés initialement configurés pour le destinataire ou délégué du partage pour ce calendrier.

En dehors de la propriété de rôle , vous ne pouvez pas mettre à jour les autres propriétés d’un destinataire ou d’un délégué de partage existant. La modification de la valeur de la propriété emailAddress nécessite la suppression du destinataire ou du délégué du partage et la configuration d’une nouvelle instance de calendarPermission.

L’exemple de cette section met à jour la propriété de rôle , en modifiant l’autorisation d’un destinataire de partage existant, Adele, de read à write pour le calendrier personnalisé « Fêtes enfants ».

Autorisations Microsoft Graph

Utiliser les autorisations déléguées ou d'application les moins privilégiées, Calendars.ReadWrite, le cas échéant, pour cette opération. Pour plus d’informations, reportez-vous à la rubrique Autorisations de calendrier.

HTTP

PATCH https://graph.microsoft.com/beta/users/AlexW@contoso.com/calendars/AAMkADAwAABf02bAAAA=/calendarPermissions/L289RXhjaGFuZ2VMYWJQWRlbGVW
Content-type: application/json

{
  "role": "write"
}

C#

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

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new CalendarPermission
{
	Role = CalendarRoleType.Write,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Users["{user-id}"].Calendars["{calendar-id}"].CalendarPermissions["{calendarPermission-id}"].PatchAsync(requestBody);

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc-beta users calendars calendar-permissions patch --user-id {user-id} --calendar-id {calendar-id} --calendar-permission-id {calendarPermission-id} --body '{\
  "role": "write"\
}\
'

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// 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.NewCalendarPermission()
role := graphmodels.WRITE_CALENDARROLETYPE 
requestBody.SetRole(&role) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
calendarPermissions, err := graphClient.Users().ByUserId("user-id").Calendars().ByCalendarId("calendar-id").CalendarPermissions().ByCalendarPermissionId("calendarPermission-id").Patch(context.Background(), requestBody, nil)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

CalendarPermission calendarPermission = new CalendarPermission();
calendarPermission.setRole(CalendarRoleType.Write);
CalendarPermission result = graphClient.users().byUserId("{user-id}").calendars().byCalendarId("{calendar-id}").calendarPermissions().byCalendarPermissionId("{calendarPermission-id}").patch(calendarPermission);

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const calendarPermission = {
  role: 'write'
};

await client.api('/users/AlexW@contoso.com/calendars/AAMkADAwAABf02bAAAA=/calendarPermissions/L289RXhjaGFuZ2VMYWJQWRlbGVW')
	.version('beta')
	.update(calendarPermission);

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\CalendarPermission;
use Microsoft\Graph\Beta\Generated\Models\CalendarRoleType;


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

$requestBody = new CalendarPermission();
$requestBody->setRole(new CalendarRoleType('write'));

$result = $graphServiceClient->users()->byUserId('user-id')->calendars()->byCalendarId('calendar-id')->calendarPermissions()->byCalendarPermissionId('calendarPermission-id')->patch($requestBody)->wait();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Snippet not available

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.calendar_permission import CalendarPermission
from msgraph_beta.generated.models.calendar_role_type import CalendarRoleType

graph_client = GraphServiceClient(credentials, scopes)

request_body = CalendarPermission(
	role = CalendarRoleType.Write,
)

result = await graph_client.users.by_user_id('user-id').calendars.by_calendar_id('calendar-id').calendar_permissions.by_calendar_permission_id('calendarPermission-id').patch(request_body)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('64339082-ed84-4b0b-b4ab-004ae54f3747')/calendars('AAMkADAwAABf02bAAAA%3D')/calendarPermissions/$entity",
    "id": "L289RXhjaGFuZ2VMYWJQWRlbGVW",
    "isRemovable": true,
    "isInsideOrganization": true,
    "role": "write",
    "allowedRoles": [
        "freeBusyRead",
        "limitedRead",
        "read",
        "write"
    ],
    "emailAddress": {
        "name": "Adele Vance",
        "address": "AdeleV@contoso.com"
    }
}

Obtenir les propriétés d’un calendrier partagé ou délégué

Dans cette section :

• Propriétaire du calendrier: Obtenir les propriétés d’un calendrier partagé ou délégué
• partager un destinataire ou un délégué : obtenir les propriétés du calendrier partagé ou délégué

Rappeler vous de l’exemple, Alex a délégué son calendrier principal et a donné les permissions de voire les détails privés de son calendrier à Megan Bowen. Cette section présente les propriétés du calendrier délégué, dans la perspective de et avec le consentement du propriétaire, Alex, puis de la perspective de et avec le consentement du délégué, Aline. L’accord de l’administrateur fonctionne également pour chaque cas.

Propriétaire du calendrier: Obtenir les propriétés d’un calendrier partagé ou délégué

L’exemple dans cette section récupère les propriétés du calendrier principal de la perspective du propriétaire, Alex.

Notez les propriétés suivantes pour Alain :

• peutPartager est vrai alors qu’Alex est le propriétaire.
• peutVoirObjetsPrivés est vrai car Alex est le propriétaire.
• estPartagé est vrai, tandis qu’Alex a configuré un délégué pour ce calendrier.
• estPartagéAvecMoiest toujours fausse pour le propriétaire du calendrier.
• propriétaire affiche Alain en tant que propriétaire.

Autorisations Microsoft Graph

Utiliser les autorisations déléguées ou d'application les moins privilégiées, Calendars.Read, le cas échéant, pour cette opération. Pour plus d’informations, reportez-vous à la rubrique Autorisations de calendrier.

HTTP

GET https://graph.microsoft.com/beta/users/AlexW@contoso.com/calendar

C#

// 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.Users["{user-id}"].Calendar.GetAsync();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc-beta users calendar get --user-id {user-id}

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
calendar, err := graphClient.Users().ByUserId("user-id").Calendar().Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Calendar result = graphClient.users().byUserId("{user-id}").calendar().get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let calendar = await client.api('/users/AlexW@contoso.com/calendar')
	.version('beta')
	.get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


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


$result = $graphServiceClient->users()->byUserId('user-id')->calendar()->get()->wait();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Beta.Calendar

Get-MgBetaUserDefaultCalendar -UserId $userId

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

from msgraph_beta import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.users.by_user_id('user-id').calendar.get()

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('64339082-ed84-4b0b-b4ab-004ae54f3747')/calendar/$entity",
    "id": "AQMkADAw7QAAAJfygAAAA==",
    "name": "Calendar",
    "color": "auto",
    "hexColor": "",
    "changeKey": "NEXywgsVrkeNsFsyVyRrtAAAAAACOg==",
    "canShare": true,
    "canViewPrivateItems": true,
    "isShared": true,
    "isSharedWithMe": false,
    "canEdit": true,
    "allowedOnlineMeetingProviders": [
        "teamsForBusiness"
    ],
    "defaultOnlineMeetingProvider": "teamsForBusiness",
    "isTallyingResponses": true,
    "isRemovable": false,
    "owner": {
        "name": "Alex Wilber",
        "address": "AlexW@contoso.com"
    }
}

Partager un destinataire ou un délégué : obtenir les propriétés du calendrier partagé ou délégué

L’exemple dans cette section récupère les propriétés du même calendrier de la perspective de la déléguée, Megan.

Notez les propriétés suivantes :

• nom du calendrier est le nom d’affichage par défaut du propriétaire. Dans le cas présent, il s’agit de « Alex Wilber », car il s’agit du calendrier d’Alex délégué à Aline.
• peutPartager est faux , car Aline n’est pas le propriétaire de ce calendrier.
• peutVoirObjetsPrivés est vrai pour la déléguée Aline, comme configuré par Alain. Pour un partage qui n’est pas un délégué, cette propriété est toujours false.
• estPartagé est faux. Cette propriété indique uniquement à un propriétaire de calendrier que le calendrier a été partagé ou délégué.
• estPartagéAvecMoi propriété a la valeur vrai, car Aline est délégué.
• peutPartager est vrai, car les délégués, y compris Aline, ont accès en écriture.
• le propriétaireest paramétré sur Alain.

Remarque

Un partage ou délégué peut personnaliser uniquement le nom de propriété d’un calendrier partagé/délégué. La mise à jour n’est visible que pour elle-même. le propriétaire du calendrier ne voit pas ces modifications de nom de calendrier.

Autorisations Microsoft Graph

Utiliser les autorisations déléguées Calendars.Read.Shared, ou les autorisations d'application Calendars.Read les moins privilégiées, , le cas échéant, pour cette opération. Pour plus d’informations, reportez-vous à la rubrique Autorisations de calendrier.

HTTP

GET https://graph.microsoft.com/beta/users/meganb@contoso.com/calendars/AAMkADlAABhbftjAAA=

C#

// 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.Users["{user-id}"].Calendars["{calendar-id}"].GetAsync();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc-beta users calendars get --user-id {user-id} --calendar-id {calendar-id}

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
calendars, err := graphClient.Users().ByUserId("user-id").Calendars().ByCalendarId("calendar-id").Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Calendar result = graphClient.users().byUserId("{user-id}").calendars().byCalendarId("{calendar-id}").get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let calendar = await client.api('/users/meganb@contoso.com/calendars/AAMkADlAABhbftjAAA=')
	.version('beta')
	.get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


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


$result = $graphServiceClient->users()->byUserId('user-id')->calendars()->byCalendarId('calendar-id')->get()->wait();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Beta.Calendar

Get-MgBetaUserCalendar -UserId $userId -CalendarId $calendarId

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

from msgraph_beta import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.users.by_user_id('user-id').calendars.by_calendar_id('calendar-id').get()

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('meganb%40contoso.com')/calendars/$entity",
    "id": "AAMkADlAABhbftjAAA=",
    "name": "Alex Wilber",
    "color": "auto",
    "hexColor": "",
    "changeKey": "E6LznKWmX0KTsAD9qRJjeAAAYWo3EQ==",
    "canShare": false,
    "canViewPrivateItems": true,
    "isShared": false,
    "isSharedWithMe": true,
    "canEdit": true,
    "allowedOnlineMeetingProviders": [
        "teamsForBusiness"
    ],
    "defaultOnlineMeetingProvider": "teamsForBusiness",
    "isTallyingResponses": true,
    "isRemovable": true,
    "owner": {
        "name": "Alex Wilber",
        "address": "AlexW@contoso.com"
    }
}

Obtenez ou définissez les paramètres de boîte aux lettres pour recevoir des demandes de réunion et des réponses pour un calendrier délégué.

Dans cette section :

• Obtenir les paramètres de distribution de la boîte aux lettres d’un utilisateur
• Configurer les paramètres de distribution de la boîte aux lettres d’un utilisateur

Selon le niveau de délégation qu’un propriétaire de calendrier préfère, le propriétaire peut spécifier qui doit recevoir des demandes de réunion et des réponses pour gérer les réunions dans le calendrier.

Par programme, vous pouvez obtenir ou définir la OptionsD’envoiDeMessagedeRéunionDélégué propriété du calendrier du propriétaire boîtederéceptionParamètres pour spécifier la personne à laquelle Outlook doit se contenter d' évènementsdemandedemessage et évènementRéponsedeMessage instances :

• sendToDelegateOnly

  Outlook pour diriger évènementsdemandedemessage etévènementRéponsedeMessage instances aux délégués uniquement. Il s’agit du paramètre par défaut. Le propriétaire peut consulter les réponses à une réunion ou répondre à une invitation via l’événement correspondant dans le calendrier délégué.

• sendToDelegateAndInformationToPrincipal

  Outlook pour diriger évènementsdemandedemessage etévènementRéponsedeMessage instances aux délégués uniquement et le propriétaire du calendrier. Seuls vos délégués voient l’option permettant d’accepter ou de refuser une demande de réunion. Et, la notification qui vous est envoyée s’affiche comme un courrier électronique normal. Vous pouvez toujours répondre à la réunion en ouvrantl’événementdu calendrier et en y répondant.

• sendToDelegateAndPrincipal

  Outlook pour diriger évènementsdemandedemessage etévènementRéponsedeMessage instances aux délégués et au propriétaire du calendrier, pouvant tous les deux répondre aux demande de réunion.

Il s’agit d’un paramètre à l’échelle de la boîte aux lettres, de sorte que le même paramètre s’applique à tous les délégués du propriétaire de la boîte aux lettres.

Obtenir les paramètres de distribution de la boîte aux lettres d’un utilisateur

L’exemple dans cette section récupère les Parametresdeboitederéception d’un propriétaire de calendrier qui permet aux demandes de réunion Outlook et aux réponses de réunion directe aux délégués de calendrier. autrement dit, déléguéRéunionMessageEnvoiOptions est paramétré sur sendToDelegateOnly.

Autorisations Microsoft Graph

Utiliser les autorisations déléguées ou d'application les moins privilégiées, MailboxSettings.Read, le cas échéant, pour cette opération. Pour plus d'informations sur les autorisations de boîte aux lettres, consultez la rubrique autorisations de courrier.

HTTP

GET https://graph.microsoft.com/beta/users/AlexW@contoso.com/mailboxsettings

C#

// 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.Users["{user-id}"].MailboxSettings.GetAsync();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc-beta users mailbox-settings get --user-id {user-id}

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
mailboxSettings, err := graphClient.Users().ByUserId("user-id").MailboxSettings().Get(context.Background(), nil)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

MailboxSettings result = graphClient.users().byUserId("{user-id}").mailboxSettings().get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

let mailboxSettings = await client.api('/users/AlexW@contoso.com/mailboxsettings')
	.version('beta')
	.get();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


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


$result = $graphServiceClient->users()->byUserId('user-id')->mailboxSettings()->get()->wait();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Beta.Users

Get-MgBetaUserMailboxSetting -UserId $userId

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

from msgraph_beta import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.users.by_user_id('user-id').mailbox_settings.get()

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('64339082-ed84-4b0b-b4ab-004ae54f3747')/mailboxSettings",
    "archiveFolder": "AQMkADAwAGVQAAAKfowAAAA==",
    "timeZone": "Pacific Standard Time",
    "delegateMeetingMessageDeliveryOptions": "sendToDelegateOnly",
    "dateFormat": "M/d/yyyy",
    "timeFormat": "h:mm tt",
    "automaticRepliesSetting": {
        "status": "disabled",
        "externalAudience": "all",
        "internalReplyMessage": "",
        "externalReplyMessage": "",
        "scheduledStartDateTime": {
            "dateTime": "2019-12-24T05:00:00.0000000",
            "timeZone": "UTC"
        },
        "scheduledEndDateTime": {
            "dateTime": "2019-12-25T05:00:00.0000000",
            "timeZone": "UTC"
        }
    },
    "language": {
        "locale": "en-US",
        "displayName": "English (United States)"
    },
    "workingHours": {
        "daysOfWeek": [
            "monday",
            "tuesday",
            "wednesday",
            "thursday",
            "friday"
        ],
        "startTime": "08:00:00.0000000",
        "endTime": "17:00:00.0000000",
        "timeZone": {
            "name": "Pacific Standard Time"
        }
    }
}

Définir le paramètre de distribution de la boîte aux lettres d’un utilisateur

L’exemple dans cette section met à jour la propriété déléguéRéunionMessageEnvoiOptions sur sendToDelegateAndPrincipal, pour demander aux demandes de réunion Outlook directes et aux réponses du calendrier délégué à tous les délégués et au propriétaire.

Autorisations Microsoft Graph

Utiliser les autorisations déléguées ou d'application les moins privilégiées, MailboxSettings.ReadWrite, le cas échéant, pour cette opération. Pour plus d'informations sur les autorisations de boîte aux lettres, consultez la rubrique autorisations de courrier.

HTTP

PATCH https://graph.microsoft.com/beta/users/AlexW@contoso.com/mailboxsettings
Content-type: application/json

{
  "delegateMeetingMessageDeliveryOptions": "sendToDelegateAndPrincipal"
}

C#

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

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new MailboxSettings
{
	DelegateMeetingMessageDeliveryOptions = DelegateMeetingMessageDeliveryOptions.SendToDelegateAndPrincipal,
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Users["{user-id}"].MailboxSettings.PatchAsync(requestBody);

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc-beta users mailbox-settings patch --user-id {user-id} --body '{\
  "delegateMeetingMessageDeliveryOptions": "sendToDelegateAndPrincipal"\
}\
'

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// 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.NewMailboxSettings()
delegateMeetingMessageDeliveryOptions := graphmodels.SENDTODELEGATEANDPRINCIPAL_DELEGATEMEETINGMESSAGEDELIVERYOPTIONS 
requestBody.SetDelegateMeetingMessageDeliveryOptions(&delegateMeetingMessageDeliveryOptions) 

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
mailboxSettings, err := graphClient.Users().ByUserId("user-id").MailboxSettings().Patch(context.Background(), requestBody, nil)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

MailboxSettings mailboxSettings = new MailboxSettings();
mailboxSettings.setDelegateMeetingMessageDeliveryOptions(DelegateMeetingMessageDeliveryOptions.SendToDelegateAndPrincipal);
MailboxSettings result = graphClient.users().byUserId("{user-id}").mailboxSettings().patch(mailboxSettings);

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const mailboxSettings = {
  delegateMeetingMessageDeliveryOptions: 'sendToDelegateAndPrincipal'
};

await client.api('/users/AlexW@contoso.com/mailboxsettings')
	.version('beta')
	.update(mailboxSettings);

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\MailboxSettings;
use Microsoft\Graph\Beta\Generated\Models\DelegateMeetingMessageDeliveryOptions;


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

$requestBody = new MailboxSettings();
$requestBody->setDelegateMeetingMessageDeliveryOptions(new DelegateMeetingMessageDeliveryOptions('sendToDelegateAndPrincipal'));

$result = $graphServiceClient->users()->byUserId('user-id')->mailboxSettings()->patch($requestBody)->wait();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Import-Module Microsoft.Graph.Beta.Users

$params = @{
	delegateMeetingMessageDeliveryOptions = "sendToDelegateAndPrincipal"
}

Update-MgBetaUserMailboxSetting -UserId $userId -BodyParameter $params

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.mailbox_settings import MailboxSettings
from msgraph_beta.generated.models.delegate_meeting_message_delivery_options import DelegateMeetingMessageDeliveryOptions

graph_client = GraphServiceClient(credentials, scopes)

request_body = MailboxSettings(
	delegate_meeting_message_delivery_options = DelegateMeetingMessageDeliveryOptions.SendToDelegateAndPrincipal,
)

result = await graph_client.users.by_user_id('user-id').mailbox_settings.patch(request_body)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('64339082-ed84-4b0b-b4ab-004ae54f3747')/mailboxSettings",
    "delegateMeetingMessageDeliveryOptions": "sendToDelegateAndPrincipal"
}

Supprimer un partage ou un délégué d’un calendrier

Dans l’exemple ci-dessous, Alex supprime Aline comme un partage du calendrier « fête d’enfants ».

Autorisations Microsoft Graph

Utiliser les autorisations déléguées ou d'application les moins privilégiées, Calendars.ReadWrite, le cas échéant, pour cette opération. Pour plus d’informations, reportez-vous à la rubrique Autorisations de calendrier.

HTTP

DELETE https://graph.microsoft.com/beta/users/AlexW@contoso.com/calendars/AAMkADAwAABf02bAAAA=/calendarPermissions/L289RXhjaGFuZ2VMYWJTWVnYW5C

C#

// 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
await graphClient.Users["{user-id}"].Calendars["{calendar-id}"].CalendarPermissions["{calendarPermission-id}"].DeleteAsync();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

CLI

mgc-beta users calendars calendar-permissions delete --user-id {user-id} --calendar-id {calendar-id} --calendar-permission-id {calendarPermission-id}

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Go

// 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"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Users().ByUserId("user-id").Calendars().ByCalendarId("calendar-id").CalendarPermissions().ByCalendarPermissionId("calendarPermission-id").Delete(context.Background(), nil)

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.users().byUserId("{user-id}").calendars().byCalendarId("{calendar-id}").calendarPermissions().byCalendarPermissionId("{calendarPermission-id}").delete();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/users/AlexW@contoso.com/calendars/AAMkADAwAABf02bAAAA=/calendarPermissions/L289RXhjaGFuZ2VMYWJTWVnYW5C')
	.version('beta')
	.delete();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


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


$graphServiceClient->users()->byUserId('user-id')->calendars()->byCalendarId('calendar-id')->calendarPermissions()->byCalendarPermissionId('calendarPermission-id')->delete()->wait();

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

PowerShell

Snippet not available

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

Python

from msgraph_beta import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


await graph_client.users.by_user_id('user-id').calendars.by_calendar_id('calendar-id').calendar_permissions.by_calendar_permission_id('calendarPermission-id').delete()

Pour plus d’informations sur l’ajout du SDK à votre projet et la création d’un instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).

HTTP/1.1 204 No Content

Contenu connexe

• Partager un calendrier Outlook avec d’autres personnes
• Autoriser une autre personne à gérer votre courrier électronique et votre calendrier en tant que délégué
• Partager votre calendrier dans Outlook sur le web
• Délégation de calendrier dans Outlook sur le web
• Obtenir des événements Outlook dans un calendrier partagé ou délégué
• Créer des événements Outlook dans un calendrier partagé ou délégué