Liste des abonnements
Espace de noms: microsoft.graph
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
Récupérez une liste d’abonnements de webhook.
Le contenu de la réponse dépend du contexte dans lequel l’application émet l’appel ; Pour plus d’informations, consultez les scénarios dans la section Autorisations.
Cette API est disponible dans les déploiements de cloud national suivants.
| Service global | Gouvernement des États-Unis L4 | Us Government L5 (DOD) | Chine gérée par 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Autorisations
En fonction du type de ressource et d’autorisation(délégué ou application) demandé, l’autorisation spécifiée dans le tableau suivant est la moins requise privilégiée pour appeler cette API. Pour en savoir plus, notamment sur les Mesures de prudence avant de choisir des autorisations plus privilégiées, recherchez ces autorisations dans Autorisations.
Remarque
Certaines ressources prennent en charge les notifications de modification dans plusieurs scénarios, chacun d’entre eux pouvant nécessiter des autorisations différentes. Dans ce cas, utilisez le chemin de la ressource pour différencier les scénarios.
| Ressource prise en charge | Déléguée (compte professionnel ou scolaire) | Déléguée (compte Microsoft personnel) | Application |
|---|---|---|---|
| callRecord | Non prise en charge. | Non prise en charge. | CallRecords.Read.All |
callRecording communications/onlineMeetings/getAllRecordings Tout enregistrement devient disponible dans le locataire. |
Non prise en charge. | Non prise en charge. | OnlineMeetingRecording.Read.All |
callRecording communications/onlineMeetings/{onlineMeetingId}/recordings Tout enregistrement devient disponible pour une réunion spécifique. |
OnlineMeetingRecording.Read.All | Non prise en charge. | OnlineMeetingRecording.Read.All |
callRecording users/{userId}/onlineMeetings/getAllRecordings Enregistrement d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique. |
OnlineMeetingRecording.Read.All | Non prise en charge. | OnlineMeetingRecording.Read.All |
callRecording appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings Enregistrement d’appel qui devient disponible dans une réunion où une application Teams particulière est installée. |
Non prise en charge. | Non prise en charge. | OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read.Chat |
callTranscript communications/onlineMeetings/getAllTranscripts Toute transcription devient disponible dans le locataire. |
Non prise en charge. | Non prise en charge. | OnlineMeetingTranscript.Read.All |
callTranscript communications/onlineMeetings/{onlineMeetingId}/transcripts Toute transcription devient disponible pour une réunion spécifique. |
OnlineMeetingTranscript.Read.All | Non prise en charge. | OnlineMeetingTranscript.Read.All |
callTranscript users/{userId}/onlineMeetings/getAllTranscripts Transcription d’appel qui devient disponible dans une réunion organisée par un utilisateur spécifique. |
OnlineMeetingTranscript.Read.All | Non prise en charge. | OnlineMeetingTranscript.Read.All |
callTranscript appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts Transcription d’appel qui devient disponible dans une réunion où une application Teams particulière est installée. |
Non prise en charge. | Non prise en charge. | OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read.Chat |
channel /teams/getAllChannels Tous les canaux d’une organisation. |
Non prise en charge. | Non prise en charge. | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
channel /teams/{id}/channels Tous les canaux d’une équipe particulière dans une organisation. |
Channel.ReadBasic.All, ChannelSettings.Read.All, Subscription.Read.All | Non prise en charge. | Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All |
conversation /chats Toutes les conversations d’une organisation. |
Non prise en charge. | Non prise en charge. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
conversation /chats/{id} Une conversation particulière. |
Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All | Non prise en charge. | ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
conversation /appCatalogs/teamsApps/{id}/installedToChats Toutes les conversations dans une organisation où une application Teams particulière est installée. |
Non prise en charge. | Non prise en charge. | Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |
conversation /users/{id}/chats Toutes les conversations dont un utilisateur particulier fait partie. |
Chat.ReadBasic, Chat.Read, Chat.ReadWrite | Non prise en charge. | Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
chatMessage /teams/{id}/channels/{id}/messages Tous les messages et réponses dans un canal particulier. |
ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All, Subscription.Read.All | Non prise en charge. | ChannelMessage.Read.Group, ChannelMessage.Read.All |
chatMessage /teams/getAllMessages Tous les messages de canal dans l’organisation. |
Non prise en charge. | Non prise en charge. | ChannelMessage.Read.All |
chatMessage /chats/{id}/messages Tous les messages d’une conversation. |
Chat.Read, Chat.ReadWrite, Subscription.Read.All | Non prise en charge. | Chat.Read.All |
chatMessage /chats/getAllMessages Tous les messages de conversation dans une organisation. |
Non prise en charge. | Non prise en charge. | Chat.Read.All |
chatMessage /users/{id}/chats/getAllMessages Messages de conversation pour toutes les conversations dont un utilisateur particulier fait partie. |
Chat.Read, Chat.ReadWrite, Subscription.Read.All | Non prise en charge. | Chat.Read.All, Chat.ReadWrite.All |
chatMessage /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages Messages de conversation pour toutes les conversations dans une organisation où une application Teams particulière est installée. |
Non prise en charge. | Non prise en charge. | Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |
| contact | Contacts.Read, Subscription.Read.All | Contacts.Read, Subscription.Read.All | Contacts.Read |
conversationMember /chats/getAllMembers Membres de toutes les conversations d’une organisation. |
Non prise en charge. | Non prise en charge. | ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All |
conversationMember /chats/{id}/members Membres d’une conversation particulière. |
ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All | Non prise en charge. | 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 Membres de conversation pour toutes les conversations dans une organisation où une application Teams particulière est installée. |
Non prise en charge. | Non prise en charge. | ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled |
conversationMember /teams/getAllMembers Membres de toutes les équipes d’une organisation. |
Non prise en charge. | Non prise en charge. | TeamMember.Read.All, TeamMember.ReadWrite.All |
conversationMember /teams/{id}/members Membres d’une équipe particulière. |
TeamMember.Read.All, Subscription.Read.All | Non prise en charge. | TeamMember.Read.All |
conversationMember /teams/{id}/channels/getAllMembers Membres de tous les canaux privés d’une équipe particulière. |
Non prise en charge. | Non prise en charge. | ChannelMember.Read.All |
conversationMember /teams/getAllChannels/getAllMembers |
Non prise en charge. | Non prise en charge. | ChannelMember.Read.All |
| driveItem OneDrive personnel de l’utilisateur. |
Non prise en charge. | Files.ReadWrite, Subscription.Read.All | Non prise en charge. |
| driveItem OneDrive Entreprise. |
Files.ReadWrite.All, Subscription.Read.All | Non prise en charge. | Files.ReadWrite.All |
| event | Calendars.Read, Subscription.Read.All | Calendars.Read, Subscription.Read.All | Calendars.Read |
| groupe | Group.Read.All, Subscription.Read.All | Non prise en charge. | Group.Read.All |
| Conversation de groupe | Group.Read.All, Subscription.Read.All | Non prise en charge. | Non prise en charge. |
| liste | Sites.ReadWrite.All, Subscription.Read.All | Non prise en charge. | 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 Modifications apportées à toute demande de shift d’offre dans une équipe. |
Schedule.Read.All, Schedule.ReadWrite.All | Non prise en charge. | Schedule.Read.All, Schedule.ReadWrite.All |
| réunion en ligne | Non prise en charge. | Non prise en charge. | OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All |
openShiftChangeRequest/teams/{id}/schedule/openShiftChangeRequests Modifications apportées à toute demande de shift ouverte dans une équipe. |
Schedule.Read.All, Schedule.ReadWrite.All | Non prise en charge. | Schedule.Read.All, Schedule.ReadWrite.All |
| présence | Presence.Read.All, Subscription.Read.All | Non prise en charge. | Non prise en charge. |
| imprimante | Non prise en charge. | Non prise en charge. | Printer.Read.All, Printer.ReadWrite.All |
| printTaskDefinition | Non prise en charge. | Non prise en charge. | PrintTaskDefinition.ReadWrite.All |
| alerte de sécurité | SecurityEvents.ReadWrite.All, Subscription.Read.All | Non prise en charge. | SecurityEvents.ReadWrite.All |
shift/teams/{id}/schedule/shifts Modifications apportées à n’importe quel changement dans une équipe. |
Schedule.Read.All, Schedule.ReadWrite.All | Non prise en charge. | Schedule.Read.All, Schedule.ReadWrite.All |
swapShiftsChangeRequest/teams/{id}/schedule/swapShiftsChangeRequests Modifications apportées à toute demande de shift d’échange dans une équipe. |
Schedule.Read.All, Schedule.ReadWrite.All | Non prise en charge. | Schedule.Read.All, Schedule.ReadWrite.All |
team /teams Toutes les équipes d’une organisation. |
Non prise en charge. | Non prise en charge. | Team.ReadBasic.All, TeamSettings.Read.All |
team /teams/{id} Une équipe particulière. |
Team.ReadBasic.All, TeamSettings.Read.All, Subscription.Read.All | Non prise en charge. | Team.ReadBasic.All, TeamSettings.Read.All |
timeOffRequest/teams/{id}/schedule/timeOffRequests Modifications apportées à toute demande de congé dans une équipe. |
Schedule.Read.All, Schedule.ReadWrite.All | Non prise en charge. | Schedule.Read.All, Schedule.ReadWrite.All |
| todoTask | Tasks.ReadWrite, Subscription.Read.All | Tasks.ReadWrite, Subscription.Read.All | Non prise en charge. |
| utilisateur | User.Read.All, Subscription.Read.All | User.Read.All | User.Read.All |
| baseTask (déconseillé) | Tasks.ReadWrite, Subscription.Read.All | Tasks.ReadWrite, Subscription.Read.All | Non prise en charge. |
Remarque
Les autorisations suivantes utilisent le consentement spécifique à la ressource :
- OnlineMeetingRecording.Read.Chat
- OnlineMeetingTranscript.Read.Chat
- ChatSettings.Read.Chat
- ChatSettings.ReadWrite.Chat
- Chat.Manage.Chat
- ChannelMessage.Read.Group
- ChatMember.Read.Chat
Les résultats de réponse sont basés sur le contexte de l’application de l’appel. Les sections suivantes décrivent les scénarios courants.
Scénario de base
Le plus souvent, une application souhaite récupérer les abonnements qu’elle a créés à l’origine pour l’utilisateur actuellement connecté ou tous les utilisateurs de l’annuaire (comptes professionnels/scolaires). Ces scénarios ne nécessitent pas d’autorisations spéciales au-delà de celles utilisées à l’origine par l’application pour créer ses abonnements.
| Contexte de l’application appelante | La réponse contient |
|---|---|
| L’application appelle à la place de l’utilisateur connecté(autorisation de délégué). et L’application dispose des autorisations d’origine nécessaires pour créer l’abonnement. Note: Ce scénario s’applique aux comptes Microsoft personnels et aux comptes professionnels/scolaires. |
Abonnements créés par l’application pour l’utilisateur connecté uniquement. |
| L’application appelle en son nom propre (autorisation d’application). et L’application dispose des autorisations d’origine nécessaires pour créer l’abonnement. Remarque : Ce scénario s’applique uniquement aux comptes professionnels/scolaires. |
Abonnements créés par l’application pour elle-même ou tout utilisateur dans l’annuaire. |
Scénarios d’enregistrement avancés
Dans certains cas, une application souhaite récupérer des abonnements créés par les autres applications. Par exemple, un utilisateur souhaite voir tous les abonnements créés par n’importe quelle application en leur nom. Ou un administrateur général qui souhaite voir tous les abonnements de toutes les applications dans son annuaire. Pour ces scénarios, une autorisation déléguée Subscription.Read.All est requise.
| Contexte de l’application appelante | La réponse contient |
|---|---|
| L’application appelle à la place de l’utilisateur connecté(autorisation de délégué). L’utilisateur n’est pas un administrateur. et L’application a l’autorisation Subscription.Read.All Remarque : ce scénario s’applique aux comptes Microsoft personnels et aux comptes professionnels/scolaires. |
Abonnements créés parn’importe quelle application pour l’utilisateur connecté uniquement. |
| L’application appelle à la place de l’utilisateur connecté(autorisation de délégué). L’utilisateur est administrateur général. et L’application a l’autorisation Subscription.Read.All Remarque : Ce scénario s’applique uniquement aux comptes professionnels/scolaires. |
Abonnements créés par n’importe quelle application pour n’importe quel user ou pour tous les utilisateurs dans l’annuaire. |
Requête HTTP
GET /subscriptions
Paramètres facultatifs de la requête
Cette méthode ne prend pas en charge les paramètres de requête OData pour vous aider à personnaliser la réponse.
En-têtes de demande
| Nom | Type | Description |
|---|---|---|
| Autorisation | string | Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation. |
Corps de la demande
N’indiquez pas le corps de la demande pour cette méthode.
Réponse
Si elle réussit, cette méthode renvoie un200 OKcode de réponse et une liste d’objets d’abonnement dans le corps de la réponse.
Exemple
Demande
GET https://graph.microsoft.com/beta/subscriptions
Réponse
L’exemple suivant illustre la réponse.
Remarque : La réponse présentée ici peut être raccourcie pour des raisons de lisibilité.
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$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"
}
]
}
Remarque : les valeurs de propriété
clientStatene sont pas renvoyées pour des raisons de sécurité.
Lorsqu’une requête renvoie plusieurs pages de données, la réponse inclut une @odata.nextLink propriété pour vous aider à gérer les résultats. Pour plus d’informations, voir Pagination des données Microsoft Graph dans votre application.
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour