Processo de análise de apps e requisitos para o Google Workspace Marketplace

• Os botões para se comunicar com o app estão disponíveis na descrição.
• O nome do app começa com A a Z (maiúscula) ou de 0 a 9. Ele não pode começar com um símbolo.

• O app envia uma mensagem de boas-vindas não solicitada sempre que um usuário inicia uma mensagem direta ou é adicionado a um espaço. A mensagem de boas-vindas é diferente do comando "Help". Para mais informações, consulte Criar a página inicial de um app do Google Chat.
• O app oferece suporte ao comando "Help" e ajuda os usuários a começar a usá-lo. Para mais informações, consulte Responder a comandos de barra (/).
• O app sempre responde quando alguém fala com ele em um espaço ou no Chat direto.
• As mensagens têm ortografia, pontuação, gramática e ortografia corretas. Elas não contêm material malicioso, ofensivo ou abusivo.
• As mensagens usam uma formatação clara, concisa e consistente para textos ou cards de acordo com os requisitos do Google.
• Se uma resposta demorar mais de dois segundos, o app vai enviar uma mensagem explicando o atraso.
• Os apps que enviam notificações permitem que os usuários as desativem.
• Os usuários podem adicionar o app a um espaço usando @menção.
• Os usuários podem remover o app de um espaço usando o menu Ver participante.
• O app indica ao usuário tudo o que é necessário para interagir com ele.
• O formato dos cards usados pelo app atende aos requisitos do Google. Consulte Crie cards interativos.
• O app está disponível na opção Encontrar apps no menu do Chat.
• Os URLs externos com que o app interage não pertencem a um ambiente de testes ou de desenvolvimento.
• A @menção é obrigatória em todas as mensagens enviadas ao app nos espaços. Essa é a única maneira de o app saber que precisa responder.
• Se o app Chat mostrar uma prévia de links de um domínio de terceiros:
  • As prévias de link oferecem informações complementares relevantes para a mensagem do usuário. Por exemplo, a visualização de um link para uma transação de vendas adiciona informações como conta, valor e fase.
  • O desenvolvedor é afiliado ao domínio visualizado.

  Para mais informações, consulte Link de visualização.

• (Recomendado) Para permitir que os administradores do Workspace instalem seu app em nome dos usuários da organização, ele precisa receber e enviar mensagens diretas.

• O app tem um avatar claro e reconhecível.

• O app não usa extensões do navegador Chrome para fornecer funcionalidade manipulando o HTML do Drive diretamente.
• Se o app usa escopos confidenciais ou restritos, ele precisa passar por uma verificação OAuth. Consulte Como enviar um app para verificação.
• Se o app usa escopos restritos, ele também precisa passar por uma avaliação de segurança. Consulte Por que a avaliação de segurança é necessária.

• Se o app armazena arquivos no Drive, ele permite que os usuários escolham uma pasta ou cria e reutiliza uma pasta específica do app. Os dados de configuração podem ser armazenados em uma pasta de dados do app. O app não armazena arquivos na pasta "Meu Drive" do usuário.
• O app só armazena arquivos no Drive conectados à funcionalidade documentada do app.

• As ações esperadas e necessárias estão incluídas no complemento, que oferece todas as ferramentas necessárias para concluir o fluxo de trabalho. Por exemplo:
  • Se o complemento aplicar o estilo a todo o documento, ele vai oferecer a opção de aplicar o estilo apenas ao texto selecionado.
  • Se o complemento fizer o upload de dados da planilha para um feed de serviço da Web, ele terá um link para esse feed, facilitando a navegação.
  • Se o complemento exigir que o usuário tenha uma conta, ele vai fornecer links ou informações para criar uma conta com facilidade se o usuário ainda não tiver uma.
• O complemento tem itens de menu na guia Complementos.
• Mesmo que o complemento seja apenas funções personalizadas, ele ainda inclui a documentação adequada.
• O complemento usa corretamente onInstall() e onOpen() para preencher o menu. Os itens do menu são preenchidos quando o complemento é instalado pela primeira vez e quando um arquivo diferente é aberto. Consulte Autorização do complemento do Editor.
• Os modos de autorização foram configurados corretamente. Consulte Modos de autorização.
• O complemento precisa ser implementado no tempo de execução do V8 do Apps Script. Para mais informações, consulte a Visão geral do ambiente de execução do V8.

• O complemento fornece todas as informações necessárias para que os usuários entendam as noções básicas do produto e como usá-lo.
• O código do complemento não usa bibliotecas excessivamente, já que elas podem fazer com que o complemento perca o desempenho.
• Se possível, os erros são evitados e gerenciados adequadamente. Caso contrário:
  • As mensagens de erro são exibidas em uma janela de diálogo, não em um alerta do JavaScript ou na barra vermelha padrão. Elas comunicam o problema e descrevem o que o usuário precisa fazer para corrigi-lo em um idioma simples.
  • Quando possível, se o usuário estiver fazendo algo errado, um botão será mostrado para corrigir o problema.
  • Para mais informações, consulte o guia de estilo de complementos.
• Os links para páginas externas são corretos e abrem em novas janelas.
• O complemento é intuitivo e bem projetado. Isso significa:
  • Está sempre claro o que fazer e como.
  • O complemento é acessível e simples de entender. Termos técnicos e jargões são evitados.
  • Os fluxos de trabalho são claros e facilitados o máximo possível.
  • O usuário e o conteúdo dele estão o mais seguros possível.
• O complemento segue o guia de estilo da interface para complementos do editor e usa o pacote CSS para complementos do editor.
• O complemento usa apenas uma ação primária azul por tela.
• O complemento mostra uma caixa de diálogo por vez. Ela não se sobrepõe nem tem várias caixas de diálogo abertas ao mesmo tempo.
• A interface do complemento se encaixa perfeitamente nos espaços alocados:
  • Textos e rótulos não são cortados com "…"
  • O usuário não precisa rolar muito na vertical.
  • A largura do conteúdo não se estende além de 300p para que não tenha uma barra de rolagem horizontal.
• O complemento exige confirmação ou mostra avisos para todas as ações sensíveis. Por exemplo, se o complemento estiver prestes a substituir todo o conteúdo de uma planilha, o usuário vai receber um aviso e confirmar a ação antes que ela aconteça.

  É possível evitar esse requisito com mudanças de design. Por exemplo, um complemento das Planilhas Google que importa dados cria o risco de substituir o conteúdo existente. Para eliminar o risco, crie uma planilha para os dados como ação padrão.

• Os usuários não podem acionar ações várias vezes enquanto uma ação está sendo carregada. Por exemplo, os botões são desativados ou ocultos enquanto uma ação está sendo carregada.

Complementos do Agenda

• Se o complemento usar calendar.name ou common.name, o nome no manifesto será idêntico ao nome fornecido na página de detalhes do app.
• Se o complemento usar calendar.conferenceSolution, o nome da solução de videoconferência não conterá “Google Agenda”.
• (recomendado): se o complemento usar calendar.conferenceSolution, o nome da solução de conferência não pode ter mais de 30 caracteres.

• O complemento usa os widgets corretos (ou a interface em iframe nos complementos do Meet) para a funcionalidade desejada. Por exemplo, use um switch para selecionar um valor booleano.

Complementos do Agenda

• As agendas secundárias e a delegação são compatíveis ou, se não forem, são gerenciadas sem problemas. Por exemplo, a criação de conferências não falha se o usuário selecionar uma agenda diferente em que tem acesso de edição ao criar um evento.
• Os eventos recorrentes funcionam corretamente.
• Se o complemento usa calendar.conferenceSolution, pelo menos uma solução de conferência é fornecida.
• Se o complemento oferece soluções de conferência, os campos de dados de conferência apropriados são usados. Por exemplo, links de videoconferência, números de telefone, links SIP, códigos de acesso e outros atributos compatíveis usam campos de dados estruturados e não são fornecidos no campo de notas.
• Se o complemento oferece soluções de videoconferência, ele só edita os detalhes da conferência e nenhum outro campo do evento.
• Se o complemento oferecer soluções de videoconferência, a criação levará menos de cinco segundos.

Complementos do Gmail

Se o complemento usar UrlFetchApp ou OpenLinkUrl:

• O URL é válido.
• O URL usa HTTPS, não HTTP.
• O domínio completo é especificado.
• O caminho não está vazio. Por exemplo, https://altostrat/ é aceitável, mas https://altostrat não.
• Caracteres curinga não podem ser usados em UrlFetchApp.

Complementos do Meet

• O login do complemento e as jornadas do usuário precisam funcionar mesmo se os cookies de terceiros estiverem desativados.
• O complemento precisa oferecer funcionalidades relevantes para a operação ou participação em uma reunião.
• O complemento não pode fazer nada que faça os usuários sair da reunião, como atualizar o navegador.
• Se você estiver usando a experiência multiplayer, o complemento precisa permitir que todos os participantes colaborem no conteúdo, mesmo que as permissões não tenham sido definidas com antecedência. O ajuste de permissão precisa estar disponível durante a sessão de complemento colaborativo.
• O complemento precisa processar o cancelamento do fluxo de início da atividade e permitir que o usuário reinicie a inicialização da atividade no app.
• O complemento precisa fornecer um painel lateral para fazer login e configurar a experiência da atividade.
• O complemento não pode oferecer a funcionalidade de convidar um bot ou depender da presença de um bot na reunião

• O complemento tem uma página inicial. Se o complemento do Google Workspace for um complemento convertido do Gmail, uma página inicial padrão será aplicada.
• O card do complemento (ou a interface em iframe nos complementos do Meet) funciona corretamente. Por exemplo, não há itens duplicados. Os botões "Voltar", "Atualizar" e "Atualizar" funcionam corretamente.
• Depois que o usuário autoriza o complemento, ele exibe um card da página inicial personalizado (página da Web nos Complementos do Meet) para dar as boas-vindas ao usuário com um botão de login (se necessário), logotipo e uma breve descrição do complemento.
  • Se o botão de login for acionado, ele vai apresentar uma página de login personalizada do fornecedor de terceiros que indica claramente que há um serviço de terceiros funcionando fora do Google Workspace.
