Compartilhar via

Referência de Manifesto da Extensão

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022

Cada extensão tem um arquivo de manifesto JSON que define informações básicas sobre a extensão. O arquivo também define como ele pode estender e aprimorar a experiência. Este artigo mostra como criar um manifesto para sua extensão para Azure DevOps.

Dica

Confira nossa documentação mais recente sobre o desenvolvimento de extensão usando o SDK da Extensão do Azure DevOps.

Crie um arquivo nomeado vss-extension.json na raiz da pasta de extensão. Esse arquivo contém atributos necessários, como a ID da extensão e seus destinos de instalação, onde ela pode ser executada. Isso também define as contribuições que estão sendo feitas pela sua extensão.

Veja o exemplo a seguir de um manifesto típico:

{
    "manifestVersion": 1,
    "id": "tools",
    "version": "0.1.0",
    "name": "Fabrikam Tools",
    "publisher": "fabrikam",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],
    "icons": {
        "default": "images/fabrikam-logo.png"
    },
    "scopes": [
        "vso.work",
        "vso.code_write",
        "vso.build_execute"
    ],
    "categories": [
        "Azure Boards"
    ],
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    },
    "content": {
        "details": {
            "path": "readme.md"
        },
        "license": {
            "path": "eula.md"
        }
    },
    "links": {
        "getstarted": {
            "uri": "https://www.fabrikam-fiber-inc.com/help/getstarted"
        },
        "support": {
            "uri": "https://www.fabrikam-fiber-inc.com/support"
        }
    },
    "repository": {
        "type": "git",
        "uri": "https://github.com/fabrikam-fiber-inc/myextension"
    },
    "contributions": [
        {
            "id": "showCommits",
            "type": "ms.vss-web.action",
            "description": "Adds a menu action from builds grid to show associated items.",
            "targets": [
                "ms.vss-build-web.completed-build-menu"
            ],
            "properties": {
                "title": "View associated items",
                "uri": "launch.html"
            }
        }
    ],
    "files": [
        {
            "path": "launch.html",
            "addressable": true
        },        
        {
            "path": "node_modules/vss-web-extension-sdk/lib",
            "addressable": true,
            "packagePath": "lib"
        }
    ]
}

Para obter informações sobre entradas, consulte ...

Atributos necessários

As seguintes propriedades são necessárias:

Propriedade Descrição Observações
manifestVersion Um número correspondente à versão do formato do manifesto. Deve ser 1.
ID O identificador da extensão. A ID é uma cadeia de caracteres que deve ser exclusiva entre extensões do mesmo editor. Ele deve começar com um caractere alfabético ou numérico e conter 'A' a 'Z', 'a' a 'z', '0' a '9' e '-' (hífen). Exemplo: sample-extension.
version Uma cadeia de caracteres que especifica a versão de uma extensão. Deve estar no formato major.minor.patch, por exemplo 0.1.2 , ou 1.0.0. Você também pode adicionar um quarto número para o seguinte formato: 0.1.2.3
nome Um nome curto e legível da extensão. Limitado a 200 caracteres. Exemplo: "Fabrikam Agile Board Extension".
Publicador O identificador do publicador. Esse identificador deve corresponder ao identificador sob o qual a extensão é publicada. Consulte Criar e gerenciar um editor.
Categorias Matriz de cadeias de caracteres que representam as categorias às quais sua extensão pertence. Pelo menos uma categoria deve ser fornecida e não há limite para quantas categorias você pode incluir. Valores válidos: Azure Repos, Azure Boards, Azure Pipelines, Azure Test Planse Azure Artifacts.

Observações:
    - Use a versão >=0.6.3 do tfx-cli se você estiver publicando a extensão programaticamente.
    - Se você estiver usando a extensão Azure DevOps Extension Tasks para publicar, verifique se sua versão é >= 1.2.8. Talvez seja necessário aprovar a atualização de extensão devido a alterações de escopo recentes.
    - As categorias mencionadas anteriormente estão nativamente presentes no Visual Studio Marketplace e no Azure DevOps Server 2019 & acima.
targets Os produtos e serviços suportados por sua integração ou extensão. Para obter mais informações, consulte destinos de instalação. Uma matriz de objetos, em que cada objeto tem um id campo indicando um dos seguintes:
    - Microsoft.VisualStudio.Services(extensões que funcionam com o Azure DevOps),
    - Microsoft.TeamFoundation.Server (extensão que funciona com o Azure DevOps Server)
    - Microsoft.VisualStudio.Services.Integration
    - Microsoft.TeamFoundation.Server.Integration (integrações que funcionam com o Azure DevOps Server)

Exemplos de atributos necessários

{
    "manifestVersion": 1,
    "id": "tools",
    "version": "0.1.0",
    "name": "Fabrikam Tools",
    "publisher": "fabrikam",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ]
}

Atributos opcionais

Atributos de tempo de execução

Propriedade Descrição Observações
escopos Uma matriz de escopos de autorização (cadeias de caracteres) listando as permissões exigidas por sua extensão. Por exemplo, vso.work e vs.code_write indicam que sua extensão precisa de acesso somente leitura a itens de trabalho e acesso de leitura/gravação ao código-fonte (e recursos relacionados). Os escopos são apresentados ao usuário quando a extensão é instalada. Para obter mais informações, consulte a lista completa de escopos.
Demandas Uma matriz de demandas (cadeias de caracteres) listando os recursos exigidos por sua extensão. Por exemplo, api-version/3.0 indica que sua extensão usa APIs da versão 3.0 e, portanto, não pode ser executada em produtos mais antigos que não dão suporte a essa versão. Para obter mais informações, consulte a lista completa de demandas.
baseUri (Opcional) URL base para todos os URLs relativos especificados pelas contribuições da extensão. Por exemplo: https://myapp.com/{{account.name}}/. Essa propriedade deve ser deixada vazia se o conteúdo da extensão for empacotado com a extensão.
Contribuições Uma série de contribuições para o sistema.
tipos de contribuição Uma matriz de tipos de contribuição definidos pela extensão 
{
    "scopes": [
        "vso.work",
        "vso.code_write",
        "vso.build_execute"
    ],
    "demands": [
        "api-version/3.0"
    ],
    "contributions": [
        {
            "id": "showCommits",
            "type": "ms.vss-web.action",
            "description": "Adds a menu action from builds grid to show associated items.",
            "targets": [
                "ms.vss-build-web.completed-build-menu"
            ],
            "properties": {
                "title": "View associated items",
                "uri": "launch.html"
            }
        }
    ]
}

