Предоставление общего доступа к календарю или его делегирование в Outlook

Статья
10/07/2023

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

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

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

После настройки общего доступа или делегирования в Outlook приложения смогут использовать API Microsoft Graph, чтобы управлять общим доступом и делегированием.

Оставшаяся часть этой статьи основана на следующем примере сценария:

Алекс Уилбер (Alex Wilber) делегирует Меган Боуен (Megan Bowen) в свой основной календарь и разрешает ей просматривать частные события в этом календаре.
Алекс делится календарем "Детские праздники" с Адель Вэнс (Adele Vance) и Меган Боуен и предоставляет им обеим разрешения read для доступа ко всем сведениям об общедоступных событиях в календаре "Детские праздники", а также сведениям о доступности для частных событий.

В этой статье описано, как программным способом выполнить следующие задачи в общем или делегированном календаре:

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

Приложения также могут выполнять следующие задачи с помощью общедоступного API:

Примечание.

Свойства и API для общего доступа к календарям и их делегирования, как описано в этой статье, сейчас доступны в конечной точке версии 1.0, за исключением свойств календаря isShared и isSharedWithMe. Эти два свойства доступны только в конечной точке бета-версии.

Содержание:

Владелец календаря. Получение разрешений и сведений об общем доступе или делегировании
Владелец календаря: обновление разрешений для существующего получателя общего ресурса или делегата в календаре

Каждый календарь связан с коллекцией объектов calendarPermission , каждый из которых описывает получателя общего ресурса или делегата и соответствующее разрешение, настроенное владельцем календаря. Перечисление calendarRoleType определяет диапазон разрешений, поддерживаемых Microsoft Graph:

none Это значение применяется только My Organization к тем, у которых нет разрешений на календарь. Оно не применяется к отдельным пользователям, так как только пользователи с разрешениями связаны с объектом calendarPermission календаря.
freeBusyRead Получатель общего ресурса может просматривать состояние доступности владельца, но не просматривать другие сведения в календаре.
limitedRead Получатель общего ресурса может просматривать состояние доступности владельца, а также названия и расположения неличных событий в календаре.
read Получатель общего ресурса может просматривать состояние доступности владельца в частных событиях и все сведения о событиях, не являющихся частными, в календаре.
write Получатель общего ресурса может просматривать состояние доступности владельца в частных событиях, а также просматривать все сведения и изменять (создавать, обновлять или удалять) события, не являющиеся частными, в календаре.
delegateWithoutPrivateEventAccess. Делегат может просматривать сведения о доступности владельца в частных событиях и обладает доступом с разрешением write к общедоступным событиям календаря.
delegateWithPrivateEventAccess. Делегат может просматривать сведения о частных и общедоступных событиях владельца и обладает доступом с разрешением write ко всем событиям календаря.

Основной календарь пользователя всегда предоставляется объекту My Organization (Моя организация), представляющему пользователей в организации владельца. По умолчанию они могут читать сведения о доступности владельца в этом календаре и обладают разрешением freeBusyRead.

В этом примере показано, как с согласия Алекса или администратора получать объекты calendarPermission, связанные с основным календарем Алекса. Запрос возвращает два таких объекта разрешений:

Первый объект calendarPermission присвоен делегату Меган со следующими значениями свойств:
- Свойству isRemovable присвоено значение true, предоставляя Алексу возможность отменить делегирование.
- Свойство isInsideOrganization имеет значение true, так как только пользователи из той же организации могут быть делегатами.
- Свойству role для Меган соответствует значение delegateWithPrivateEventAccess, настроенное Алексом.
- Свойство allowedRoles включает типы ролей delegateWithoutPrivateEventAccess и delegateWithPrivateEventAccess, поддерживающие делегирование.
- emailAddress определяет Меган.
Второй объект calendarPermission — это объект по умолчанию, назначаемый объекту My Organization со следующими значениями свойств:
- Свойству isRemovable присвоено значение false, так как основной календарь всегда является общим для организации владельца.
- Свойство isInsideOrganization имеет значение true.
- Свойству role присвоено значение freeBusyRead, являющееся стандартным для объекта My Organization.
- emailAddress определяет для дочернего свойства name значение My Organization; свойство address для My Organization по умолчанию имеет значение null.

