assinatura: reautorizar

Artigo
01/14/2024

Namespace: microsoft.graph

Reautorize uma assinatura quando receber um desafio reautorizaçãoRequired .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global	Governo dos EUA L4	GOVERNO DOS EUA L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Dependendo do recurso e do tipo de permissão (delegado ou aplicativo) solicitado, a permissão especificada na tabela a seguir é a menos privilegiada necessária para fazer chamadas a esta API. Para saber mais, incluindo tomar cuidado antes de escolher as permissões mais privilegiadas, pesquise as seguintes permissões em Permissões.

Observação:

Alguns recursos dão suporte a notificações de alteração em vários cenários, cada um deles pode exigir permissões diferentes. Nesses casos, use o caminho do recurso para diferenciar os cenários.

Permissões marcadas com * usem consentimento específico do recurso.

Recurso com suporte	Delegada (conta corporativa ou de estudante)	Delegada (conta pessoal da Microsoft)	Application
baseTask (preterido)	Tasks.ReadWrite	Tasks.ReadWrite	Sem suporte.
callRecord	Sem suporte.	Sem suporte.	CallRecords.Read.All
callRecording `communications/onlineMeetings/getAllRecordings` Todas as gravações em uma organização.	Sem suporte.	Sem suporte.	OnlineMeetingRecording.Read.All
callRecording `communications/onlineMeetings/{onlineMeetingId}/recordings` Todas as gravações para uma reunião específica.	OnlineMeetingRecording.Read.All	Sem suporte.	OnlineMeetingRecording.Read.All
callRecording `users/{userId}/onlineMeetings/getAllRecordings` Uma gravação de chamada que fica disponível em uma reunião organizada por um usuário específico.	OnlineMeetingRecording.Read.All	Sem suporte.	OnlineMeetingRecording.Read.All
callTranscript `communications/onlineMeetings/getAllTranscripts` Todas as transcrições em uma organização.	Sem suporte.	Sem suporte.	OnlineMeetingTranscript.Read.All
callTranscript `communications/onlineMeetings/{onlineMeetingId}/transcripts` Todas as transcrições de uma reunião específica.	OnlineMeetingTranscript.Read.All	Sem suporte.	OnlineMeetingTranscript.Read.All
callTranscript `users/{userId}/onlineMeetings/getAllTranscripts` Uma transcrição de chamada que fica disponível em uma reunião organizada por um usuário específico.	OnlineMeetingTranscript.Read.All	Sem suporte.	OnlineMeetingTranscript.Read.All
canal /teams/getAllChannels Todos os canais em uma organização.	Sem suporte.	Sem suporte.	Channel.ReadBasic.All, ChannelSettings.Read.All
canal /teams/{id}/channels Todos os canais em uma equipe específica em uma organização.	Channel.ReadBasic.All, ChannelSettings.Read.All	Sem suporte.	Channel.ReadBasic.All, ChannelSettings.Read.All
chat /Conversas Todos os chats em uma organização.	Sem suporte.	Sem suporte.	Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chat /chats/{id} Um chat específico.	Chat.ReadBasic, Chat.Read, Chat.ReadWrite	Sem suporte.	ChatSettings.Read.Chat, ChatSettings.ReadWrite.Chat, Chat.Manage.Chat*, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chat /appCatalogs/teamsApps/{id}/installedToChats Todos os chats em uma organização em que um aplicativo específico do Teams está instalado.	Sem suporte	Sem suporte	Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled
chatMessage /teams/{id}/channels/{id}/messages Todas as mensagens e respostas em um canal específico.	ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All	Sem suporte.	ChannelMessage.Read.Group*, ChannelMessage.Read.All
chatMessage /teams/getAllMessages Todas as mensagens de canal na organização.	Sem suporte.	Sem suporte.	ChannelMessage.Read.All
chatMessage /chats/{id}/messages Todas as mensagens em um chat.	Chat.Read, Chat.ReadWrite	Sem suporte.	Chat.Read.All
chatMessage /chats/getAllMessages. Todas as mensagens de chat em uma organização.	Sem suporte.	Sem suporte.	Chat.Read.All
chatMessage /users/{id}/chats/getAllMessages Mensagens de chat para todos os chats dos quais um determinado usuário faz parte.	Chat.Read, Chat.ReadWrite	Sem suporte.	Chat.Read.All, Chat.ReadWrite.All
chatMessage /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages Mensagens de chat para todos os chats em uma organização em que um aplicativo específico do Teams está instalado.	Sem suporte	Sem suporte	Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled
contato	Contacts.Read	Contacts.Read	Contacts.Read
conversationMember /chats/getAllMembers Membros de todos os chats em uma organização.	Sem suporte.	Sem suporte.	ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
conversationMember /chats/{id}/members Membros de um chat específico.	ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite	Sem suporte.	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 Membros do chat para todos os chats em uma organização em que um aplicativo específico do Teams está instalado.	Sem suporte.	Sem suporte.	ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat.ReadBasic.WhereInstalled, Chat.Read.WhereInstalled, Chat.ReadWrite.WhereInstalled
conversationMember /teams/getAllMembers Membros em todas as equipes de uma organização.	Sem suporte.	Sem suporte.	TeamMember.Read.All, TeamMember.ReadWrite.All
conversationMember /teams/{id}/members Membros em uma equipe específica.	TeamMember.Read.All	Sem suporte.	TeamMember.Read.All
conversationMember /teams/{id}/channels/getAllMembers Membros em todos os canais privados de uma equipe específica.	Sem suporte.	Sem suporte.	ChannelMember.Read.All
conversationMember (/teams/getAllChannels/getAllMembers)	Sem suporte.	Sem suporte.	ChannelMember.Read.All
driveItem (OneDrive pessoal de um usuário)	Sem suporte.	Files.ReadWrite	Sem suporte.
driveItem (OneDrive for Business)	Files.ReadWrite.All	Sem suporte.	Files.ReadWrite.All
evento	Calendars.Read	Calendars.Read	Calendars.Read
grupo	Group.Read.All	Sem suporte.	Group.Read.All
conversa em grupo	Group.Read.All	Sem suporte.	Sem suporte.
list	Sites.ReadWrite.All	Sem suporte.	Sites.ReadWrite.All
message	Mail.ReadBasic, Mail.Read	Mail.ReadBasic, Mail.Read	Mail.Read
reunião online	Sem suporte	Sem suporte	OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All
presence	Presence.Read.All	Sem suporte.	Sem suporte.
impressora	Sem suporte.	Sem suporte.	Printer.Read.All, Printer.ReadWrite.All
printTaskDefinition	Sem suporte.	Sem suporte.	PrintTaskDefinition.ReadWrite.All
alerta de segurança	SecurityEvents.ReadWrite.All	Sem suporte.	SecurityEvents.ReadWrite.All
team /Equipes Todas as equipes em uma organização.	Sem suporte.	Sem suporte.	Team.ReadBasic.All, TeamSettings.Read.All
team /teams/{id} Uma equipe específica.	Team.ReadBasic.All, TeamSettings.Read.All	Sem suporte.	Team.ReadBasic.All, TeamSettings.Read.All
todoTask	Tasks.ReadWrite	Tasks.ReadWrite	Sem suporte.
user	User.Read.All	User.Read.All	User.Read.All