Atributos de descoberta

As seguintes propriedades opcionais ajudam os usuários a descobrir e aprender sobre sua extensão:

Propriedade Descrição Observações
descrição Algumas frases descrevendo as extensões. Limitado a 200 caracteres. A descrição deve ser a "apresentação de elevador" da sua extensão – algumas linhas para descrever sua extensão no Marketplace e fazer com que as pessoas queiram instalá-la. Veja o exemplo abaixo
Ícones Dicionário de ícones que representam a extensão. Chaves válidas: default (128x128 pixels) do tipo BMP, GIF, EXIF, JPG, PNG e TIFF). Outras chaves, como large (512x512 pixels), podem ser suportadas no futuro. O valor de cada chave é o caminho para o arquivo de ícone na extensão
Tags Matriz de tags de string para ajudar os usuários a encontrar sua extensão. Exemplos: agile, project management, task timere assim por diante.
Capturas de tela Matriz de imagens que não puderam ser incluídas em seu conteúdo. As capturas de tela são mais valiosas quando apresentadas em seu conteúdo e devem ser usadas para ajudar a criar uma página de detalhes de mercado de qualidade para sua extensão. Use capturas de tela para imagens menos importantes não apresentadas em seu conteúdo. Cada imagem deve ter 1366x768 pixels. O path de cada item é o caminho para o arquivo na extensão.
conteúdo Dicionário de arquivos de conteúdo que descrevem sua extensão para os usuários. Cada extensão deve incluir conteúdo sólido. É assim que você mostrará aos usuários o que sua extensão pode fazer. Torne-o rico, consumível e inclua capturas de tela quando necessário. Inclua um overview.md arquivo como sua parte de conteúdo base. Supõe-se que cada arquivo esteja no formato GitHub Flavored Markdown . O path de cada item é o caminho para o arquivo Markdown na extensão. Chaves válidas: details. Outras chaves podem ser compatíveis no futuro.
Links Dicionário de links que ajudam os usuários a saber mais sobre sua extensão, obter suporte e mover. Chaves válidas: getstarted - primeiros passos, como configurar ou usar. learn - Conteúdo mais profundo para ajudar os usuários a entender melhor sua extensão ou serviço. license - Contrato de licença de usuário final. privacypolicy - Política de privacidade para uma extensão. support - Obtenha ajuda e suporte para uma extensão. O valor de cada chave é um objeto com um uri campo, que é a URL absoluta do link
repositório Dicionário de propriedades que descrevem o repositório de código-fonte para a extensão Chaves válidas: type - Tipo de repositório. Exemplo: git. uri - URL absoluta do repositório.
Emblemas Matriz de links para selos de metadados externos, como TravisCI, Appveyor e assim por diante, nos sites de selos aprovados Chaves válidas: href - Link para o qual o usuário navega ao selecionar o distintivo. uri - O URL absoluto da imagem do selo a ser exibida. description – Descrição do selo, que é exibida ao passar o mouse.
Marca Dicionário de propriedades relacionadas à marca. Chaves válidas: color - cor primária da extensão ou editor; pode ser um hexadecimal (#ff00ff), RGB (rgb(100,200,50)) ou nomes de cores HTML suportados (azul). theme - complementa a cor; use escuro para cores de marca escuras, ou claro para cores de marca mais claras.

Marcar uma extensão como pública

Por padrão, todas as extensões no Azure DevOps Marketplace são privadas. Eles estão escondidos da vista pública e só são visíveis para o publicador e contas específicas compartilhadas pelo publicador. Se o seu editor for verificado, você pode tornar sua extensão pública configurando o sinalizador Public no manifesto da extensão:

{
    "galleryFlags": [
        "Public"
    ]
}

Ou:

{
    "public": true
}

Para obter mais informações, consulte Pacote/Publicação/Instalação.

Marcar uma extensão para estar em versão prévia

Se sua extensão estiver pronta para os usuários do Marketplace experimentarem, mas você ainda estiver resolvendo alguns bugs ou adicionando funções, marque-a como preview:

{
    "galleryFlags": [
        "Preview"
    ]
}

Marcar uma extensão como prévia paga

Se você pretende vender sua extensão no Marketplace, marque-a como prévia paga. Uma extensão marcada como gratuita não pode ser alterada para paga.

{
    "galleryFlags": [
        "Paid",
        "Preview"
    ]
}

Marcar uma extensão como paga

Se você quiser vender sua extensão no Marketplace, poderá marcá-la com a bandeira Paid e a tag __BYOLENFORCED (começa com dois sublinhados):

{
    "galleryFlags": [
        "Paid"        
    ],
     "tags": [        
        "__BYOLENFORCED"
    ]
}

Tanto a bandeira Paid quanto a etiqueta __BYOLENFORCED precisam estar presentes para marcar uma extensão como paga no Marketplace. BYOL (Bring-Your-Own-License) significa que o editor da extensão fornece o mecanismo de cobrança e licenciamento para a extensão, pois ela não é fornecida pela Microsoft para extensões do Azure DevOps. Todas as extensões pagas são necessárias para definir a política de privacidade, a política de suporte e um contrato de licença de usuário final. Os editores devem fornecer conteúdo para a guia de preços no Marketplace da seguinte maneira:

{
    "content": {
        "details": {
            "path": "overview.md"
        }, 
        "pricing": {
            "path": "pricing.md"
        }
    }
}

Você também precisa adicionar uma nova seção ao manifesto da extensão para substituir o licenciamento pago. No futuro, removeremos a verificação de licenciamento pago e não exigiremos mais a substituição. Por enquanto, certifique-se de que sua extensão seja exibida conforme o esperado. Cada substituição consiste em uma "ID" e um "comportamento". A "ID" deve corresponder à ID das contribuições definidas no manifesto.

"licensing": {

      "overrides": [

        { "id": "my-hub", "behavior": " AlwaysInclude" }
      ]
    }

Se sua extensão BYOL paga oferecer um período de avaliação (recomendamos isso), você poderá especificar a duração da avaliação em dias:

{
    "galleryproperties": {
        "trialDays": "30"
    } 
}

Observação

Se quiser mapear para o Azure DevOps, mas não desejar exibir uma opção de Download para sua extensão, adicione a marcação __DoNotDownload (inicia com dois sublinhados) ao manifesto da extensão. Se você estiver movendo uma extensão da cobrança e licenciamento, oferecidos anteriormente pela Microsoft, para o modelo BYOL, entre em contato conosco para obter as etapas adequadas.

Exemplo de mais propriedades

{
    "description": "Awesome tools to help you and your team do great things everyday.",
    "icons": {
        "default": "images/fabrikam-logo.png"
    },
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "license-terms.md"
        }
    },
    "links": {
        "home": {
            "uri": "https://www.fabrikam-fiber-inc.com"
        },
        "getstarted": {
            "uri": "https://www.fabrikam-fiber-inc.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.fabrikam-fiber-inc.com/features"
        },
        "support": {
            "uri": "https://www.fabrikam-fiber-inc.com/support"
        },
        "repository": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools"
        },
        "issues": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools/issues"
        }
    },
    "repository": {
        "type": "git",
        "uri": "https://github.com/fabrikam-fiber-inc/tools"
    },
    "badges": [
        {
            "href": "https://travis.ci/fabrikam-fiber-inc/myextension",
            "uri": "https://travis.ci/fabrikam-fiber-inc/myextension.svg?branch=master",
            "description": "TravisCI build for the project"
        },
        {
            "href": "https://ci.appveyor.com/projects/fabrikam-fiber-inc/myextension",
            "uri": "https://ci.appveyor.com/api/projects/status/vlg2sgs2y7tsdxpj4c?svg=true",
            "description": "AppVeyor build for the project"
        }
    ],
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    },
    "screenshots": [
        {
            "path": "screenshots/screen1.png"
        },
        {
            "path": "screenshots/screen2.png"
        }
    ]
}