Разрешения Microsoft Graph

Для выполнения этой операции воспользуйтесь делегированным разрешением с минимальными правами или разрешением для приложений Calendars.Read соответственно. Дополнительные сведения см. в разделе Разрешения календаря.

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

С согласия Алекса или администратора можно обновить разрешения, назначенные существующему получателю или делегату общей папки (указанные свойством роли ), при условии, что новые разрешения поддерживаются этими разрешенными списками, изначально настроенными для получателя общего ресурса или делегата для этого календаря.

Помимо свойства role , вы не можете обновить другие свойства существующего получателя общего ресурса или делегата. Изменение значения свойства emailAddress требует удаления получателя или делегата общего ресурса и повторной настройки нового экземпляра calendarPermission .

В примере в этом разделе обновляется свойство роли , изменяя разрешение существующего получателя общего ресурса, Адель, с read на write для настраиваемого календаря "Детские вечеринки".

Разрешения Microsoft Graph

Для выполнения этой операции воспользуйтесь делегированным разрешением с минимальными правами или разрешением для приложений Calendars.ReadWrite соответственно. Дополнительные сведения см. в разделе Разрешения календаря.

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

Получение свойств общего или делегированного календаря

Содержание:

Владелец календаря. Получение свойств общего или делегированного календаря
общий доступ к получателю или делегату: получение свойств общего или делегированного календаря

В этом примере Алекс делегировал свой основной календарь и предоставил делегату Меган Боуен разрешение на просмотр элементов календаря, помеченных как частные. В этом разделе показаны свойства делегированного календаря, сначала с точки зрения и с согласия владельца (Алекс), а затем с точки зрения и с согласия делегата (Меган). Согласие администратора также поддерживается для каждого случая.

Владелец календаря. Получение свойств общего или делегированного календаря

В примере из этого раздела выполняется получение свойств основного календаря с точки зрения владельца (Алекс).

Обратите внимание на следующие свойства от имени Алекса:

Свойство canShare имеет значение true, так как Алекс является владельцем.
Свойство canViewPrivateItems имеет значение true, так как Алекс является владельцем.
Свойству isShared присвоено значение true, так как Алекс настроил делегата для этого календаря.
Свойство isSharedWithMe всегда имеет значение false для владельца календаря.
Свойство owner отображает Алекса в качестве владельца.

Разрешения 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();


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

В примере из этого раздела выполняется получение свойств того же календаря с точки зрения делегата (Меган).

Обратите внимание на следующие свойства:

Свойство name календаря по умолчанию соответствует отображаемому имени владельца. В этом случае это Alex Wilber (Алекс Уилбер), так как календарь Алекса делегирован Меган.
Свойство canShare имеет значение false, так как Меган не является владельцем этого календаря.
Свойство canViewPrivateItems имеет значение true для делегата Меган, настроенное Алексом. Для получателя общего доступа, не являющегося делегатом, это свойство всегда имеет значение false.
Свойство isShared имеет значение false. Это свойство указывает только для владельца календаря, был ли к календарю предоставлен общий доступ или он был делегирован.
Свойство isSharedWithMe имеет значение true, так как Меган является делегатом.
Свойство canEdit имеет значение true, так как делегаты, включая Меган, обладают доступом с разрешением на запись.
Свойству owner присвоено значение Alex (Алекс).

Примечание.

Получатель общего доступа или делегат может настраивать только свойство name общего/делегированного календаря. Изменение отображается только для него самого. Владелец календаря не видит таких изменений имени календаря.

Разрешения Microsoft Graph

Для выполнения этой операции воспользуйтесь делегированным разрешением с минимальными правами Calendars.Read.Shared или разрешением для приложений Calendars.Read соответственно. Дополнительные сведения см. в разделе Разрешения календаря.

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

Получение или настройка параметров почтового ящика для получения приглашений на собрания и ответов на них

Содержание:

Получение параметра доставки при делегировании для почтового ящика пользователя
Настройка параметра доставки при делегировании для почтового ящика пользователя