• A interface do complemento se encaixa perfeitamente nos espaços alocados:
  • O texto e os rótulos não são cortados com "…"
  • O usuário não precisa rolar muito na vertical.
  • A largura do conteúdo não se estende além de 300p para que não tenha uma barra de rolagem horizontal.
• O código do complemento não usa bibliotecas excessivamente, porque elas podem fazer com que o complemento perca desempenho.

Complementos do Agenda

• Se o complemento oferece soluções de videoconferência, as videoconferências criadas são válidas e exibidas corretamente no site de videoconferências de terceiros.

Complementos do Documentos

Se as prévias do complemento forem links de um domínio de terceiros (ícones inteligentes):

• As visualizações de link oferecem informações complementares relevantes para o usuário. Por exemplo, a visualização de um link para uma transação de vendas adiciona informações como conta, valor e fase.
• O desenvolvedor está afiliado ao domínio em visualização.

Para mais informações, consulte Visualizar links com ícones inteligentes.

Complementos do Drive

• Se o app armazenar arquivos no Drive, ele permitirá que os usuários escolham uma pasta ou criem e reutilizem uma pasta específica do app. Os dados de configuração podem ser armazenados em uma pasta de dados do app. O app não despeja arquivos na pasta "Meu Drive" do usuário.
• O complemento só armazena arquivos no Drive que estão conectados à funcionalidade documentada do complemento.

Complementos do Gmail

• O complemento não menciona ou vincula extensões do navegador Chrome sem justificativa.
• O menu "Mais ações" more_vert contém ações universais que funcionam corretamente. Por exemplo, "Sair", "Sobre", "Suporte" etc.

Complementos do Meet

• Se o complemento exigir uma licença ou assinatura: uma mensagem fácil de entender precisa ser mostrada ao usuário quando ele não tiver uma licença.
• Se o usuário não puder usar o complemento devido a um problema de licenciamento, a mensagem de erro precisa indicar claramente o motivo pelo qual o complemento não pode ser usado e sugerir uma ação para que o usuário resolva a situação.
• A página de detalhes do complemento no Google Workspace Marketplace precisa especificar os detalhes sobre os requisitos de licença e assinatura que podem ser necessários para usar o complemento. Se o complemento tiver um nível pago, a listagem do Marketplace precisa incluir um link para uma página da Web com mais informações sobre preços ou como entrar em contato com um vendedor.
• Quando o usuário ainda não estiver conectado, o complemento precisará apresentar a solicitação de login com um toque encontrada em Mostrar um toque do Google One e uma opção "Fazer login com o Google" em Authentication. Além do mecanismo "Fazer login com o Google", outras opções de login podem ser oferecidas.
• O complemento precisa ter um design responsivo que possa adaptar o conteúdo a diferentes tamanhos.
• As jornadas do usuário do complemento precisam funcionar mesmo se os cookies de terceiros estiverem desativados.
• O complemento não pode ter rolagem horizontal no iframe.
• Se um complemento quiser usar o palco principal, ele precisa ser projetado para experiências multijogador e permitir que o conteúdo seja manipulado por vários participantes ao mesmo tempo. Para experiências de um único jogador, o desenvolvedor precisa usar o painel lateral.
• (recomendado): o complemento precisa mostrar quem é o usuário conectado.
• (recomendado) Escolha de localização: o idioma precisa ser baseado na preferência local definida pelo navegador, quando disponível.
• (Recomendado) A seleção de conteúdo precisa ser feita em uma interface de navegação que mostre o conteúdo acessado recentemente.
• (recomendado) Se o painel lateral não for mais necessário, o complemento precisa fechá-lo após a abertura do palco principal.

Complementos do Agenda

• O logotipo da solução de videoconferência é um URL público. Consulte Fornecer logotipos de solução de conferência.
• Se o complemento usar calendar.conferenceSolution, o logotipo da solução de conferência seguirá os requisitos de calendar.logoUrl. Consulte Recurso de manifesto da agenda.
• Se o complemento usa calendar.logoUrl ou common.logoUrl, o logotipo é idêntico ao ícone fornecido na página "Detalhes do app".
• Se o complemento usa calendar.logoUrl ou common.logoUrl, o URL do logotipo começa da seguinte forma: https://lh3.googleusercontent.com/

Complementos do Meet

• O logotipo da marca do complemento precisa ter um tamanho e estilo que permitam a identificação no painel lateral do Meet.
• Os URLs de logotipos adequados para o modo escuro precisam ser especificados no manifest do complemento.

Complementos do Drive

• (recomendado) Se você quiser receber metadados limitados, o complemento inclui o escopo drive.addons.metadata.readonly.

• O URL de navegação universal aponta para um app da Web. Uma página da Web simples sem funcionalidade não é considerada um app da Web.