Exemplo de página de detalhes

  • 1 - Descrição
  • 2 - ícone
  • 3 - Categorias
  • 4 - capturas de tela
  • 5 - Conteúdo (detalhes)
  • 6 – links
  • 7 - Branding

cartão

Perguntas e respostas do Marketplace - Atributo CustomerQnASupport

Todas as extensões no Visual Studio Marketplace têm uma seção de Perguntas e Respostas (P e R) para permitir conversas públicas individuais entre usuários de extensão e editores. Os editores podem escolher entre perguntas e respostas do Marketplace, problemas do GitHub ou uma URL de perguntas e respostas personalizada. Você pode desabilitar Perguntas e Respostas no Marketplace usando a propriedade CustomerQnASupport no manifesto.

Experiência padrão (nenhuma alteração no manifesto é necessária)

  • Para extensões com um repositório GitHub, o Marketplace redireciona os usuários na seção de Perguntas e Respostas para os problemas associados do GitHub.
  • Para extensões sem um repositório GitHub, as Perguntas e Respostas do Marketplace estão habilitadas.

Para uma experiência diferente das opções padrão, use a propriedade CustomerQnASupport no manifesto.

{
    "CustomerQnASupport": {
        "enablemarketplaceqna": true,
        "url": "http://uservoice.visualstudio.com"
    } 
}

Propriedades

Propriedades da seção Suporte de perguntas e respostas do cliente:

  • enablemarketplaceqna - campo booleano, definido como true para marketplace ou perguntas e respostas personalizadas; false para desabilitar perguntas e respostas
  • url - string, URL para perguntas e respostas personalizadas

Exemplos que mostram o uso do suporte de perguntas e respostas

Exemplo: extensão usando perguntas e respostas personalizadas

{
     "CustomerQnASupport": {
        "enablemarketplaceqna":"true",
        "url": "http://uservoice.visualstudio.com"
    } 
}

Exemplo: extensão com repositório GitHub, mas usando perguntas e respostas do Marketplace em vez de problemas do GitHub

{
     "CustomerQnASupport": {
        "enablemarketplaceqna":"true"
    } 
}

Exemplo: extensão desativando a seção de perguntas e respostas

{
     "CustomerQnASupport": {
        "enablemarketplaceqna":"false"
    } 
}

Escopos

Em sua extensão, você pode definir um ou mais escopos. Esses escopos determinam quais recursos sua extensão pode acessar e as operações permitidas para executar nesses recursos. Os escopos especificados no manifesto da extensão são os escopos definidos nos tokens de acesso emitidos para a extensão. Para obter mais informações, consulte Autenticação e segurança.

Se nenhum escopo for especificado, as extensões receberão apenas acesso ao perfil do usuário e aos dados de extensão.

Escopos com suporte

Categoria Scope Nome Privilégio alto Descrição Herda de
Segurança avançada vso.advsec Segurança avançada (leitura) Sim Concede a capacidade de ler alertas, instâncias de resultados e instâncias de resultados de análise.
vso.advsec_write Segurança avançada (leitura e gravação) Sim Concede a capacidade de carregar análises no serif. vso.advsec
vso.advsec_manage Segurança avançada (leitura, gravação e gerenciamento) Sim Concede a capacidade de carregar análises no serif. vso.advsec_write
Pools de agentes vso.agentpools Pools de agentes (leitura) Concede a capacidade de visualizar tarefas, pools, filas, agentes e trabalhos em execução ou concluídos recentemente para agentes.
vso.agentpools_manage Pools de agentes (ler e gerenciar) Sim Concede a capacidade de gerenciar pools, filas e agentes. vso.agentpools
vso.environment_manage Ambiente (ler e gerenciar) Sim Concede a capacidade de gerenciar pools, filas, agentes e ambientes. vso.agentpools_manage
Análises de dados vso.analytics Análise (leitura Concede a capacidade de consultar dados de análise.
Auditing vso.auditlog Log de auditoria (leitura) Concede a capacidade de ler o log de auditoria aos usuários.
vso.auditstreams_manage Fluxos de auditoria (leitura) Sim Concede a capacidade de gerenciar fluxos de auditoria aos usuários. vso.auditlog
Construir vso.build Build (leitura) Concede a capacidade de acessar artefatos de compilação, incluindo resultados de compilação, definições e solicitações, e a capacidade de receber notificações sobre eventos de compilação por meio de hooks de serviço. vso.hooks_write
vso.build_execute Build (leitura e execução) Sim Concede a capacidade de acessar artefatos de build, incluindo resultados de build, definições e solicitações. Também concede a capacidade de enfileirar um build, atualizar propriedades de build e receber notificações sobre eventos de build por meio de ganchos de serviço. vso.build
Code vso.code Código (leitura) Concede a capacidade de ler código-fonte e metadados sobre confirmações, conjuntos de alterações, ramificações e outros artefatos de controle de versão. Também concede a capacidade de pesquisar código e receber notificações sobre eventos de controle de versão por meio de integrações de serviço. vso.hooks_write
vso.code_write Código (leitura e escrita) Sim Concede a capacidade de ler, atualizar e excluir o código-fonte e acessar metadados sobre commits, conjuntos de alterações, branches e outros artefatos de controle de versão. Também concede a capacidade de criar e gerenciar solicitações de pull e revisões de código e receber notificações sobre eventos de controle de versão por meio de ganchos de serviço. vso.code
vso.code_manage Código (leitura, gravação e gerenciamento) Sim Concede a capacidade de ler, atualizar e excluir código-fonte, acessar metadados sobre confirmações, conjuntos de alterações, ramificações e outros artefatos de controle de versão. Também concede a capacidade de criar e gerenciar repositórios de código, criar e gerenciar solicitações de pull e revisões de código e receber notificações sobre eventos de controle de versão por meio de ganchos de serviço. vso.code_write
vso.code_full Código (completo) Sim Concede acesso total ao código-fonte, metadados sobre confirmações, conjuntos de alterações, ramificações e outros artefatos de controle de versão. Também concede a capacidade de criar e gerenciar repositórios de código, criar e gerenciar solicitações de pull e revisões de código e receber notificações sobre eventos de controle de versão por meio de ganchos de serviço. Também inclui suporte limitado para APIs OM do cliente. vso.code_manage
vso.code_status Código (status) Concede a capacidade de ler e gravar status de confirmação e solicitação de pull.
Servidor conectado vso.connected_server Servidor conectado Permite acessar os endereços finais necessários de um servidor conectado localmente.
Direitos vso.entitlements Direitos (leitura) Concede acesso somente leitura a pontos de extremidade de direitos de licenciamento para obter direitos de conta.
vso.memberentitlementmanagement Gerenciamento de direitos de membro (leitura) Concede a capacidade de ler usuários, suas licenças e os projetos e extensões que eles podem acessar.
vso.memberentitlementmanagement_write Gerenciamento de direitos de membro (gravação) Sim Concede a capacidade de gerenciar usuários e suas licenças e os projetos e extensões que eles podem acessar. vso.memberentitlementmanagement
Extensions vso.extension Extensões (leitura) Concede a capacidade de ler extensões instaladas. vso.profile
vso.extension_manage Extensões (leitura e gerenciamento) Sim Concede a capacidade de instalar, desinstalar e executar outras ações administrativas em extensões instaladas. vso.extension
vso.extension.data Dados de extensão (leitura) Concede a capacidade de ler dados (configurações e documentos) armazenados por extensões instaladas. vso.profile
vso.extension.data_write Dados de extensão (leitura e gravação) Concede a capacidade de ler e gravar dados (configurações e documentos) armazenados por extensões instaladas. vso.extension.data
Conexões do GitHub vso.githubconnections Conexões do GitHub (leitura) Concede a capacidade de ler conexões do GitHub e dados de repositórios do GitHub.
vso.githubconnections_manage Conexões do GitHub (ler e gerenciar) Sim Concede a capacidade de ler e gerenciar conexões do GitHub e dados de repositórios do GitHub. vso.githubconnections
Grafo e identidade vso.graph Gráfico (leitura) Concede a capacidade de ler informações de usuário, grupo, escopo e associação de grupo.
vso.graph_manage Gráfico (gerenciamento) Sim Concede a capacidade de ler informações de usuário, grupo, escopo e associação de grupo, adicionar usuários e grupos e gerenciar associações de grupo. vso.graph
vso.identity Identidade (leitura) Concede a capacidade de ler identidades e grupos.
vso.identity_manage Identidade (gerenciar) Sim Concede a capacidade de ler, gravar e gerenciar identidades e grupos. vso.identity
Grupo de computadores vso.machinegroup_manage Grupo de implantação (leitura, gerenciamento) Sim Concede a capacidade de gerenciar grupos de implantação e pools de agentes. vso.agentpools_manage
Marketplace vso.gallery Marketplace Concede acesso de leitura a itens públicos e privados e a editores. vso.profile
vso.gallery_acquire Marketplace (aquisição) Concede acesso de leitura e a capacidade de adquirir itens. vso.gallery
vso.gallery_publish Marketplace (publicação) Sim Concede acesso de leitura e a capacidade de carregar, atualizar e compartilhar itens. vso.gallery
vso.gallery_manage Marketplace (gerenciar) Sim Concede acesso de leitura e a capacidade de publicar e gerenciar itens e editores. vso.gallery_publish
Notifications vso.notification Notificações (lidas) Concede acesso de leitura a assinaturas e metadados de evento, incluindo valores de campo filtrados. vso.profile
vso.notification_write Notificações (escrever) Concede acesso de leitura e gravação a assinaturas e acesso de leitura a metadados de evento, incluindo valores de campo filtrados. vso.notification
vso.notification_manage Notificações (gerenciar) Concede acesso de leitura, gravação e gerenciamento a assinaturas e acesso de leitura a metadados de evento, incluindo valores de campo filtrados. vso.notification_write
vso.notification_diagnostics Notificações (diagnóstico) Concede acesso aos logs de diagnóstico relacionados à notificação e concede a capacidade de habilitar o diagnóstico para assinaturas individuais. vso.notification
Empacotamento vso.packaging Empacotamento (leitura) Concede a capacidade de ler feeds e pacotes. vso.profile
vso.packaging_write Empacotamento (leitura e gravação) Sim Permite a capacidade de criar e ler feeds e pacotes. vso.packaging
vso.packaging_manage Empacotamento (leitura, gravação e gerenciamento) Sim Concede a capacidade de criar, ler, atualizar e excluir feeds e pacotes. vso.packaging_write
Recursos de pipeline vso.pipelineresources_use Recursos de pipeline (uso) Sim Concede a capacidade de aprovar a solicitação de um pipeline para usar um recurso protegido: pool de agentes, ambiente, fila, repositório, arquivos seguros, conexão de serviço e grupo de variáveis.
vso.pipelineresources_manage Recursos de pipeline (usar e gerenciar) Sim Concede a capacidade de gerenciar um recurso protegido ou a solicitação de um pipeline para usar um recurso protegido: pool de agentes, ambiente, fila, repositório, arquivos seguros, conexão de serviço e grupo de variáveis. vso.pipelineresources_use
Projeto e equipe vso.project Projeto e equipe (leitura) Concede a capacidade de ler projetos e equipes.
vso.project_write Projeto e equipe (leitura e gravação) Concede a capacidade de ler e atualizar projetos e equipes. vso.project
vso.project_manage Projeto e equipe (ler, gravar e gerenciar) Sim Concede a capacidade de criar, ler, atualizar e excluir projetos e equipes. vso.project_write
Versão vso.release Liberar (leitura) Concede a capacidade de ler artefatos de versão, incluindo versões, definições de versão e ambiente de versão. vso.profile
vso.release_execute Versão (leitura, gravação e execução) Sim Concede a capacidade de ler e atualizar artefatos de versão, incluindo versões, definições de versão e ambiente de versão. Também concede a capacidade de enfileirar uma nova versão. vso.release
vso.release_manage Versão (ler, gravar, executar e gerenciar) Sim Concede a capacidade de ler, atualizar e excluir artefatos de versão, incluindo versões, definições de versão e ambiente de versão. Também concede a capacidade de fazer fila e aprovar uma nova versão. vso.release_execute
Arquivos seguros vso.securefiles_read Arquivos seguros (leitura) Sim Concede a capacidade de ler arquivos seguros.
vso.securefiles_write Proteger arquivos (ler e criar) Sim Concede a capacidade de ler e criar arquivos seguros. vso.securefiles_read
vso.securefiles_manage Proteger arquivos (ler, criar e gerenciar) Sim Concede a capacidade de ler, criar e gerenciar arquivos seguros. vso.securefiles_write
Segurança vso.security_manage Segurança (gerenciar) Sim Concede a capacidade de ler, gravar e gerenciar permissões de segurança.
Conexões de serviço vso.serviceendpoint Pontos de extremidade de serviço (leitura) Permite a leitura de pontos de extremidade de serviço. vso.profile
vso.serviceendpoint_query Pontos de extremidade de serviço (leitura e consulta) Concede a capacidade de ler e consultar pontos de extremidade de serviço. vso.serviceendpoint
vso.serviceendpoint_manage Pontos de extremidade de serviço (ler, consultar e gerenciar) Sim Concede a capacidade de ler, consultar e gerenciar pontos de extremidade de serviço. vso.serviceendpoint_query
Ganchos de serviço vso.hooks Hooks de serviço (leitura) Concede a capacidade de ler assinaturas e metadados de hooks de serviço, incluindo eventos, consumidores e ações compatíveis. (Não é mais público.) vso.profile
vso.hooks_write Hooks de serviço (leitura e gravação) Concede a capacidade de criar e atualizar assinaturas de hooks de serviço e ler metadados, incluindo eventos, consumidores e ações compatíveis. (Não é mais público.) vso.hooks
vso.hooks_interact Hooks de serviço (interação) Concede a capacidade de interagir e executar ações em eventos recebidos por meio de hooks de serviço. (Não é mais público.) vso.profile
Configurações vso.settings Configurações (leitura) Concede a capacidade de ler configurações.
vso.settings_write Configurações (leitura e gravação) Concede a capacidade de ler e gravar configurações. vso.settings
Símbolos vso.symbols Símbolos (leitura) Concede a capacidade de ler símbolos. vso.profile
vso.symbols_write Símbolos (leitura e gravação) Concede a capacidade de ler e escrever símbolos. vso.symbols
vso.symbols_manage Símbolos (ler, gravar e gerenciar) Concede a capacidade de ler, escrever e gerenciar símbolos. vso.symbols_write
Grupos de tarefas vso.taskgroups_read Grupos de tarefas (leitura) Concede a capacidade de ler grupos de tarefas.
vso.taskgroups_write Grupos de tarefas (ler e criar) Concede a capacidade de ler e criar grupos de tarefas. vso.taskgroups_read
vso.taskgroups_manage Grupos de tarefas (ler, criar e gerenciar) Sim Concede a capacidade de ler, criar e gerenciar grupos de tarefas. vso.taskgroups_write
Painel de equipe vso.dashboards Painéis de equipe (leitura) Concede a habilidade de ler informações do painel de equipe.
vso.dashboards_manage Painéis de equipe (gerenciar) Concede a capacidade de gerenciar informações do painel da equipe. vso.dashboards
Gerenciamento de teste vso.test Gerenciamento de testes (leitura) Concede a capacidade de ler planos de teste, casos, resultados e outros artefatos relacionados ao gerenciamento de teste. vso.profile
vso.test_write Gerenciamento de testes (leitura e gravação) Concede a capacidade de ler, criar e atualizar planos de teste, casos, resultados e outros artefatos relacionados ao gerenciamento de teste. vso.test
Threads vso.threads_full Threads de PR Concede a capacidade de ler e escrever em tópicos de comentários de solicitação de pull.
Tokens vso.tokens Tokens de autorização delegados Sim Concede a capacidade de gerenciar tokens de autorização delegada aos usuários.
vso.tokenadministration Administração de token Sim Concede a capacidade de gerenciar (visualizar e revogar) tokens existentes aos administradores da organização.
Perfil do usuário vso.profile Perfil do usuário (leitura) Concede a capacidade de ler seu perfil, contas, coleções, projetos, equipes e outros artefatos organizacionais de nível superior.
vso.profile_write Perfil do usuário (escrever) Concede a capacidade de escrever em seu perfil. vso.profile
Grupos de variáveis vso.variablegroups_read Grupos de variáveis (leitura) Concede a capacidade de ler grupos de variáveis.
vso.variablegroups_write Grupos de variáveis (ler e criar) Concede a capacidade de ler e criar grupos de variáveis. vso.variablegroups_read
vso.variablegroups_manage Grupos de variáveis (ler, criar e gerenciar) Sim Concede a capacidade de ler, criar e gerenciar grupos de variáveis. vso.variablegroups_write
Wiki vso.wiki Wiki (leitura) Concede a capacidade de ler wikis, páginas wiki e anexos wiki. Também concede a capacidade de pesquisar páginas wiki.
vso.wiki_write Wiki (ler e escrever) Concede a capacidade de ler, criar e atualizar wikis, páginas wiki e anexos wiki. vso.wiki
Itens de trabalho vso.work Itens de trabalho (leitura) Concede a capacidade de ler itens de trabalho, consultas, placas, caminhos de área e iterações e outros metadados relacionados ao acompanhamento de itens de trabalho. Também concede a capacidade de executar consultas, pesquisar itens de trabalho e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço. vso.hooks_write
vso.work_write Itens de trabalho (leitura e gravação) Concede a capacidade de ler, criar e atualizar itens de trabalho e consultas, atualizar metadados do quadro, ler caminhos de área e iterações e outros metadados relacionados ao acompanhamento de item de trabalho, executar consultas e receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço. vso.work
vso.work_full Itens de trabalho (completos) Concede acesso total a itens de trabalho, consultas, listas de pendências, planos e metadados de acompanhamento de item de trabalho. Também concede a capacidade de receber notificações sobre eventos de item de trabalho por meio de ganchos de serviço. vso.work_write
Representação do usuário user_impersonation Representação do usuário Sim Concede acesso total às APIs REST do Visual Studio Team Services. Solicite ou consenta esse escopo com cuidado porque ele é muito poderoso.

O escopo da extensão publicada está sendo alterado

Você pode alterar o escopo de uma extensão publicada. Se você instalou anteriormente sua extensão (e autorizou o conjunto anterior de escopos), autorize os novos escopos antes de atualizar para a versão mais recente.

A seção Ação necessária do hub de configurações de extensão mostra a um usuário que, se houver, as extensões instaladas exigem autorização:

alteração de escopo

Um administrador pode então revisar e autorizar o novo conjunto de escopos:

caixa de diálogo de alteração de escopo

Destinos de instalação

Como o nome indica, os destinos de instalação definem os produtos e serviços em que você pode instalar sua extensão. Microsoft.VisualStudio.Services é o destino de instalação mais comum e indica que a extensão pode ser instalada no Azure DevOps.

Os destinos de instalação para uma extensão ou integração são especificados por meio do targets campo no manifesto.

Identificadores suportados para extensões:

  • Microsoft.VisualStudio.Services.Cloud: é instalado em Azure DevOps Services
  • Microsoft.TeamFoundation.Server: é instalado em Azure DevOps Server
  • Microsoft.VisualStudio.Services: instala-se em ambos. Atalho para Microsoft.VisualStudio.Services.Cloud e Microsoft.TeamFoundation.Server versão [14.2,)

Identificadores suportados para integrações:

  • Microsoft.VisualStudio.Services.Cloud.Integration: integra-se com Azure DevOps Services
  • Microsoft.TeamFoundation.Server.Integration: integra-se com Azure DevOps Server
  • Microsoft.VisualStudio.Services.Integration: integra-se com ambos. Atalho para Microsoft.VisualStudio.Services.Cloud.Integration e Microsoft.TeamFoundation.Server.Integration

Para obter mais informações, consulte Pontos de extensibilidade.

Exemplos de destinos de instalação

Exemplo: extensão que funciona com o Azure DevOps

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ]
}

Exemplo: extensão que funciona apenas com Azure DevOps Services

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Cloud"
        }
    ]
}

Os destinos de instalação também podem ser usados no manifesto de integrações. Por exemplo, produtos, aplicativos ou ferramentas que funcionam, mas não são instalados no Azure DevOps.

Exemplo: integração que funciona com o Azure DevOps

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ]
}

Exemplo: integração que só funciona com Azure DevOps Server

{
    "targets": [
        {
            "id": "Microsoft.TeamFoundation.Server.Integration"
        }
    ]
}

Versões de destino de instalação

Alguns identificadores de destino de instalação, como Microsoft.TeamFoundation.Server e Microsoft.TeamFoundation.Server.Integration, oferecem suporte a um intervalo de versão opcional. Esse intervalo de versões opcional esclarece ainda mais as versões com suporte nas quais a extensão ou integração é suportada.

A versão ou o intervalo de versões é especificado por meio do version campo no objeto de destino da instalação. Esse valor pode ser:

  • Uma versão específica, por exemplo: 15.0 (somente RTM 2017)
  • Uma variedade de versões com suporte, por exemplo: [14.0) (2015 RTM e posterior), [14.3,15.1] (Atualização 3 de 2015 a Atualização 1 de 2017). Os valores de intervalo são refinados usando:
    • [: versão mínima inclusive
    • ]: versão máxima inclusiva
    • (: versão mínima exclusiva
    • ): versão máxima exclusiva

