Atualizar uma assinatura

Atualiza uma assinatura de webhook em uma lista do SharePoint.

Permissões

A tabela de permissões do Suplemento do SharePoint abaixo é apenas de referência herdada. Use a autenticação do Microsoft Entra com suporte para webhooks do SharePoint Online.

Importante

Os suplementos do SharePoint atingiram o fim da vida útil no SharePoint Online em 2 de abril de 2026. Os suplementos hospedados no SharePoint e hospedados pelo provedor foram desativados e não funcionam mais no SharePoint Online, incluindo nuvens governamentais. As diretrizes de desenvolvimento, implantação e uso de suplementos são mantidas para referência histórica e para cenários aplicáveis do Servidor do SharePoint, não para novas soluções do SharePoint Online.

Os suplementos do Servidor do SharePoint implantados por meio de um catálogo de aplicativos local não são desativados por essa alteração. A aquisição de Suplementos do SharePoint do marketplace público terminou em 2 de abril de 2026 para o Servidor do SharePoint.

Essa desativação não desativa APIs REST do SharePoint, CSOM, JSOM ou SPFx (Estrutura do SharePoint). Para o SharePoint Online, use SPFx para extensões de interface do usuário e o Microsoft Entra ID para autenticação para aplicativos externos. Consulte o anúncio de desativação e as diretrizes de migração de suplemento.

O aplicativo deve ter pelo menos permissões de edição para a lista do SharePoint em que a assinatura será atualizada.

Se o aplicativo for um aplicativo do Microsoft Azure Active Directory (Azure AD)

Você deve conceder ao aplicativo do Azure AD as permissões especificadas na tabela a seguir. Uma assinatura só pode ser atualizada pelo aplicativo do Azure AD que a criou.

Aplicativo Permissão
Office 365 SharePoint Online Ler e gravar listas e itens em todos os conjuntos de sites.

Se o aplicativo for um suplemento do SharePoint

Você deve conceder ao suplemento do SharePoint as permissões a seguir ou superiores. Uma assinatura só pode ser atualizada pelo suplemento do SharePoint que a criou.

Escopo Direitos de permissão
Listar Gerenciar

Solicitação HTTP

PATCH _api/web/lists('list-id')/subscriptions('id')

Exemplo

PATCH _api/web/lists('5C77031A-9621-4DFC-BB5D-57803A94E91D')/subscriptions('6D77031A-2345-5GRT-BV3D-55234B56FR43')
Content-Type: application/json

{
  "notificationUrl": "https://contoso.azurewebsites.net/api/v2/webhook-receiver",
  "expirationDateTime": "2016-01-03T11:23:00.000Z"
}

Corpo da solicitação

Inclua as propriedades a seguir no corpo da solicitação.

Nome Tipo Descrição
notificationUrl cadeia de caracteres A URL de serviço à qual enviar notificações.
expirationDateTime data A data na notificação expirará e será excluída.
clientState string Opcional. Cadeia de caracteres opaca passada ao cliente em todas as notificações.
Você pode usar isso para validar notificações ou marcar assinaturas diferentes.

Resposta

Se a assinatura for encontrada e atualizada com êxito, uma resposta 204 No Content será retornada.

Exemplo

HTTP/1.1 204 No Content

Confira também

  • Última atualização em