Abonnements auflisten
Namespace: microsoft.graph
Rufen Sie die Eigenschaften und die Beziehungen von Webhook-Abonnements basierend auf der App-ID, dem Benutzer und der Rolle des Benutzers mit einem Mandanten auf.
Der Inhalt der Antwort hängt vom Kontext der aufrufenden App ab. Ausführliche Informationen finden Sie in den Szenarien im Abschnitt Berechtigungen.
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Diese API unterstützt die folgenden Berechtigungsbereiche. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.
Unterstützte Ressource | Delegiert (Geschäfts-, Schul- oder Unikonto) | Delegiert (persönliches Microsoft-Konto) | Anwendung |
---|---|---|---|
callRecord (/communications/callRecords) | Nicht unterstützt | Nicht unterstützt | CallRecords.Read.All |
callRecording communications/onlineMeetings/getAllRecordings Alle Aufzeichnungen in einer Organisation. |
Nicht unterstützt | Nicht unterstützt | OnlineMeetingRecording.Read.All |
callRecording communications/onlineMeetings/{onlineMeetingId}/recordings Alle Aufzeichnungen für eine bestimmte Besprechung. |
OnlineMeetingRecording.Read.All | Nicht unterstützt | OnlineMeetingRecording.Read.All |
callRecording users/{userId}/onlineMeetings/getAllRecordings Eine Anrufaufzeichnung, die in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird. |
OnlineMeetingRecording.Read.All | Nicht unterstützt | OnlineMeetingRecording.Read.All |
callTranscript communications/onlineMeetings/getAllTranscripts Alle Transkripte in einer Organisation. |
Nicht unterstützt | Nicht unterstützt | OnlineMeetingTranscript.Read.All |
callTranscript communications/onlineMeetings/{onlineMeetingId}/transcripts Alle Transkripte für eine bestimmte Besprechung. |
OnlineMeetingTranscript.Read.All | Nicht unterstützt | OnlineMeetingTranscript.Read.All |
callTranscript users/{userId}/onlineMeetings/getAllTranscripts Ein Anruftranskript, das in einer Besprechung verfügbar wird, die von einem bestimmten Benutzer organisiert wird. |
OnlineMeetingTranscript.Read.All | Nicht unterstützt | OnlineMeetingTranscript.Read.All |
Kanal (/teams/getAllChannels – alle Kanäle in einer Organisation) | Nicht unterstützt | Nicht unterstützt | Channel.ReadBasic.All, ChannelSettings.Read.All |
channel (/teams/{id}/channels) | Channel.ReadBasic.All, ChannelSettings.Read.All, Subscription.Read.All | Nicht unterstützt | Channel.ReadBasic.All, ChannelSettings.Read.All |
chat (/Chats – alle Chats in einer Organisation) | Nicht unterstützt | Nicht unterstützt | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
chat (/chats/{id}) | Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All | Nicht unterstützt | ChatSettings.Read.Chat*, ChatSettings.ReadWrite.Chat*, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
chat /appCatalogs/teamsApps/{id}/installedToChats Alle Chats in einer Organisation, in der eine bestimmte Teams-App installiert ist. |
Nicht unterstützt | Nicht unterstützt | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |
ChatMessage (/Teams/{ID}/Channels/{ID}/Messages) | ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All, Subscription.Read.All | Nicht unterstützt | ChannelMessage.Read.Group*, ChannelMessage.Read.All |
ChatMessage (/Teams/getAllMessages – alle Kanalnachrichten in der Organisation) | Nicht unterstützt | Nicht unterstützt | ChannelMessage.Read.All |
ChatMessage (/Chats/{ID}/Messages) | Chat.Read, Chat.ReadWrite, Subscription.Read.All | Nicht unterstützt | Chat.Read.All |
ChatMessage (/Chats/getAllMessages – Alle Chatnachrichten in der Organisation) | Nicht unterstützt | Nicht unterstützt | Chat.Read.All |
chatMessage (/users/{id}/chats/getAllMessages –- Chatnachrichten für alle Chats, an denen ein bestimmter Benutzer beteiligt ist) | Chat.Read, Chat.ReadWrite | Nicht unterstützt | Chat.Read.All, Chat.ReadWrite.All |
chatMessage /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages Chatnachrichten für alle Chats in einer Organisation, in der eine bestimmte Teams-App installiert ist. |
Nicht unterstützt | Nicht unterstützt | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |
contact | Contacts.Read, Subscription.Read.All | Contacts.Read, Subscription.Read.All | Contacts.Read |
conversationMember (/teams/{id}/channels/getAllMembers) | Nicht unterstützt | Nicht unterstützt | ChannelMember.Read.All |
conversationMember (/chats/getAllMembers) | Nicht unterstützt | Nicht unterstützt | 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 | Nicht unterstützt | 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 Chatmitglieder für alle Chats in einer Organisation, in der eine bestimmte Teams-App installiert ist. |
Nicht unterstützt | Nicht unterstützt | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |
conversationMember (/teams/{id}/members) | TeamMember.Read.All, Subscription.Read.All | Nicht unterstützt | TeamMember.Read.All |
driveItem (persönliche OneDrive-Umgebung eines Benutzers) | Nicht unterstützt | Files.ReadWrite, Subscription.Read.All | Nicht unterstützt |
driveItem (OneDrive für Arbeit oder Schule) | Files.ReadWrite.All, Subscription.Read.All | Nicht unterstützt | Files.ReadWrite.All |
event | Calendars.Read, Subscription.Read.All | Calendars.Read, Subscription.Read.All | Calendars.Read |
group | Group.Read.All, Subscription.Read.All | Nicht unterstützt | Group.Read.All |
group conversation | Group.Read.All, Subscription.Read.All | Nicht unterstützt | Nicht unterstützt |
list | Sites.ReadWrite.All, Subscription.Read.All | Nicht unterstützt | Sites.ReadWrite.All |
message | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.ReadBasic, Mail.Read, Subscription.Read.All | Mail.Read |
offerShiftRequest (/teams/{id}/schedule/offerShiftRequests) Änderungen an einer Angebotsverschiebungsanforderung in einem Team. |
Schedule.Read.All, Schedule.ReadWrite.All | Nicht unterstützt | Schedule.Read.All, Schedule.ReadWrite.All |
openShiftChangeRequest (/teams/{id}/schedule/openShiftChangeRequests) Änderungen an allen offenen Schichtanforderungen in einem Team. |
Schedule.Read.All, Schedule.ReadWrite.All | Nicht unterstützt | Schedule.Read.All, Schedule.ReadWrite.All |
presence | Presence.Read.All, Subscription.Read.All | Nicht unterstützt | Nicht unterstützt |
Drucker | Nicht unterstützt | Nicht unterstützt | Printer.Read.All, Printer.ReadWrite.All |
printTaskDefinition | Nicht unterstützt | Nicht unterstützt | PrintTaskDefinition.ReadWrite.All |
security alert | SecurityEvents.ReadWrite.All, Subscription.Read.All | Nicht unterstützt | SecurityEvents.ReadWrite.All |
shift (/teams/{id}/schedule/shifts) Änderungen an jeder Verschiebung in einem Team. |
Schedule.Read.All, Schedule.ReadWrite.All | Nicht unterstützt | Schedule.Read.All, Schedule.ReadWrite.All |
swapShiftsChangeRequest (/teams/{id}/schedule/swapShiftsChangeRequests) Änderungen an allen Verschiebungsanforderungen in einem Team. |
Schedule.Read.All, Schedule.ReadWrite.All | Nicht unterstützt | Schedule.Read.All, Schedule.ReadWrite.All |
Team (/teams – alle Teams in einer Organisation) | Nicht unterstützt | Nicht unterstützt | Team.ReadBasic.All, TeamSettings.Read.All |
team (/teams/{id}) | Team.ReadBasic.All, TeamSettings.Read.All, Subscription.Read.All | Nicht unterstützt | Team.ReadBasic.All, TeamSettings.Read.All |
timeOffRequest (/teams/{id}/schedule/timeOffRequests) Änderungen an einer Anforderung für eine ausserplanende Zeit in einem Team. |
Schedule.Read.All, Schedule.ReadWrite.All | Nicht unterstützt | Schedule.Read.All, Schedule.ReadWrite.All |
todoTask | Tasks.ReadWrite, Subscription.Read.All | Tasks.ReadWrite, Subscription.Read.All | Nicht unterstützt |
user | User.Read.All, Subscription.Read.All | User.Read.All | User.Read.All |
Hinweis: Mit * markierte Berechtigungen verwenden ressourcenspezifische Zustimmung.
Antwort-Ergebnisse basieren auf dem Kontext der aufrufenden App. In den folgenden Abschnitten werden die gängigen Szenarien beschrieben.
Grundlegende Szenarien
In den meisten Fällen möchte eine Anwendung diejenigen Abonnements abrufen, die sie ursprünglich für den derzeit angemeldeten Benutzer oder für alle Benutzer im Verzeichnis (Firmen-oder Schulkonten) erstellt hat. Für diese Szenarien sind keine speziellen Berechtigungen erforderlich, die über die berechtigungen hinausgehen, die die App ursprünglich zum Erstellen ihrer Abonnements verwendet hat.
Kontext der aufrufenden Anwendung | Die Antwort enthält |
---|---|
App ruft im Auftrag des angemeldeten Benutzers ab (delegierte Berechtigung). -und- Die App besitzt die ursprüngliche Berechtigung, die benötigt wurde, um das Abonnement zu erstellen. Hinweis: Dies gilt sowohl für persönliche Microsoft-Konten als auch für Firmen- oder Schulkonten. |
Abonnements, die von dieser App einzig für den angemeldeten Benutzer erstellt wurden. |
Die App ruft im eigenen Namen ab (Anwendungsberechtigung). -und- Die App besitzt die ursprüngliche Berechtigung, die benötigt wurde, um das Abonnement zu erstellen. Hinweis: Dies gilt nur für Geschäfts-, Schul- oder Unikonten. |
Abonnements, die von dieser App für sich selbst oder für alle Benutzer im Verzeichnis erstellt wurden. |
Erweiterte Szenarien
In einigen Fällen möchte eine App von anderen Apps erstellte Abonnements abrufen. Ein Benutzer möchte z. B. alle Abonnements anzeigen, die mit jeglichen Apps in seinem Auftrag erstellt wurden. Oder ein globaler Administrator möchte alle Abonnements aller Apps in ihrem Verzeichnis anzeigen. Für derartige Szenarien wird eine delegierte Berechtigung Subscription.Read.All benötigt.
Kontext der aufrufenden Anwendung | Die Antwort enthält |
---|---|
App ruft im Auftrag des angemeldeten Benutzers ab (delegierte Berechtigung).
Der Benutzer besitzt keine Administratorrechte. -und- Die App verfügt über die Berechtigung Subscription.Read.All Hinweis: Dies gilt sowohl für persönliche Microsoft-Konten als auch für Firmen- oder Schulkonten. |
Abonnements, die von jeglichen Apps einzig für den angemeldeten Benutzer erstellt wurden. |
App ruft im Auftrag des angemeldeten Benutzers ab (delegierte Berechtigung).
Der Benutzer ist ein globaler Administrator. -und- Die App verfügt über die Berechtigung Subscription.Read.All Hinweis: Dies gilt nur für Firmen- oder Schulkonten. |
Abonnements, die von jeglichen Apps für alle Benutzer im Verzeichnis erstellt wurden. |
HTTP-Anforderung
GET /subscriptions
Optionale Abfrageparameter
Diese Methode unterstützt die OData-Abfrageparameter nicht, um die Antwort anzupassen.
Anforderungsheader
Name | Typ | Beschreibung |
---|---|---|
Authorization | string | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Im Erfolgsfall erzeugt diese Methode einen 200 OK
Antwortcode sowie eine Auflistung aller Abonnement-Objekte im Antworttext.
Beispiel
Anforderung
GET https://graph.microsoft.com/v1.0/subscriptions
Antwort
Das folgende Beispiel zeigt die Antwort.
Hinweis: Die hier angezeigte Antwort kann zur besseren Lesbarkeit gekürzt werden.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#subscriptions",
"value": [
{
"id": "0fc0d6db-0073-42e5-a186-853da75fb308",
"resource": "Users",
"applicationId": "24d3b144-21ae-4080-943f-7067b395b913",
"changeType": "updated,deleted",
"clientState": null,
"notificationUrl": "https://webhookappexample.azurewebsites.net/api/notifications",
"lifecycleNotificationUrl":"https://webhook.azurewebsites.net/api/send/lifecycleNotifications",
"expirationDateTime": "2018-03-12T05:00:00Z",
"creatorId": "8ee44408-0679-472c-bc2a-692812af3437",
"latestSupportedTlsVersion": "v1_2",
"encryptionCertificate": "",
"encryptionCertificateId": "",
"includeResourceData": false,
"notificationContentType": "application/json"
}
]
}
Hinweis: Der Wert der Eigenschaft
clientState
wird aus Sicherheitsgründen nicht zurückgegeben.
Wenn eine Anforderung mehrere Seiten voller Daten erzeugt, so enthält die Antwort eine @odata.nextLink
Eigenschaft, um die Ergebnisse besser verwalten zu können. Weitere Informationen finden Sie unter Paging der Microsoft Graph-Daten in Ihrer App.