共有または委任されたフォルダー内の Outlook メッセージを取得するGet Outlook messages in a shared or delegated folder

Outlook では、ユーザーがメール フォルダーを互いに共有し、個々のフォルダーに対する "読み取り"、"作成"、"変更"、"削除" のアクセス権を与えることができます。Outlook lets customers share mail folders with one another and provide "read", "create", "modify", or "delete" access to individual folders. また、Outlook では、あるユーザーが別のユーザーの代理人としてふるまい、ユーザーのメールボックス全体の中にある特定のメール フォルダーにアクセスすることもできます。これは Outlook では "委任" とも呼ばれます。Outlook also allows a customer to delegate another user to act on the customer's behalf, and access specific mail folders or the customer's entire mailbox; this is also known as "delegation" in Outlook.

Microsoft Graph では、他のユーザーと共有するメール フォルダーのメッセージを取得したり、共有フォルダー自体を取得したりする機能がプログラムとしてサポートされています。Programmatically, Microsoft Graph supports getting messages in mail folders that have been shared by other users, as well as getting the shared folders themselves. サポートは、委任されたフォルダーにも適用されます。The support also applies to folders that have been delegated.

たとえば、Garth が自分の受信トレイを John と共有し、読み取りアクセス権を与えたとします。As an example, Garth has shared with John and given read access to Garth's Inbox. John がアプリにサインインし、委任されたアクセス許可 (Mail.Read.Shared または Mail.ReadWrite.Shared) を与えた場合、アプリでは、下記のようにして Garth のメールおよび Garth の受信トレイにアクセスすることができます。If John has signed into your app and provided delegated permissions (Mail.Read.Shared or Mail.ReadWrite.Shared), your app will be able to access Garth's mail and Garth's Inbox as described below.

共有アクセス許可 (Mail.Read.Shared または Mail.ReadWrite.Shared) が与えられると、共有または委任されたフォルダーでメッセージを読み書きできます。Note The sharing permissions (Mail.Read.Shared or Mail.ReadWrite.Shared) allow you to read or write messages in a shared or delegated folder. そのようなフォルダーでアイテムの変更通知をサブスクライブすることはできません。They do not support subscribing to change notifications on items in such folders. テナントで共有フォルダー、委任フォルダー、その他のユーザーのメール フォルダーに含まれているメッセージに変更通知サブスクリプションを設定するには、アプリケーション アクセス許可の Mail.Read を使用します。To set up change notification subscriptions on messages in a shared, delegated, or any other user's mail folder in the tenant, use the application permission, Mail.Read.

共有フォルダーのメッセージを取得Get a message in the shared folder

Garth の受信トレイの特定のメッセージを取得できます:You can get a specific message in Garth's Inbox:

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages/{id}

正常に終了した場合、HTTP 200 OK となり、Garth の受信トレイから {id} によって識別されるメッセージ インスタンスを取得します。On successful completion, you'll get HTTP 200 OK and the message instance identified by {id} from Garth's Inbox.

共有フォルダー内の全メッセージを取得Get all messages in the shared folder

Garth の受信トレイの全メッセージを取得:Get all the messages in Garth's Inbox:

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')/messages

正常に終了すると、HTTP 200 OK となり、Garth の受信トレイのメッセージ インスタンスのコレクションを取得します。On successful completion, you'll get HTTP 200 OK and a collection of message instances in Garth's Inbox.

共有フォルダーを取得Get the shared folder

Garth が John と共有したフォルダー (受信トレイ) を取得します。Get the folder (Inbox) that Garth has shared with John.

GET users/{Garth-userId | Garth-userPrincipalName}/mailfolders('Inbox')

正常に終了すると、HTTP 200 OK となり、Garth の受信トレイ フォルダーを表す mailFolder インスタンスを取得します。On successful completion, you'll get HTTP 200 OK and a mailFolder instance that represents Garth's Inbox folder.

Garth が John に対して、Garth の受信トレイへのさらに多くのアクセス権を委任していた場合、または Garth が自分のメールボックス全体を John に委任していた場合も、同じ GET 機能が適用されます。The same GET capabilities apply if Garth had delegated John further access to Garth's Inbox, or if Garth had delegated John his entire mailbox.

Garth が John と受信トレイを共有しておらず、メールボックスを John に委任していない場合、それらの GET 操作に Garth のユーザー ID またはユーザー プリンシパル名を指定すると、エラーが返されます。If Garth has not shared his Inbox with John, nor has he delegated his mailbox to John, specifying Garth’s user ID or user principal name in those GET operations will return an error.

次のステップNext steps

詳細情報:Find out more about: