Atualizar teamsApp

  • Artigo

Namespace: microsoft.graph

Atualize uma aplicação publicada anteriormente no catálogo de aplicações do Microsoft Teams. Para atualizar uma aplicação, a propriedade distributionMethod da aplicação tem de ser definida como organization.

Esta API atualiza especificamente uma aplicação publicada no catálogo de aplicações da sua organização (o catálogo de aplicações de inquilino).

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ❌

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

  • Apenas os administradores do Serviço Teams ou uma função com privilégios superiores podem chamar esta API.
Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) AppCatalog.Submit AppCatalog.ReadWrite.All, Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Observação

  • A permissão Directory.ReadWrite.All é suportada apenas para retrocompatibilidade. Recomendamos que você atualize suas soluções para usar uma permissão alternativa listada na tabela anterior e evite usar essas permissões daqui para frente.

Solicitação HTTP

POST /appCatalogs/teamsApps/{id}/appDefinitions

Parâmetros de consulta

Propriedade Tipo Descrição
requiresReview Booliano Este parâmetro de consulta opcional aciona o processo de revisão da aplicação. Os utilizadores com privilégios de administrador podem submeter aplicações sem acionar uma revisão. Se os utilizadores quiserem pedir uma revisão antes da publicação, têm de definir requiresReview como true. Um utilizador com privilégios de administrador pode optar por não definir requiresReview ou definir o valor como false e a aplicação é aprovada e imediatamente publicada.

Cabeçalhos de solicitação

Cabeçalho Valor
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type aplicação/zip. Obrigatório.

Corpo da solicitação

No corpo do pedido, inclua um payload de manifesto zip do Teams. Para obter detalhes, veja Criar um pacote de aplicação.

Nota: Utilize o ID devolvido da chamada Lista de aplicações publicadas para referenciar a aplicação que pretende atualizar. Não utilize o ID do manifesto do pacote da aplicação zip.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Exemplos

Exemplo 1: Atualizar uma aplicação publicada anteriormente no catálogo de aplicações do Microsoft Teams

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/06805b9e-77e3-4b93-ac81-525eb87513b8/appDefinitions
Content-type: application/zip

app.zip

Para obter detalhes sobre o ficheiro zip da aplicação Teams, veja Criar pacote de aplicação.

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content

Exemplo 2: Atualizar uma nova versão de uma aplicação existente para revisão de administrador antes da publicação no catálogo de inquilinos atual

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions?requiresReview=true
Content-type: application/zip

app.zip

Resposta

Se for bem-sucedido, este método devolve um 201 Created código de resposta e o par "publishingState": "submitted" chave-valor no corpo da resposta. Para obter detalhes, veja teamsAppDefinition.

HTTP/1.1 201 Created
Location: https://graph.microsoft.com/v1.0/appCatalogs/teamsApps/e3e29acb-8c79-412b-b746-e6c39ff4cd22/appDefinitions/MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==
Content-Type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#appDefinition",
    "@odata.etag": "158749010",
    "id": "MGQ4MjBlY2QtZGVmMi00Mjk3LWFkYWQtNzgwNTZjZGU3Yzc4IyMxLjAuMA==",
    "teamsAppId": "e3e29acb-8c79-412b-b746-e6c39ff4cd22",
    "displayName": "Test app",
    "version": "1.0.11",
    "azureADAppId": "a651cc7d-ec54-4fb2-9d0e-2c58dc830b0b",
    "requiredResourceSpecificApplicationPermissions":[
         "ChannelMessage.Read.Group",
         "Channel.Create.Group",
         "Tab.ReadWrite.Group",
         "Member.Read.Group"
    ],
    "publishingState": "submitted",
    "lastModifiedDateTime": "2020-02-10 22:48:33.841"
}

Conteúdo relacionado

Limites de limitação específicos do serviço do Microsoft Graph