Это действие позволяет организатору или участнику мероприятия пересылать приглашение на собрание новому получателю.
Если событие собрания перенаправляется из почтового ящика Microsoft 365 участника другому получателю, это действие также отправляет сообщение с уведомлением организатора о переадресации и добавляет получателя в копию организатора события собрания. Это удобство недоступно при пересылке из учетной записи Outlook.com.
Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.
Тип разрешения
Разрешения с наименьшими привилегиями
Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись)
Calendars.Read
Недоступно.
Делегированные (личная учетная запись Майкрософт)
Calendars.Read
Недоступно.
Для приложений
Calendars.Read
Недоступно.
HTTP-запрос
POST /me/events/{id}/forward
POST /users/{id | userPrincipalName}/events/{id}/forward
POST /groups/{id}/events/{id}/forward
POST /me/calendar/events/{id}/forward
POST /users/{id | userPrincipalName}/calendar/events/{id}/forward
POST /groups/{id}/calendar/events/{id}/forward
POST /me/calendars/{id}/events/{id}/forward
POST /users/{id | userPrincipalName}/calendars/{id}/events/{id}/forward
POST /me/calendarGroups/{id}/calendars/{id}/events/{id}/forward
POST /users/{id | userPrincipalName}/calendarGroups/{id}/calendars/{id}/events/{id}/forward
Заголовки запросов
Имя
Тип
Описание
Authorization
string
Bearer {token}. Обязательно.
Content-Type
string
Характер данных в теле объекта. Обязательно.
Текст запроса
В тексте запроса предоставьте JSON-объект с указанными ниже параметрами.
Параметр
Тип
Описание
Comment
String
Добавляемый комментарий. Может быть пустой строкой.
POST https://graph.microsoft.com/v1.0/me/events/{id}/forward
Content-type: application/json
{
"ToRecipients":[
{
"EmailAddress": {
"Address":"danas@contoso.com",
"Name":"Dana Swope"
}
}
],
"Comment": "Dana, hope you can make this meeting."
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Me.Events.Item.Forward;
using Microsoft.Graph.Models;
var requestBody = new ForwardPostRequestBody
{
ToRecipients = new List<Recipient>
{
new Recipient
{
EmailAddress = new EmailAddress
{
Address = "danas@contoso.com",
Name = "Dana Swope",
},
},
},
Comment = "Dana, hope you can make this meeting.",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Me.Events["{event-id}"].Forward.PostAsync(requestBody);
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc users events forward post --user-id {user-id} --event-id {event-id} --body '{\
"ToRecipients":[\
{\
"EmailAddress": {\
"Address":"danas@contoso.com",\
"Name":"Dana Swope"\
}\
}\
],\
"Comment": "Dana, hope you can make this meeting."\
}\
\
'
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.users.item.events.item.forward.ForwardPostRequestBody forwardPostRequestBody = new com.microsoft.graph.users.item.events.item.forward.ForwardPostRequestBody();
LinkedList<Recipient> toRecipients = new LinkedList<Recipient>();
Recipient recipient = new Recipient();
EmailAddress emailAddress = new EmailAddress();
emailAddress.setAddress("danas@contoso.com");
emailAddress.setName("Dana Swope");
recipient.setEmailAddress(emailAddress);
toRecipients.add(recipient);
forwardPostRequestBody.setToRecipients(toRecipients);
forwardPostRequestBody.setComment("Dana, hope you can make this meeting.");
graphClient.me().events().byEventId("{event-id}").forward().post(forwardPostRequestBody);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\ForwardPostRequestBody;
use Microsoft\Graph\Generated\Models\Recipient;
use Microsoft\Graph\Generated\Models\EmailAddress;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ForwardPostRequestBody();
$toRecipientsRecipient1 = new Recipient();
$toRecipientsRecipient1EmailAddress = new EmailAddress();
$toRecipientsRecipient1EmailAddress->setAddress('danas@contoso.com');
$toRecipientsRecipient1EmailAddress->setName('Dana Swope');
$toRecipientsRecipient1->setEmailAddress($toRecipientsRecipient1EmailAddress);
$toRecipientsArray []= $toRecipientsRecipient1;
$requestBody->setToRecipients($toRecipientsArray);
$requestBody->setComment('Dana, hope you can make this meeting.');
$graphServiceClient->me()->events()->byEventId('event-id')->forward()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Users.Actions
$params = @{
ToRecipients = @(
@{
EmailAddress = @{
Address = "danas@contoso.com"
Name = "Dana Swope"
}
}
)
Comment = "Dana, hope you can make this meeting."
}
# A UPN can also be used as -UserId.
Invoke-MgForwardUserEvent -UserId $userId -EventId $eventId -BodyParameter $params
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.