サブスクリプション: 再認証
名前空間: microsoft.graph
再認証 Required チャレンジを受け取ったときにサブスクリプションを再認証します。
この API は、次の国内クラウド展開で使用できます。
グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
アクセス許可
要求されたリソースとアクセス許可の種類 (委任またはアプリケーション) に応じて、以下の表で指定されているアクセス許可がこの API を呼び出すため必要な最小限の特権となります。 より多くの特権アクセス許可を選択する前に注意することを含め、詳細については、[アクセス許可] で次のアクセス許可を検索してください。
注:
一部のリソースでは、複数のシナリオで変更通知がサポートされており、それぞれに異なるアクセス許可が必要な場合があります。 このような場合は、リソース パスを使用してシナリオを区別します。
* でマークされたアクセス許可は、リソース固有の同意を使用します。
サポートされているリソース | 委任 (職場または学校のアカウント) | 委任 (個人用 Microsoft アカウント) | アプリケーション |
---|---|---|---|
baseTask (非推奨) | Tasks.ReadWrite | Tasks.ReadWrite | サポートされていません。 |
callRecord | サポートされていません。 | サポートされていません。 | CallRecords.Read.All |
callRecording communications/onlineMeetings/getAllRecordings organization内のすべての録音。 |
サポートされていません。 | サポートされていません。 | OnlineMeetingRecording.Read.All |
callRecording communications/onlineMeetings/{onlineMeetingId}/recordings 特定の会議のすべての記録。 |
OnlineMeetingRecording.Read.All | サポートされていません。 | OnlineMeetingRecording.Read.All |
callRecording users/{userId}/onlineMeetings/getAllRecordings 特定のユーザーが開催した会議で使用可能になる通話記録。 |
OnlineMeetingRecording.Read.All | サポートされていません。 | OnlineMeetingRecording.Read.All |
callTranscript communications/onlineMeetings/getAllTranscripts organization内のすべてのトランスクリプト。 |
サポートされていません。 | サポートされていません。 | OnlineMeetingTranscript.Read.All |
callTranscript communications/onlineMeetings/{onlineMeetingId}/transcripts 特定の会議のすべてのトランスクリプト。 |
OnlineMeetingTranscript.Read.All | サポートされていません。 | OnlineMeetingTranscript.Read.All |
callTranscript users/{userId}/onlineMeetings/getAllTranscripts 特定のユーザーが開催した会議で使用できる通話トランスクリプト。 |
OnlineMeetingTranscript.Read.All | サポートされていません。 | OnlineMeetingTranscript.Read.All |
channel /teams/getAllChannels organization内のすべてのチャネル。 |
サポートされていません。 | サポートされていません。 | Channel.ReadBasic.All、ChannelSettings.Read.All |
channel /teams/{id}/channels organization内の特定のチームのすべてのチャネル。 |
Channel.ReadBasic.All、ChannelSettings.Read.All | サポートされていません。 | Channel.ReadBasic.All、ChannelSettings.Read.All |
チャット /チャット organization内のすべてのチャット。 |
サポートされていません。 | サポートされていません。 | Chat.ReadBasic.All、 Chat.Read.All、 Chat.ReadWrite.All |
チャット /chats/{id} 特定のチャット。 |
Chat.ReadBasic、 Chat.Read、 Chat.ReadWrite | サポートされていません。 | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
チャット /appCatalogs/teamsApps/{id}/installedToChats 特定の Teams アプリがインストールされているorganization内のすべてのチャット。 |
非サポート | サポート対象外 | Chat.ReadBasic.WhereInstalled、Chat.Read.WhereInstalled、Chat.ReadWrite.WhereInstalled |
chatMessage /teams/{id}/channels/{id}/messages 特定のチャネルのすべてのメッセージと応答。 |
ChannelMessage.Read.All、Group.Read.All、Group.ReadWrite.All | サポートされていません。 | ChannelMessage.Read.Group*、ChannelMessage.Read.All |
chatMessage /teams/getAllMessages organization内のすべてのチャネル メッセージ。 |
サポートされていません。 | サポートされていません。 | ChannelMessage.Read.All |
chatMessage /chats/{id}/messages チャット内のすべてのメッセージ。 |
Chat.Read、Chat.ReadWrite | サポートされていません。 | Chat.Read.All |
chatMessage /chats/getAllMessages。 organization内のすべてのチャット メッセージ。 |
サポートされていません。 | サポートされていません。 | Chat.Read.All |
chatMessage /users/{id}/chats/getAllMessages 特定のユーザーが参加しているすべてのチャットに対するチャット メッセージ。 |
Chat.Read、Chat.ReadWrite | サポートされていません。 | Chat.Read.All、Chat.ReadWrite.All |
chatMessage /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages 特定の Teams アプリがインストールされているorganization内のすべてのチャットのチャット メッセージ。 |
非サポート | 非サポート | Chat.Read.WhereInstalled、Chat.ReadWrite.WhereInstalled |
contact | Contacts.Read | Contacts.Read | Contacts.Read |
conversationMember /chats/getAllMembers organization内のすべてのチャットのメンバー。 |
サポートされていません。 | サポートされていません。 | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
conversationMember /chats/{id}/members 特定のチャットのメンバー。 |
ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite | サポートされていません。 | ChatMember.Read.Chat*, Chat.Manage.Chat*, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
conversationMember /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers 特定の Teams アプリがインストールされているorganization内のすべてのチャットのチャット メンバー。 |
サポートされていません。 | サポートされていません。 | ChatMember.Read.WhereInstalled、ChatMember.ReadWrite.WhereInstalled、Chat.ReadBasic.WhereInstalled、Chat.Read.WhereInstalled、Chat.ReadWrite.WhereInstalled |
conversationMember /teams/getAllMembers organizationのすべてのチームのメンバー。 |
サポートされていません。 | サポートされていません。 | TeamMember.Read.All, TeamMember.ReadWrite.All |
conversationMember /teams/{id}/members 特定のチームのメンバー。 |
TeamMember.Read.All | サポートされていません。 | TeamMember.Read.All |
conversationMember /teams/{id}/channels/getAllMembers 特定のチームのすべてのプライベート チャネルのメンバー。 |
サポートされていません。 | サポートされていません。 | ChannelMember.Read.All |
conversationMember (/teams/getAllChannels/getAllMembers) | サポートされていません。 | サポートされていません。 | ChannelMember.Read.All |
driveItem (ユーザーの個人用 OneDrive) | サポートされていません。 | Files.ReadWrite | サポートされていません。 |
driveItem (OneDrive for Business) | Files.ReadWrite.All | サポートされていません。 | Files.ReadWrite.All |
イベント | Calendars.Read | Calendars.Read | Calendars.Read |
グループ | Group.Read.All | サポートされていません。 | Group.Read.All |
グループ会話 | Group.Read.All | サポートされていません。 | サポートされていません。 |
リスト | Sites.ReadWrite.All | サポートされていません。 | Sites.ReadWrite.All |
メッセージ | Mail.ReadBasic, Mail.Read | Mail.ReadBasic, Mail.Read | Mail.Read |
オンライン会議 | 非サポート | 非サポート | OnlineMeetings.Read.All、OnlineMeetings.ReadWrite.All |
プレゼンス | Presence.Read.All | サポートされていません。 | サポートされていません。 |
printer | サポートされていません。 | サポートされていません。 | Printer.Read.All, Printer.ReadWrite.All |
printTaskDefinition | サポートされていません。 | サポートされていません。 | PrintTaskDefinition.ReadWrite.All |
セキュリティの警告 | SecurityEvents.ReadWrite.All | サポートされていません。 | SecurityEvents.ReadWrite.All |
team /チーム organization内のすべてのチーム。 |
サポートされていません。 | サポートされていません。 | Team.ReadBasic.All、TeamSettings.Read.All |
team /teams/{id} 特定のチーム。 |
Team.ReadBasic.All、TeamSettings.Read.All | サポートされていません。 | Team.ReadBasic.All、TeamSettings.Read.All |
todoTask | Tasks.ReadWrite | Tasks.ReadWrite | サポートされていません。 |
user | User.Read.All | User.Read.All | User.Read.All |
chatMessage
chatMessage サブスクリプションは、リソース データを含めるように指定できます。 リソース データを含めるように指定した場合 (includeResourceData を true
に設定)、暗号化が必要です。 そのようなサブスクリプションに encryptionCertificate が指定されていない場合、サブスクリプションの作成は失敗します。
要求ヘッダーを使用して、Prefer: include-unknown-enum-members
chatMessagemessageTypeの進化可能な列挙型systemEventMessage
の for と /chats/{id}/messages
resource で次の値を/teams/{id}/channels/{id}/messages
取得する必要があります。
注:
/teams/getAllMessages
、 /chats/getAllMessages
、 /me/chats/getAllMessages
、 /users/{id}/chats/getAllMessages
および /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages
は従量制課金 API です。 支払いモデルとライセンス要件が 適用される場合があります。
/teams/getAllMessages
と /chats/getAllMessages
の両方model=A
のmodel=B
支払いモデル、、/me/chats/getAllMessages
/users/{id}/chats/getAllMessages
、および のみがサポートmodel=B
されます/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages
。
クエリで支払いモデルを指定しない場合は、既定の 評価モード が使用されます。
注:
変更通知のサブスクライブされたリソースの支払いモデルを追加または変更するには、新しい支払いモデルを使用して新しい変更通知サブスクリプションを作成する必要があります。既存の変更通知の更新は機能しません。
conversationMember
conversationMember サブスクリプションを指定して、リソース データを含めることができます。 リソース データを含めるように指定した場合 (includeResourceData を true
に設定)、暗号化が必要です。 encryptionCertificateが指定されていない場合、サブスクリプションの作成は失敗します。
注:
/teams/getAllMembers
、 /chats/getAllMembers
、および /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers
は従量制課金 API です。 支払いモデルとライセンス要件が 適用される場合があります。
/teams/getAllMembers
と /chats/getAllMembers
支払いモデルの両方 model=A
を model=B
サポートします。 /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers
は のみを model=B
サポートします。
クエリで支払いモデルを指定しない場合は、既定の 評価モード が使用されます。
注:
変更通知のサブスクライブされたリソースの支払いモデルを追加または変更するには、新しい支払いモデルを使用して新しい変更通知サブスクリプションを作成する必要があります。既存の変更通知の更新は機能しません。
チーム、チャネル、チャット
チーム、 チャネル、 チャット サブスクリプションを指定して、リソース データを含めることができます。 リソース データを含めるように指定した場合 (includeResourceData を true
に設定)、暗号化が必要です。 encryptionCertificateが指定されていない場合、サブスクリプションの作成は失敗します。
注:
/appCatalogs/teamsApps/{id}/installedToChats
には 、ライセンスと支払いの要件があり、特に のみを model=B
サポートしています。
モデルが指定されていない場合は、評価モードが使用されます。
注:
変更通知のサブスクライブされたリソースの支払いモデルを追加または変更するには、新しい支払いモデルを使用して新しい変更通知サブスクリプションを作成する必要があります。既存の変更通知の更新は機能しません。
要求の例
要求本文の リソース プロパティで、model
クエリ パラメーターを指定します。
POST https://graph.microsoft.com/v1.0/subscriptions
Content-type: application/json
{
"changeType": "created",
"notificationUrl": "https://webhook.azurewebsites.net/api/send/myNotifyClient",
"resource": "chats/getAllMessages?model=A",
"expirationDateTime":"2016-11-20T18:23:45.9356913Z",
"clientState": "secretClientValue",
"latestSupportedTlsVersion": "v1_2"
}
HTTP 要求
POST /subscriptions/{subscriptionsId}/reauthorize
要求ヘッダー
名前 | 説明 |
---|---|
Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このアクションは 204 No Content
応答コードを返します。
例
要求
次の例は要求を示しています。
POST https://graph.microsoft.com/v1.0/subscriptions/{subscriptionsId}/reauthorize
応答
次の例は応答を示しています。
HTTP/1.1 204 No Content
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示