Números de versão para Azure DevOps Server:

Versão Lançamentos Versão
2010 Todos os lançamentos 10.0
2012 Todos os lançamentos 11.0
2013 RTM e atualizações 12.0, 12.1, 12.2, 12.3, 12.4
2015 RTM e atualizações 14.0, 14.1, 14.2, 14.3
2017 RTM e atualizações 15.0, 15.1
2018 RTM e atualizações 16,0
2019 RTM e atualizações 17.0
2020 RTM e atualizações 18.0

Exemplos mostrando versões

Exemplo: extensão que funciona com o Azure DevOps

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Cloud"
        },
        {
            "id": "Microsoft.TeamFoundation.Server",
            "version": "[15.0,)"
        }
    ]
}

Atalhos

Microsoft.VisualStudio.Services é um atalho para o Azure DevOps.

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ]
}

é equivalente a:

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Cloud"
        },
        {
            "id": "Microsoft.TeamFoundation.Server",
            "version": "[14.2,)"
        }
    ]
}

Usando alvos e requisitos de instalação

Os destinos e as demandas de instalação são usados em conjunto para apresentar aos usuários uma exibição correta dos produtos e serviços com os quais sua extensão ou integração é compatível. Por exemplo, especificar um alvo de instalação de Microsoft.VisualStudio.Services com uma exigência de api-version/3.0 significa que a extensão funciona com o Azure DevOps.

