Compartir o delegar un calendario en Outlook

Artículo
10/07/2023

En Outlook, el propietario del calendario puede compartir el calendario con otro usuario. El propietario puede especificar qué información de los eventos no privados es visible y puede dar acceso de escritura al calendario a usuarios de la misma organización.

El propietario también puede delegar a otro usuario que administre las reuniones en el calendario principal del propietario. Los delegados son destinatarios compartidos que pueden ver toda la información en y tener acceso de escritura a eventos no privados. También reciben convocatorias de reunión y respuestas, y responden a convocatorias de reunión en nombre del propietario. Además, el propietario puede conceder permisos explícitos a los delegados para ver los eventos privados del propietario en el calendario.

Antes de que el uso compartido del calendario o la delegación puedan surtir efecto, el propietario envía un destinatario o delegado del recurso compartido a una invitación y el destinatario o delegado del recurso compartido acepta la invitación, o bien agrega explícitamente el calendario compartido o delegado para el acceso. La invitación y el agregado de un calendario compartido o delegado se producen en un cliente de Outlook.

Después de configurar el uso compartido o la delegación en Outlook, las aplicaciones pueden usar la API de Microsoft Graph para administrar el uso compartido y la delegación.

El resto de este artículo se basa en el escenario de ejemplo siguiente:

Sergio Valladares ha delegado a Nuria Acevedo su calendario principal, y también permitió a Nuria ver eventos privados en ese calendario.
Sergio ha compartido un calendario de "Fiesta infantil" con Isabel Robledo y Nuria Acevedo, y ha dado a Isabel y Nuria permisos de read para todos los detalles de los eventos no privados en el calendario de "Fiesta infantil", y el estado de disponibilidad de los eventos privados.

En este artículo se describe cómo se llevan a cabo las siguientes tareas mediante programación con un calendario compartido o delegado:

Obtener información de calendario sobre los destinatarios del recurso compartido, los delegados y los permisos permitidos, y actualizar permisos individuales
Obtener las propiedades que describen el uso compartido o la delegación de del calendario.
Obtener o establecer la configuración de buzón para recibir convocatorias de reunión y respuestas de un calendario delegado
Eliminar un destinatario o delegado de recurso compartido de un calendario.

Las aplicaciones también pueden hacer lo siguiente con la API que por lo general está disponible:

Nota:

Las propiedades y la API para compartir y delegar calendarios como se describe en este tema están disponibles actualmente en el punto de conexión v1.0, con la excepción de las propiedades de calendario esCompartido y esSharedWithMe. Estas dos propiedades se exponen solo en el punto de conexión beta.

En esta sección:

Propietario del calendario: obtener información y permisos de uso compartido o delegación
Propietario del calendario: actualizar los permisos de un destinatario o delegado de recurso compartido existente en un calendario

Cada calendario está asociado a una colección de objetos calendarPermission , cada uno de los cuales describe un destinatario o delegado del recurso compartido y el permiso asociado que el propietario del calendario ha configurado. La enumeración calendarRoleType define el rango de permisos que Microsoft Graph admite:

none Este valor solo My Organization se aplica a los que no tienen permisos para el calendario. No se aplica a usuarios individuales, ya que solo los usuarios con permisos están asociados a un calendarPermission para el calendario.
freeBusyRead El destinatario del recurso compartido puede ver el estado de disponibilidad del propietario, pero no otros detalles del calendario.
limitedRead El destinatario del recurso compartido puede ver el estado de disponibilidad del propietario y los títulos y las ubicaciones de los eventos no privados en el calendario.
read El destinatario del recurso compartido puede ver el estado de disponibilidad del propietario en eventos privados y todos los detalles de los eventos no privados en el calendario.
write El destinatario del recurso compartido puede ver el estado de disponibilidad del propietario en eventos privados y puede ver todos los detalles y editar (crear, actualizar o eliminar) eventos no privados en el calendario.
delegateWithoutPrivateEventAccess El delegado puede ver el estado de disponibilidad del propietario en eventos privados y tiene acceso para write en los eventos no privados en el calendario.
delegateWithPrivateEventAccess El delegado puede ver los detalles de los eventos privados y no privados del propietario, y tiene acceso para write en todos los eventos del calendario.