В зависимости от уровня делегирования, предпочитаемого владельцем календаря, владелец может указать, кто должен получать приглашения на собрания и ответы на них, чтобы управлять собраниями в календаре.

Программным способом можно получить или настроить свойство delegateMeetingMessageDeliveryOptions объекта mailboxSettings владельца календаря, чтобы указать, кому Outlook должен направлять экземпляры eventMessageRequest и eventMessageResponse:

sendToDelegateOnly

Outlook должен направлять экземпляры eventMessageRequest и eventMessageResponse только делегатам. Это параметр по умолчанию. Владелец может просматривать ответы на приглашения на собрания или отвечать на приглашения с помощью соответствующего объекта event в делегированном календаре.
sendToDelegateAndInformationToPrincipal

Outlook должен направлять экземпляры eventMessageRequest и eventMessageResponse делегатам и владельцу календаря. Только делегатам доступны параметры для принятия и отклонения приглашения на собрание. Владельцу отправляется уведомление в виде обычного сообщения электронной почты. Владелец может ответить на приглашение, открыв объект event в делегированном календаре.
sendToDelegateAndPrincipal

Outlook должен направлять экземпляры eventMessageRequest и eventMessageResponse делегатам и владельцу календаря, любой из которых может ответить на приглашение на собрание.

Это параметр на уровне почтового ящика, поэтому этот параметр применяется ко всем делегатам владельца почтового ящика.

Получение параметра доставки при делегировании для почтового ящика пользователя

В примере из этого раздела выполняется получение объекта mailboxSettings владельца календаря, который разрешает Outlook направлять приглашения на собрания и ответы на них только делегатам календаря. Таким образом, свойству delegateMeetingMessageDeliveryOptions присвоено значение sendToDelegateOnly.

Разрешения Microsoft Graph

Для выполнения этой операции воспользуйтесь делегированным разрешением с минимальными правами или разрешением для приложений MailboxSettings.Read соответственно. Дополнительные сведения о разрешениях, необходимых для работы с почтовыми ящиками, см. в разделе Разрешения почты.

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

Настройка параметра доставки при делегировании для почтового ящика пользователя

В примере из этого раздела выполняется обновление свойства delegateMeetingMessageDeliveryOptions с присвоением ему значения sendToDelegateAndPrincipal, чтобы Outlook направлял приглашения на собрания и ответы на них в делегированном календаре всем делегатам и владельцу.

Разрешения Microsoft Graph

Для выполнения этой операции воспользуйтесь делегированным разрешением с минимальными правами или разрешением для приложений MailboxSettings.ReadWrite соответственно. Дополнительные сведения о разрешениях, необходимых для работы с почтовыми ящиками, см. в разделе Разрешения почты.

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

Удаление получателя общего доступа или делегата календаря

В примере ниже Алекс удаляет Меган из роли получателя общего доступа к календарю "Детские праздники".

Разрешения 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();


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

Получение свойств общего или делегированного календаря

Владелец календаря. Получение свойств общего или делегированного календаря

Получение или настройка параметров почтового ящика для получения приглашений на собрания и ответов на них

Получение параметра доставки при делегировании для почтового ящика пользователя

Настройка параметра доставки при делегировании для почтового ящика пользователя

Удаление получателя общего доступа или делегата календаря

Обратная связь

Обратная связь

Дополнительные ресурсы

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

Владелец календаря. Получение разрешений и сведений об общем доступе или делегировании

Владелец календаря: обновление разрешений для существующего получателя общего ресурса или делегата в календаре

Получение свойств общего или делегированного календаря

Владелец календаря. Получение свойств общего или делегированного календаря

Общий доступ к получателю или делегату: получение свойств общего или делегированного календаря

Получение или настройка параметров почтового ящика для получения приглашений на собрания и ответов на них

Получение параметра доставки при делегировании для почтового ящика пользователя

Настройка параметра доставки при делегировании для почтового ящика пользователя

Удаление получателя общего доступа или делегата календаря

Связанные материалы

Обратная связь

Обратная связь

Дополнительные ресурсы