abonnement : réautoriser

Article
01/14/2024

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éautorisez un abonnement lorsque vous recevez un défi de réautorisationRequired .

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’un organization.	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 organization.	Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All	Non prise en charge.	Channel.ReadBasic.All, ChannelSettings.Read.All, ChannelSettings.ReadWrite.All
conversation `/chats` Toutes les conversations dans un organization.	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	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 un organization 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
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	Non prise en charge.	ChannelMessage.Read.Group, ChannelMessage.Read.All
chatMessage `/teams/getAllMessages` Tous les messages de canal dans organization.	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	Non prise en charge.	Chat.Read.All
chatMessage `/chats/getAllMessages` Tous les messages de conversation dans un organization.	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	Non prise en charge.	Chat.Read.All, Chat.ReadWrite.All
chatMessage `/appCatalogs/teamsApps/{id}/installedToChats/getAllMessages` Messages de conversation pour toutes les conversations dans un organization 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	Contacts.Read	Contacts.Read
conversationMember `/chats/getAllMembers` Membres de toutes les conversations dans un organization.	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	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 un organization 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 organization.	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	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	Non prise en charge.
driveItem(Microsoft OneDrive Entreprise)	Files.ReadWrite.All	Non prise en charge.	Files.ReadWrite.All
event	Calendars.Read	Calendars.Read	Calendars.Read
groupe	Group.Read.All	Non prise en charge.	Group.Read.All
Conversation de groupe	Group.Read.All	Non prise en charge.	Non prise en charge.
liste	Sites.ReadWrite.All	Non prise en charge.	Sites.ReadWrite.All
message	Mail.ReadBasic, Mail.Read	Mail.ReadBasic, Mail.Read	Mail.Read
réunion en ligne	Non prise en charge.	Non prise en charge.	OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All
présence	Presence.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	Non prise en charge.	SecurityEvents.ReadWrite.All
team `/teams` Toutes les équipes d’un organization.	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	Non prise en charge.	Team.ReadBasic.All, TeamSettings.Read.All
todoTask	Tasks.ReadWrite	Tasks.ReadWrite	Non prise en charge.
utilisateur	User.Read.All	User.Read.All	User.Read.All
baseTask (déconseillé)	Tasks.ReadWrite	Tasks.ReadWrite	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

chatMessage

Les abonnements chatMessage peuvent être spécifiés pour inclure des données de ressource. S’il est spécifié pour inclure des données de ressource (ncludeResourceData défini sur true), le chiffrement est nécessaire. La création de l’abonnement échoue si un encryptionCertificate n’est pas spécifié pour ces abonnements.

Vous devez utiliser l’en-tête Prefer: include-unknown-enum-members de requête pour obtenir les valeurs suivantes dans chatMessagemessageTypeevolvable enum : systemEventMessage for /teams/{id}/channels/{id}/messages et /chats/{id}/messages resource.

Remarque

/teams/getAllMessages, /chats/getAllMessages, /me/chats/getAllMessages, /users/{id}/chats/getAllMessageset /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages sont des API limitées ; les modèles de paiement et les exigences de licence peuvent s’appliquer. /teams/getAllMessages et /chats/getAllMessages prennent en charge à la fois les model=A modèles de paiement et model=B , /me/chats/getAllMessages, /users/{id}/chats/getAllMessageset /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages prennent uniquement model=Ben charge . Si vous ne spécifiez pas de modèle de paiement dans votre requête, le mode d’évaluation par défaut est utilisé.

Remarque

Pour ajouter ou modifier un modèle de paiement pour une ressource abonnée d’une notification de modification, vous devez créer un abonnement aux notifications de modification avec le nouveau modèle de paiement . La mise à jour d’une notification de modification existante ne fonctionne pas.

conversationMember

Les abonnements conversationMember peuvent être spécifiés pour inclure des données de ressources. S’il est spécifié pour inclure des données de ressource (ncludeResourceData défini sur true), le chiffrement est nécessaire. La création de l’abonnement échoue si un encryptionCertificate n’est pas spécifié.

Remarque

/teams/getAllMembers, /chats/getAllMemberset /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers sont des API limitées ; les modèles de paiement et les exigences de licence peuvent s’appliquer. /teams/getAllMemberset /chats/getAllMembers prennent en charge les model=A modèles de paiement et .model=B /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers prend uniquement model=Ben charge . Si vous ne spécifiez pas de modèle de paiement dans votre requête, le mode d’évaluation par défaut est utilisé.

Remarque

équipe, canal et conversation

Les abonnements d’équipe, de canal et de conversation peuvent être spécifiés pour inclure des données de ressources. S’il est spécifié pour inclure des données de ressource (ncludeResourceData défini sur true), le chiffrement est nécessaire. La création de l’abonnement échoue si un encryptionCertificate n’est pas spécifié.

Remarque

/appCatalogs/teamsApps/{id}/installedToChats a des exigences de licence et de paiement, en particulier prenant en charge uniquement model=B. Si aucun modèle n’est spécifié, le mode d’évaluation sera utilisé.

Remarque

Exemple de requête

Spécifiez model le paramètre de requête dans la propriété de ressource dans le corps de la requête.

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"
}

Requête HTTP

POST /subscriptions/{subscriptionsId}/reauthorize

En-têtes de demande

Nom	Description
Autorisation	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 action renvoie un code de réponse 204 No Content.

Exemples

Demande

L’exemple suivant illustre une demande.

POST https://graph.microsoft.com/beta/subscriptions/{subscriptionsId}/reauthorize


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Subscriptions["{subscription-id}"].Reauthorize.PostAsync();

Importante

Microsoft Graph SDK utilisent la version v1.0 de l’API par défaut et ne prennent pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, consultez Utiliser les kits de développement logiciel (SDK) Microsoft Graph avec l’API bêta.

Pour plus d’informations sur la façon d'ajouter le Kit de développement logiciel (SDK) à votre projet et créer une instance authProvider, consultez la documentation du Kit de développement logiciel (SDK).


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta subscriptions reauthorize post --subscription-id {subscription-id}

Importante



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



graphClient.Subscriptions().BySubscriptionId("subscription-id").Reauthorize().Post(context.Background(), nil)

Importante


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.subscriptions().bySubscriptionId("{subscription-id}").reauthorize().post();

Importante


const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/subscriptions/{subscriptionsId}/reauthorize')
	.version('beta')
	.post();

Importante


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->subscriptions()->bySubscriptionId('subscription-id')->reauthorize()->post()->wait();

Importante


Import-Module Microsoft.Graph.Beta.ChangeNotifications

Invoke-MgBetaReauthorizeSubscription -SubscriptionId $subscriptionId

Importante


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


await graph_client.subscriptions.by_subscription_id('subscription-id').reauthorize.post()

Importante

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content

abonnement : réautoriser

Autorisations

chatMessage

conversationMember

équipe, canal et conversation

Exemple de requête

Requête HTTP

En-têtes de demande

Corps de la demande

Réponse

Exemples

Demande

Réponse

Commentaires

Commentaires

Ressources supplémentaires