El calendario principal de un usuario siempre se comparte con "Mi organización", que representa los usuarios de la misma organización que el propietario. De forma predeterminada, los usuarios pueden leer el estado de disponibilidad del propietario del calendario y tienen el permiso de freeBusyRead.

Este ejemplo muestra con el consentimiento de Alex o el administrador, cómo obtener los objetos calendarPermission asociados al calendario principal de Alex. La solicitud devuelve dos objetos de permiso:

El primer objeto calendarPermission se asigna al delegado, Nuria, y tiene los siguientes valores de propiedades:
- isRemovable se establece en verdadero, lo que proporciona a Sergio la opción de cancelar la delegación.
- isInsideOrganization es verdadero ya que solo los usuarios de la misma organización pueden ser delegados.
- role para Nuria es delegateWithPrivateEventAccess, como lo configuró Sergio.
- allowedRoles incluye los tipos de rol delegateWithoutPrivateEventAccess y delegateWithPrivateEventAccess que admiten la delegación.
- emailAddress especifica Nuria.
El segundo objeto calendarPermission es un objeto predeterminado asignado a "Mi organización" y tiene los siguientes valores de propiedades:
- isRemovable se configura como falso, ya que el calendario principal siempre se comparte con la organización del propietario.
- isInsideOrganization es verdadero.
- role es freeBusyRead, la configuración predeterminada para "Mi organización".
- emailAddress especifica la subpropiedad name como "Mi organización", address de "Mi organización" es null de forma predeterminada.

Permisos de Microsoft Graph

Use el permiso de aplicación o delegado con menos privilegios, Calendars.Read, según corresponda, para esta operación. Para obtener más información, vea permisos de calendario.

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


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users calendar calendar-permissions list --user-id {user-id}



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



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\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


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


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

Con el consentimiento de Alex o administrador, puede actualizar los permisos asignados a un destinatario o delegado de recurso compartido existente (especificados por la propiedad role ), siempre y cuando los nuevos permisos sean compatibles con los permitidosRoles configurados inicialmente para el destinatario o delegado del recurso compartido para ese calendario.

Aparte de la propiedad role , no se pueden actualizar otras propiedades de un destinatario o delegado de recurso compartido existente. Cambiar el valor de la propiedad emailAddress requiere eliminar el destinatario o delegado del recurso compartido y configurar una nueva instancia de calendarPermission de nuevo.

En el ejemplo de esta sección se actualiza la propiedad role y se cambia el permiso de un destinatario de recursos compartidos existente, Adele, de read a write para el calendario personalizado "Kids parties".

Permisos de Microsoft Graph

Use el permiso de aplicación o delegado con menos privilegios, Calendars.ReadWrite, según corresponda, para esta operación. Para obtener más información, vea permisos de calendario.

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


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users calendars calendar-permissions patch --user-id {user-id} --calendar-id {calendar-id} --calendar-permission-id {calendarPermission-id} --body '{\
  "role": "write"\
}\
'



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewCalendarPermission()
role := graphmodels.WRITE_CALENDARROLETYPE 
requestBody.SetRole(&role) 

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\GraphServiceClient;
use Microsoft\Graph\Generated\Models\CalendarPermission;


$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


from msgraph import GraphServiceClient
from msgraph.generated.models.calendar_permission import CalendarPermission

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)

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

Obtener las propiedades de un calendario compartido o delegado

En esta sección:

Propietario del calendario: obtener las propiedades de un calendario compartido o delegado
compartir destinatario o delegado: obtener propiedades del calendario compartido o delegado

Volviendo a este ejemplo, Sergio ha delegado su calendario principal y dado al delegado, Nuria Acevedo, el permiso para ver los elementos de calendario que estén marcados como privados. En esta sección se muestran las propiedades del calendario delegado, en primer lugar desde la perspectiva y con el consentimiento del propietario, Sergio, y después desde la perspectiva y con el consentimiento del delegado, Nuria. El consentimiento del administrador también funciona en cada caso.