chatMessage

chatMessage assinaturas podem ser especificadas para incluir dados de recurso. Se especificado para incluir dados de recurso (includeResourceData definido como true), encryption é necessária. A criação de assinatura falhará se um encryptionCertificate não for especificado para tais assinaturas.

Você deve usar o cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores em chatMessagemessageTypeenume evoluível: systemEventMessage para /teams/{id}/channels/{id}/messages e /chats/{id}/messages recurso.

Observação

/teams/getAllMessages, /chats/getAllMessages, /me/chats/getAllMessages, , /users/{id}/chats/getAllMessagese /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages são APIs limitadas; modelos de pagamento e requisitos de licenciamento podem ser aplicados . /teams/getAllMessages e /chats/getAllMessages dar suporte a model=A modelos de model=B pagamento, /me/chats/getAllMessages, , /users/{id}/chats/getAllMessagese /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages dar suporte apenas model=Ba . Se você não especificar um modelo de pagamento em sua consulta, o modo de avaliação padrão será usado.

Observação

Para adicionar ou alterar um modelo de pagamento para um recurso inscrito de uma notificação de alteração, você deve criar uma nova assinatura de notificação de alteração com o novo modelo de pagamento; A atualização de uma notificação de alteração existente não funciona.

conversationMember

as assinaturas conversationMember podem ser especificadas para incluir dados de recurso. Se especificado para incluir dados de recurso (includeResourceData definido como true), encryption é necessária. A criação de assinatura falhará se um encryptionCertificate não for especificado.

Observação

/teams/getAllMembers, /chats/getAllMemberse /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers são APIs limitadas; modelos de pagamento e requisitos de licenciamento podem ser aplicados . /teams/getAllMemberse /chats/getAllMembers dar suporte a model=A modelos de pagamento e .model=B /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers dá suporte apenas model=Ba . Se você não especificar um modelo de pagamento em sua consulta, o modo de avaliação padrão será usado.

Observação

team, channel e chat

assinaturas de equipe, canal e chat podem ser especificadas para incluir dados de recurso. Se especificado para incluir dados de recurso (includeResourceData definido como true), encryption é necessária. A criação de assinatura falhará se um encryptionCertificate não for especificado.

Observação

/appCatalogs/teamsApps/{id}/installedToChats tem requisitos de licenciamento e pagamento, especificamente com suporte apenas model=B. Se nenhum modelo for especificado, o modo de avaliação será usado.

Observação

Exemplo de solicitação

Especifique o parâmetro de consulta model na propriedade recurso no corpo da solicitação.

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

Solicitação HTTP

POST /subscriptions/{subscriptionsId}/reauthorize

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se tiver êxito, esta ação retornará um código de resposta 204 No Content.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/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();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


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

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.



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

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



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

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


// 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();

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

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

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


<?php
use Microsoft\Graph\GraphServiceClient;


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


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

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


Import-Module Microsoft.Graph.ChangeNotifications

Invoke-MgReauthorizeSubscription -SubscriptionId $subscriptionId

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


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

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

assinatura: reautorizar

Permissões

chatMessage

conversationMember

team, channel e chat

Exemplo de solicitação

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplos

Solicitação

Resposta

Comentários

Comentários

Recursos adicionais