Dica

Para obter mais informações sobre APIs REST, consulte a Referência da API REST.

Exemplo: extensão que usa APIs da versão 3.0

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],
    "demands": [
        "api-version/3.0"
    ]
}

Determina quais são os seguintes destinos de instalação:

  1. Microsoft.VisualStudio.Services.Cloud
  2. Microsoft.TeamFoundation.ServerVersão: [15.0,)

Exemplo: integração que usa APIs da versão 2.0

{
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services.Integration"
        }
    ],
    "demands": [
        "api-version/2.0"
    ]
}

Determina quais são os seguintes destinos de instalação:

  1. Microsoft.VisualStudio.Services.Cloud.Integration
  2. Microsoft.TeamFoundation.Server.IntegrationVersão: [14.0,)

Demandas

As demandas permitem que você especifique recursos e outros recursos exigidos por sua extensão. Você pode usar essas demandas para limitar onde sua extensão pode ser publicada ou instalada.

As demandas são usadas pelo Visual Studio Marketplace para listar os produtos e ambientes com os quais sua extensão é compatível, o que ajuda os clientes a entender se sua extensão funciona com sua versão do Azure DevOps, por exemplo.

Consulte o exemplo a seguir de como as demandas são especificadas no manifesto de extensão.

{
    "demands": [
        "api-version/3.0",
        "contribution/ms.vss-dashboards-web.widget-catalog"
    ]
}

Neste exemplo, a extensão exige a versão 3.0 das APIs, o que significa que ela só pode ser instalada no Azure DevOps. Ele também requer que a ms.vss-dashboards-web extensão (e sua widget-catalog contribuição) seja instalada (e habilitada) na coleção antes que sua extensão possa ser instalada.

Demandas suportadas

Tipo Descrição Verificado na publicação? Verificado na instalação?
environment/cloud Requer execução em um ambiente de nuvem Sim Sim
environment/onprem Requer execução em um ambiente local Sim Sim
api-version/{version} Requer uma versão específica da API (mínimo) Não Sim
extension/{id} Requer que uma extensão específica seja instalada/habilitada Não Sim
contribution/{id} Requer uma contribuição específica disponível Não Sim
contributionType/{id} Requer que um tipo de contribuição específico esteja disponível Não Sim

Observação

  • Use environment/cloud e environment/onprem somente quando sua extensão tiver requisitos relacionados à topologia que exijam execução nesse ambiente específico.
  • extension, contributione contributionType as demandas são avaliadas no momento da instalação e exigem que a extensão especificada já esteja instalada e habilitada na organização ou coleção.

Arquivos

A files seção é onde você faz referência a todos os arquivos que deseja incluir em sua extensão. Você pode adicionar pastas e arquivos individuais:

{
    "files": [
        {
            "path": "hello-world.html", "addressable": true
        },
        {
            "path": "scripts", "addressable": true
        },
        {
            "path": "images/logo.png", "addressable": true, "packagePath": "/"
        }
    ]
}

Propriedades

Propriedades da seção Arquivos:

  • path - Caminho para o recurso no disco, que pode ser relativo ao seu diretório raiz.
  • endereçável – (opcional) Defina como true se quiser que seu arquivo seja endereçável por URL. O padrão é falso.
  • packagePath – (opcional) Caminho para o recurso dentro do pacote. Volta ao padrão do caminho relativo no disco partindo do diretório raiz.
  • contentType – (opcional) tipo MIME do arquivo. Volta ao padrão de uma melhor estimativa com base na extensão do arquivo e nas configurações do sistema operacional.
  • assetType – (opcional) Especifique o valor do atributo Type da entrada de ativo no manifesto VSIX. Também pode ser uma matriz de strings, caso em que várias entradas de ativos são adicionadas a esse arquivo. Volta ao padrão do packagePath.
  • lang – (opcional) Idioma deste ativo. Os arquivos localizados são servidos com base no cabeçalho Accept-Language. Deixe em branco para indicar que esse arquivo está no idioma padrão (ou fallback). As versões localizadas do mesmo arquivo devem ter o mesmo assetType.

Contribuições

Cada entrada de contribuição tem as seguintes propriedades:

  • id - Uma ID de referência (cadeia de caracteres) para a contribuição. Torne cada ID de contribuição único dentro de uma extensão. Consulte as contribuições e tipos de referência.
  • type - A ID da contribuiçãoTipo dessa contribuição.
  • description - (Opcional) Uma string que descreve o que a contribuição está fornecendo.
  • destinos - Um conjunto de IDs de contribuição para os quais a contribuição está direcionada (contribuindo). Consulte Direcionamento de contribuições.
  • properties - (Opcional) Um objeto que inclui propriedades para a contribuição, conforme definido no tipo de contribuição.

Para obter mais informações, consulte a visão geral do modelo de contribuição.

Tipos de contribuição

Cada entrada de contribuição tem as seguintes propriedades:

  • id - Uma ID de referência (cadeia de caracteres) para o tipo de contribuição. Torne cada ID de tipo de contribuição único dentro de uma extensão. Consulte as contribuições e tipos de referência.
  • name - O nome amigável do tipo de contribuição.
  • description - (Opcional) Uma cadeia de caracteres que descreve com mais detalhes para que serve o tipo de contribuição.
  • properties - (Opcional) Um dicionário que mapeia nomes de propriedade para descrições de propriedade. Essas propriedades descrevem as propriedades obrigatórias e opcionais que as contribuições desse tipo podem usar.