Propietario del calendario: obtener las propiedades de un calendario compartido o delegado

El ejemplo de esta sección obtiene las propiedades del calendario principal desde la perspectiva del propietario, Alex.

Tenga en cuenta las siguientes propiedades en nombre de Sergio:

canShare es verdadero, ya que Sergio es el propietario.
canViewPrivateItems es verdadero, ya que Sergio es el propietario.
isShared se establece en verdadero, ya que Sergio ha configurado un delegado para este calendario.
isSharedWithMe es siempre falso para el propietario del calendario.
owner muestra a Sergio como propietario.

Permisos de Microsoft Graph

Use el permiso de aplicación o delegado con menos privilegios, Calendars.Read, según corresponda, para esta operación. Para obtener más información, vea permisos de calendario.

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


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users calendar get --user-id {user-id}



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



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\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


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


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

El ejemplo de esta sección obtiene las propiedades del mismo calendario desde la perspectiva del delegado, Megan.

Tenga en cuenta las propiedades siguientes:

name del calendario es, de forma predeterminada, el nombre para mostrar del propietario. En este caso, es "Sergio Valladares", ya que este es el calendario de Sergio que se ha delegado en Nuria.
canShare es falso, ya que Nuria no es el propietario de este calendario.
canViewPrivateItems es verdadero para el delegado Nuria, como ha configurado Sergio. En el caso de una persona con la que se comparte que no es delegado, el valor de esta propiedad es siempre falso.
isShared es falso. Esta propiedad solo indica al propietario del calendario si el calendario se ha compartido o delegado.
isSharedWithMe propiedad es verdadero, ya que Nuria es un delegado.
canEdit es verdadero, ya que los delegados, incluida Nuria, tienen acceso de escritura.
owner se establece como Sergio.

Nota:

Una persona con la que se comparte o delegado solo puede personalizar la propiedad name de un calendario compartido/delegado. La actualización solo pueden verla ellos mismos; el propietario del calendario no ve estos cambios en el nombre del calendario.

Permisos de Microsoft Graph

Use el permiso delegado con menos privilegios, Calendars.Read.Shared, o permiso de aplicación, Calendars.Read, según corresponda para esta operación. Para obtener más información, vea permisos de calendario.

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


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users calendars get --user-id {user-id} --calendar-id {calendar-id}



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



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\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


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


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

Obtener o establecer la configuración de buzón para recibir convocatorias de reunión y respuestas

En esta sección:

Obtener la configuración de entrega de delegación para el buzón de un usuario
Establecer la configuración de entrega de delegación para el buzón de un usuario

Según el nivel de delegación que prefiera el propietario del calendario, el propietario puede especificar quién debe recibir las convocatorias de reunión y las respuestas para administrar las reuniones en el calendario.

Mediante programación, puede obtener o establecer la propiedad delegateMeetingMessageDeliveryOptions de las mailboxSettings del propietario del calendario para especificar a quién debe dirigir Outlook las instancias eventMessageRequest y eventMessageResponse:

sendToDelegateOnly

Outlook debe dirigir instancias eventMessageRequest y eventMessageResponse solo a los delegados. Esta configuración es la predeterminada. El propietario puede ver las respuestas a una reunión o responder a una invitación a través del evento correspondiente en el calendario delegado.
sendToDelegateAndInformationToPrincipal

Outlook debe dirigir instancias eventMessageRequest y eventMessageResponse a los delegados y el propietario del calendario. Solo los delegados ven la opción para aceptar o rechazar una convocatoria de reunión, y la notificación que se envía al propietario parecerá un correo electrónico normal. El propietario aún puede responder a la reunión abriendo el evento en el calendario delegado y respondiendo.
sendToDelegateAndPrincipal

Outlook debe dirigir las instancias eventMessageRequest y eventMessageResponse a los delegados y el propietario del calendario, cualquiera de los cuales puede responder a la convocatoria de reunión.

Se trata de una configuración para todo el buzón, por lo que la misma configuración se aplica a todos los delegados del propietario del buzón.

