Atualizar teamsApp

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualizar um aplicativo publicado anteriormente no catálogo de aplicativos do Microsoft Teams. Para atualizar um aplicativo, a propriedade distributionMethod do aplicativo deve ser definida como organization.

Essa API atualiza especificamente um aplicativo publicado no catálogo de aplicativos da sua organização (o catálogo de aplicativos de locatário).

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

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

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

  • Somente administradores de serviço do Teams ou uma função privilegiada superior podem chamar essa API.
Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
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 tem suporte apenas para compatibilidade com versões anteriores. 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 Esse parâmetro de consulta opcional dispara o processo de revisão do aplicativo. Usuários com privilégios de administrador podem enviar aplicativos sem disparar uma revisão. Se os usuários quiserem solicitar uma revisão antes da publicação, eles devem definir requiresReview como true. Um usuário com privilégios de administrador pode optar por não definir requiresReview ou definir o valor como false e o aplicativo é aprovado e publicado imediatamente.

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 application/zip. Obrigatório.

Corpo da solicitação

No corpo da solicitação, inclua um conteúdo de manifesto zip do Teams. Para obter detalhes, consulte Criar um pacote do aplicativo.

Observação: Use a ID retornada da chamada Lista de aplicativos publicados para fazer referência ao aplicativo que você deseja atualizar. Não use a ID do manifesto do pacote do aplicativo zip.

Resposta

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

Exemplos

Exemplo 1: Atualizar um aplicativo publicado anteriormente no catálogo de aplicativos do Microsoft Teams

Solicitação

O exemplo a seguir mostra uma solicitação.

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

app.zip

Para obter detalhes sobre o arquivo zip do aplicativo do Teams, consulte Criar pacote do aplicativo.

Resposta

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

HTTP/1.1 204 No Content

Exemplo 2: Atualizar uma nova versão de um aplicativo existente para revisão do administrador antes da publicação no catálogo de locatários atual

Solicitação

O exemplo a seguir mostra uma solicitação.

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

app.zip

Resposta

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

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

{
    "@odata.context": "https://graph.microsoft.com/beta/$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

  • Última atualização a