Partager ou déléguer un calendrier dans Outlook

Article
11/07/2024

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 :

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.

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.

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.

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


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



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



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


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


const options = {
	authProvider,
};

const client = Client.init(options);

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


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


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


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


Import-Module Microsoft.Graph.Beta.Calendar

Get-MgBetaUserCalendarPermission -UserId $userId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

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

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

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.

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

{
  "role": "write"
}


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



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



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


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


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


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

Snippet not available


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.calendar_permission import CalendarPermission
from msgraph_beta.generated.models.calendar_role_type import CalendarRoleType
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
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)

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

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


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



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



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


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


const options = {
	authProvider,
};

const client = Client.init(options);

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


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


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


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


Import-Module Microsoft.Graph.Beta.Calendar

Get-MgBetaUserDefaultCalendar -UserId $userId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

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

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

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.

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


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



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



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


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


const options = {
	authProvider,
};

const client = Client.init(options);

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


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


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


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


Import-Module Microsoft.Graph.Beta.Calendar

Get-MgBetaUserCalendar -UserId $userId -CalendarId $calendarId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

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

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.

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


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



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



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


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


const options = {
	authProvider,
};

const client = Client.init(options);

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


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


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


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


Import-Module Microsoft.Graph.Beta.Users

Get-MgBetaUserMailboxSetting -UserId $userId


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

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

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.

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

{
  "delegateMeetingMessageDeliveryOptions": "sendToDelegateAndPrincipal"
}


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



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



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


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


const options = {
	authProvider,
};

const client = Client.init(options);

const mailboxSettings = {
  delegateMeetingMessageDeliveryOptions: 'sendToDelegateAndPrincipal'
};

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


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


Import-Module Microsoft.Graph.Beta.Users

$params = @{
	delegateMeetingMessageDeliveryOptions = "sendToDelegateAndPrincipal"
}

Update-MgBetaUserMailboxSetting -UserId $userId -BodyParameter $params


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.mailbox_settings import MailboxSettings
from msgraph_beta.generated.models.delegate_meeting_message_delivery_options import DelegateMeetingMessageDeliveryOptions
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
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)

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

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


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



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



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


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


const options = {
	authProvider,
};

const client = Client.init(options);

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


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

Snippet not available


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

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

HTTP/1.1 204 No Content

Partager via

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

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

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é.

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

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

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

Commentaires

Ressources supplémentaires

Partager via

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

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

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

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é

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é.

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

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

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

Contenu connexe

Commentaires

Ressources supplémentaires