Obtener la configuración de entrega de delegación para el buzón de un usuario

El ejemplo de esta sección obtiene la propiedad mailboxSettings de un propietario del calendario que permite que Outlook dirija las convocatorias de reunión y las respuestas solo a los delegados del calendario; es decir, delegateMeetingMessageDeliveryOptions se establece como sendToDelegateOnly.

Permisos de Microsoft Graph

Use el permiso de aplicación o delegado con menos privilegios, MailboxSettings.Read, según corresponda para esta operación. Para obtener más información sobre los permisos de buzón, vea lospermisos de correo electrónico.

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


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users mailbox-settings get --user-id {user-id}



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



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\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


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


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

Establecer la configuración de entrega de delegación para el buzón de un usuario

El ejemplo en esta sección de presentación se actualiza la propiedad delegateMeetingMessageDeliveryOptions en sendToDelegateAndPrincipal, para que Outlook dirija las convocatorias de reunión y las respuestas del calendario delegado a todos los delegados y al propietario.

Permisos de Microsoft Graph

Use el permiso de aplicación o delegado con menos privilegios, MailboxSettings.ReadWrite, según corresponda para esta operación. Para obtener más información sobre los permisos de buzón, vea lospermisos de correo electrónico.

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


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users mailbox-settings patch --user-id {user-id} --body '{\
  "delegateMeetingMessageDeliveryOptions": "sendToDelegateAndPrincipal"\
}\
'



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewMailboxSettings()
delegateMeetingMessageDeliveryOptions := graphmodels.SENDTODELEGATEANDPRINCIPAL_DELEGATEMEETINGMESSAGEDELIVERYOPTIONS 
requestBody.SetDelegateMeetingMessageDeliveryOptions(&delegateMeetingMessageDeliveryOptions) 

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\GraphServiceClient;
use Microsoft\Graph\Generated\Models\MailboxSettings;


$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


from msgraph import GraphServiceClient
from msgraph.generated.models.mailbox_settings import MailboxSettings

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)

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

Eliminar una persona con la que se comparte o un delegado de un calendario.

En el ejemplo siguiente, Alex elimina Megan como recurso compartido del calendario de "Fiestas infantiles".

Permisos de Microsoft Graph

Use el permiso de aplicación o delegado con menos privilegios, Calendars.ReadWrite, según corresponda, para esta operación. Para obtener más información, vea permisos de calendario.

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


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta users calendars calendar-permissions delete --user-id {user-id} --calendar-id {calendar-id} --calendar-permission-id {calendarPermission-id}



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



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\GraphServiceClient;


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


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

Snippet not available


from msgraph 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()

HTTP/1.1 204 No Content

Obtener las propiedades de un calendario compartido o delegado

Propietario del calendario: obtener las propiedades de un calendario compartido o delegado

Obtener o establecer la configuración de buzón para recibir convocatorias de reunión y respuestas

Obtener la configuración de entrega de delegación para el buzón de un usuario

Establecer la configuración de entrega de delegación para el buzón de un usuario

Eliminar una persona con la que se comparte o un delegado de un calendario.

Comentarios

Comentarios

Recursos adicionales

Obtener información de calendario sobre los destinatarios y delegados del recurso compartido, y actualizar permisos individuales

Propietario del calendario: obtener información y permisos de uso compartido o delegación

Propietario del calendario: actualizar los permisos de un destinatario o delegado de recurso compartido existente en un calendario

Obtener las propiedades de un calendario compartido o delegado

Propietario del calendario: obtener las propiedades de un calendario compartido o delegado

Compartir destinatario o delegado: obtener propiedades del calendario compartido o delegado

Obtener o establecer la configuración de buzón para recibir convocatorias de reunión y respuestas

Obtener la configuración de entrega de delegación para el buzón de un usuario

Establecer la configuración de entrega de delegación para el buzón de un usuario

Eliminar una persona con la que se comparte o un delegado de un calendario.

Contenido relacionado

Comentarios

Comentarios

Recursos adicionales