Liste des abonnements

Espace de noms: microsoft.graph

Récupérer les propriétés et les relations entre les abonnements webhook basés sur l’ID de l’application, l’utilisateur et le rôle de l’utilisateur avec un client.

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.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Ressource prise en charge Déléguée (compte professionnel ou scolaire) Déléguée (compte Microsoft personnel) Application
callRecord (/communications/callRecords) Non pris en charge Non pris en charge CallRecords.Read.All
canal (/teams/getAllChannels : tous les canaux d'une organisation) Non pris en charge Non pris en charge Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All
canal (/teams/{id}/channels) Channel.ReadBasic.All, ChannelSettings.Read.All, Subscription.Read.All Non pris en charge Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All
chat (/conversations : toutes les conversations d’une organisation) Non pris en charge Non pris en charge Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chat (/chats/{id}) Chat.ReadBasic, Chat.Read, Chat.ReadWrite, Subscription.Read.All Non pris en charge ChatSettings.Read.Chat , ChatSettings.ReadWrite.Chat, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chatMessage (/teams/{id}/channels/{id}/messages) ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All, Subscription.Read.All Non pris en charge ChannelMessage.Read.Group*, ChannelMessage.Read.All
chatMessage (/teams/getAllMessages--tous les messages de canal dans l’organisation) Non pris en charge Non pris en charge ChannelMessage.Read.All
chatMessage (/chats/{ID}/messages) Chat.Read, Chat.ReadWrite, Subscription.Read.All Non pris en charge Chat.Read.All
chatMessage (/teams/getAllMessages--tous les messages de canal dans l’organisation) Non pris en charge Non pris en charge Chat.Read.All
chatMessage (/users/{id}/chats/getAllMessages : messages de conversation pour toutes les conversations dont fait partie un utilisateur particulier) Chat.Read, Chat.ReadWrite Non pris en charge Chat.Read.All, Chat.ReadWrite.All
contact Contacts.Read, Subscription.Read.All Contacts.Read, Subscription.Read.All Contacts.Read
conversationMember (/teams/{id}/channels/getAllMembers) Non pris en charge Non pris en charge ChannelMember.Read.All
conversationMember (/chats/getAllMembers) Non pris en charge Non pris en charge 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, Subscription.Read.All Non pris en charge ChatMember.Read.Chat , Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
conversationMember (/teams/{id}/members) TeamMember.Read.All, Subscription.Read.All Non pris en charge TeamMember.Read.All
driveItem(OneDrive personnel de l’utilisateur) Non pris en charge Files.ReadWrite, Subscription.Read.All Non pris en charge
driveItem(Microsoft OneDrive Entreprise) Files.ReadWrite.All, Subscription.Read.All Non pris 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 pris en charge Group.Read.All
Conversation de groupe Group.Read.All, Subscription.Read.All Non pris en charge Non pris en charge
liste Sites.ReadWrite.All, Subscription.Read.All Non pris en charge Sites.ReadWrite.All
message Mail.ReadBasic, Mail.Read, Subscription.Read.All Mail.ReadBasic, Mail.Read, Subscription.Read.All Mail.Read
présence Presence.Read.All, Subscription.Read.All Non pris en charge Non pris en charge
imprimante Non pris en charge Non pris en charge Printer.Read.All, Printer.ReadWrite.All
printTaskDefinition Non pris en charge Non pris en charge PrintTaskDefinition.ReadWrite.All
alerte de sécurité SecurityEvents.ReadWrite.All, Subscription.Read.All Non pris en charge SecurityEvents.ReadWrite.All
teams (/teams : toutes les équipes d'une organisation) Non pris en charge Non pris en charge Team.ReadBasic.All, TeamSettings.Read.All
équipe (/teams/{id}) Team.ReadBasic.All, TeamSettings.Read.All, Subscription.Read.All Non pris en charge Team.ReadBasic.All, TeamSettings.Read.All
todoTask Tasks.ReadWrite, Subscription.Read.All Tasks.ReadWrite, Subscription.Read.All Non pris en charge
utilisateur User.Read.All, Subscription.Read.All User.Read.All User.Read.All

Remarque : les autorisations marquées d’un astérisque (*) utilisent une autorisation propre aux ressources.

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

Plus fréquemment, une application souhaite récupérer un abonnements qu’elle créée pour l’utilisateur actuellement connecté ou pour tous les utilisateurs dans l’annuaire (comptes professionnels ou scolaires). Ces scénarios ne nécessitent pas des autorisations spéciales au-delà de celles que l’application qui sert à l’origine 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.

Remarque : Cela s’applique aux comptes Microsoft personnels et comptes professionnel ou scolaires.
Abonnements créés par cette 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 : Cela s’applique uniquement aux comptes scolaires/professionnels.
Abonnements créés par cette application pour elle-même ou pour tous les utilisateurs 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 peut voir tous les abonnements à partir de toutes les applications de leur 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 : Cela s’applique aux comptes Microsoft personnels et comptes professionnel ou scolaires.
Abonnements créés par n’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 un administrateur.
et
L’application a l’autorisation Subscription.Read.All

Remarque : Cela s’applique pour les comptes professionnels ou scolaires uniquement.
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.

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/v1.0/subscriptions

Réponse

Voici un exemple de 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/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"
    }
  ]
}

Remarque : les valeurs de propriété clientState ne 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.