As descrições de propriedades têm as seguintes propriedades:

  • description - (Opcional) Uma cadeia de caracteres que descreve para que a propriedade é usada.
  • required - (Opcional) Um valor booliano, que, se verdadeiro, indica que a propriedade é necessária para todas as contribuições desse tipo.
  • type - O tipo de valor que a propriedade pode ter, que pode ser cadeia de caracteres, uri, guid, booleano, inteiro, double, dateTime, matriz ou objeto.

Para obter mais informações, consulte a visão geral do modelo de contribuição.

Usando contribuições e tipos como referência

Use identificadores exclusivos para fazer referência a contribuições e tipos de contribuição. Faz referência a tipos com a propriedade type e faz referência a outras contribuições com a propriedade targets.

  • Uma referência de contribuição completa inclui o identificador do editor, o identificador da extensão e o identificador de contribuição/tipo, separados por um ponto (.). Por exemplo, ms.vss-web.hub é o identificador completo para a contribuição com o identificador de hub na extensão vss-web publicada pelo editor "ms" (Microsoft).
  • As referências de contribuição relativa podem ser usadas em um manifesto de extensão para a referência de uma contribuição a outra contribuição ou tipo de contribuição dentro dessa mesma extensão. Nesse caso, os identificadores do publicador e da extensão NÃO são incluídos e o identificador é um ponto (.) seguido pelo identificador de contribuição. Por exemplo, .hub pode ser usado dentro da vss-web extensão mencionada anteriormente como um atalho para ms.vss-web.hub.

Direcionamento de contribuições

Algumas contribuições atuam como contêineres que são destinos de outras contribuições.

  • As contribuições do hub podem ter como destino grupos de hub. Quando uma página é renderizada, a interface do usuário da Web mostra todas as contribuições do Hub direcionadas ao grupo de hub selecionado. Os grupos de hubs têm como alvo uma coleção de grupos de hubs, que define um conjunto de grupos de hubs que aparecem em uma determinada área de navegação, por exemplo, páginas de administração no nível do projeto.
  • Diferentes tipos de contribuições podem ter como alvo menus: ação, ação de hiperlink e provedor de ação. Ações e ações de hiperlink fornecem entradas únicas de item de menu. Um provedor de ação pode fornecer vários itens de menu dinâmicos. Para um determinado menu, os itens são agregados em todas as contribuições (de qualquer um desses tipos) que têm como alvo essa contribuição específica de menu.

Adicionando um ícone de hub

Para obter informações sobre como adicionar um ícone ao hub, confira as orientações sobre o ícone do hub.

Serviços de selos suportados

O Marketplace só dá suporte a selos dos seguintes serviços confiáveis:

  • api.travis-ci.org/
  • badge.fury.io/
  • badges.frapsoft.com/
  • badges.gitter.im/
  • badges.greenkeeper.io/
  • cdn.travis-ci.org/
  • ci.appveyor.com/
  • codeclimate.com/
  • codecov.io/
  • coveralls.io/
  • david-dm.org/
  • gemnasium.com/
  • img.shields.io/
  • isitmaintained.com/
  • marketplace.visualstudio.com/
  • snyk.io/
  • travis-ci.com/
  • travis-ci.org/
  • vsmarketplacebadges.dev/
  • bithound.io/
  • deepscan.io/
  • githost.io/
  • gitlab.com/
  • opencollective.co/

Observação

Substitua vsmarketplacebadge.apphb.com por vsmarketplacebadges.dev.

Para mostrar um selo de outro serviço, entre em contato com o Suporte ao cliente na Comunidade de desenvolvedores.

Exemplo de manifesto

A extensão a seguir contribui com uma ação para o menu de contexto de compilações concluídas e um hub para o grupo de hubs de compilação:

{
    "manifestVersion": 1,
    "id": "tools",
    "version": "0.1.0",
    "name": "Fabrikam Tools",
    "publisher": "fabrikam",
    "description": "Awesome tools to help you and your team do great things everyday.",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],
    "demands": [
        "api-version/3.0"
    ],
    "icons": {
        "default": "images/fabrikam-logo.png"
    },
    "scopes": [
        "vso.work",
        "vso.code_write"
    ],
    "categories": [
        "Plan and track"
    ],
    "tags": [
        "working",
        "people person",
        "search"
    ],
    "branding": {
        "color": "rgb(34, 34, 34)",
        "theme": "dark"
    },
    "screenshots": [
        {
            "path": "screenshots/screen1.png"
        },
        {
            "path": "screenshots/screen2.png"
        }
    ],
    "content": {
        "details": {
            "path": "overview.md"
        },
        "license": {
            "path": "eula.md"
        }
    },
    "links": {
        "home": {
            "uri": "https://www.fabrikam-fiber-inc.com"
        },
        "getstarted": {
            "uri": "https://www.fabrikam-fiber-inc.com/help/getstarted"
        },
        "learn": {
            "uri": "https://www.fabrikam-fiber-inc.com/features"
        },
        "support": {
            "uri": "https://www.fabrikam-fiber-inc.com/support"
        },
        "repository": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools"
        },
        "issues": {
            "uri": "https://github.com/fabrikam-fiber-inc/tools/issues"
        }
    },
    "repository": {
        "type": "git",
        "uri": "https://github.com/fabrikam-fiber-inc/myextension"
    },
    "badges": [
        {
            "href": "https://travis.ci/fabrikam-fiber-inc/myextension",
            "uri": "https://travis.ci/fabrikam-fiber-inc/myextension.svg?branch=master",
            "description": "TravisCI build for the project"
        },
        {
            "href": "https://ci.appveyor.com/projects/fabrikam-fiber-inc/myextension",
            "uri": "https://ci.appveyor.com/api/projects/status/vlg2sgs2y7tsdxpj4c?svg=true",
            "description": "AppVeyor build for the project"
        }
    ],
    "contributions": [
        {
            "id": "showCommits",
            "type": "ms.vss-web.action",
            "description": "Adds a menu action from builds grid to show associated items.",
            "targets": [
                "ms.vss-build-web.completed-build-menu"
            ],
            "properties": {
                "title": "View associated items",
                "uri": "launch.html"
            }
        }
    ]
}
  • Last updated on