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

Para publicar um app publicamente no Google Workspace Marketplace, o Google analisa o app e a listagem dele para verificar se atendem às diretrizes de design, conteúdo e estilo do Google.

Depois que o Google analisar seu app, você vai receber um e-mail informando se ele precisa de mais trabalho ou se foi aprovado.

  • Se o app precisar de mais trabalho: você vai receber um documento de análise com informações específicas sobre o que precisa ser melhorado. Resolva os problemas e reenvie o app para análise.
  • Se a equipe de análise aprovar seu app: ele será publicado automaticamente, e você vai receber um e-mail de notificação.

Antes de enviar o app para análise, confira se ele está pronto para publicação. Para mais detalhes, consulte Preparar para o processo de publicação.

Duração da análise

A análise de apps geralmente leva vários dias. O tempo necessário depende de:

  • Quantos apps foram enviados recentemente
  • Quanto trabalho extra seu app precisa

Motivos comuns para um app não ser aprovado na revisão

Verificação do OAuth:

  • A tela de consentimento OAuth está configurada incorretamente. Por exemplo, o tipo de usuário é definido como interno ou o status de publicação é definido como em teste.

  • O app não concluiu a verificação do OAuth.

Problemas com a listagem de apps:

  • Uso inadequado das marcas registradas do Google no nome, no logotipo ou nas descrições do app. Para orientações, acesse as diretrizes de marca do Google Workspace Marketplace.

  • Os links não funcionam ou apontam para informações incorretas. Por exemplo, um link para uma Política de Privacidade aponta para uma página de suporte ao desenvolvedor.

  • As capturas de tela e imagens são de baixa qualidade ou não representam com precisão os recursos do app.

Prontidão do app:

  • O app ainda está sendo testado e não está pronto para ser lançado.
  • O app tem bugs ou não é totalmente funcional.

Revisar os critérios

Antes de enviar o app para análise, confira se ele atende a todos os requisitos e obedece às políticas do programa Google Workspace Marketplace.

Requisitos para todos os apps

Use as caixas de seleção para acompanhar sua análise preliminar.

Categoria Critérios
Nome do app
  • Não há outras listagens de apps com o mesmo nome.
  • O nome não inclui um número de versão.
  • O nome corresponde ao nome na tela de consentimento do OAuth.
  • O nome não é vago nem muito genérico.
  • O nome tem até 50 caracteres.
  • (Recomendado) O nome usa maiúsculas.
  • (recomendado): o nome não tem pontuação, especialmente parênteses.
Informações do desenvolvedor
  • O nome e o site do desenvolvedor representam com precisão e direcionam para informações relevantes sobre o desenvolvedor.
  • Devido às leis de proteção ao consumidor, os consumidores residentes no Espaço Econômico Europeu (EEE) precisam ser informados se um comerciante no Google Workspace Marketplace é um trader ou um não trader:
    • Negociante: é uma pessoa que atua para fins relacionados a um comércio, negócio, ofício ou profissão, ou em nome de um negociante.
    • Não negociante: uma pessoa que não é negociante (consumidor) é alguém que atua para fins não profissionais.

    Se não for especificado, a mensagem "Status do comerciante não especificado" vai aparecer na página Detalhes do app do app.

Descrição do aplicativo
  • Todos os links fornecidos funcionam e apontam para as informações corretas. Por exemplo, um link para uma Política de Privacidade aponta para uma página que descreve a política.
  • Se o app interage com um serviço de terceiros, a descrição descreve o que o serviço de terceiros faz, como o app interage com ele e, opcionalmente, vincula o site relevante.
  • As descrições curtas e detalhadas são compreensíveis.
  • As descrições curtas e detalhadas não são idênticas.
  • (recomendado): as informações de preços são completas e precisas.
  • (recomendado): o conjunto completo de atributos por idioma (nome, descrição curta e descrição detalhada) é definido corretamente sem incompatibilidade de idioma.
Funcionalidade
  • Não há bugs óbvios, e todas as ações, incluindo casos extremos, são totalmente funcionais. Os tempos de carregamento são gerenciados com indicadores de carregamento.
  • O app demonstra interações claras com as APIs do Google.
  • O app oferece uma funcionalidade nova ou estendida que não é equivalente ao que já está incluído nos produtos do Google.
  • O app não é destinado a publicidade ou spam.
  • O app é totalmente funcional e não foi criado para fins de teste. Ele não está em desenvolvimento.
  • Se o app interage com recursos disponíveis para usuários ou usuários pagos, uma conta de teste no sistema do desenvolvedor é fornecida à equipe de análise do Google.
Experiência do usuário
  • O app, incluindo o nome, não usa recursos, marcas registradas ou conteúdo da marca Google. Consulte as diretrizes de branding do Google Workspace Marketplace.
  • A autorização e o login são necessários apenas uma vez. O app usa o SSO de um clique ou, de preferência, o SSO sem cliques.
  • Depois que um administrador concede permissões para os escopos do OAuth 2.0 do domínio, os usuários individuais não precisam solicitar novamente as permissões de escopo.
  • Os usuários não precisam inserir credenciais depois de fazer login na Conta do Google. No máximo, eles precisam clicar em um botão "Fazer login com o Google" para ter acesso.
  • Há termos consistentes, óbvios e compreensíveis para rótulos de botões, itens de menu, títulos e outros elementos do app. Por exemplo, em vez de "Sim" ou "Não", os rótulos se referem a nomes de ações, como "Excluir" e "Cancelar".
  • Se o login for necessário, a funcionalidade de logout vai funcionar corretamente. Os tokens são revogados, e o login pode ser iniciado do início.
  • O feedback é sempre mostrado, como mensagens de confirmação ou de erro para ações.
  • Não há links de imagens corrompidos ou imagens desfocadas.
Gráficos
  • Os ícones têm o tamanho correto, são quadrados e têm segundo plano transparente. Consulte Recursos gráficos.
  • O ícone representa corretamente o nome ou a funcionalidade do app.
  • O ícone está colorido (não em escala de cinza).
  • O ícone não usa as marcas registradas do Google.
  • As capturas de tela e imagens não estão desfocadas, difíceis de ler ou inadequadas. Eles representam com precisão o app.
  • (recomendado): as capturas de tela mostram claramente como usar o app e o que ele faz.
OAuth
  • O app passou na verificação do OAuth, usa os escopos de OAuth mais estreitos possíveis e todos os escopos são integrados corretamente às APIs do Google Services.

Requisitos adicionais para integrações de apps específicas

Selecione as integrações incluídas na página de detalhes do app para conferir os critérios de avaliação relevantes. Clique nos nomes das colunas para classificar os critérios, por exemplo, por categoria.

Você pode usar as caixas de seleção para acompanhar sua análise preliminar.

Integração de apps Categoria Critérios
App Google Chat Nome
  • Os botões para se comunicar com o app estão disponíveis na descrição.
  • O nome do app começa com A–Z (letras maiúsculas) ou 0–9. Ele não pode começar com um símbolo.
App Google Chat Experiência do usuário
  • O app envia uma mensagem de boas-vindas não solicitada sempre que um usuário inicia uma mensagem direta ou o app é adicionado a um espaço. A mensagem de boas-vindas é diferente do comando "Help". Para mais informações, consulte Criar uma página inicial para 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 inclinada.
  • 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. As mensagens 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 desativem as notificações.
  • 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 usado 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 está afiliado ao domínio em visualização.

    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.
App Google Chat Gráficos
  • O app tem um avatar claro e reconhecível.
App do Google Drive Funcionalidade
App do Google Drive Experiência do usuário
  • 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.
Complemento de editor Funcionalidade
  • As ações esperadas e necessárias estão incluídas no complemento, que fornece 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 upload de dados da planilha para um feed de serviço da Web, ele terá um link para esse feed para facilitar 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 onInstall() e onOpen() corretamente 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 estão 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.
Complemento de editor Experiência do usuário
  • O complemento oferece 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, porque elas podem fazer com que o complemento perca desempenho.
  • Os erros são evitados, se possível, e gerenciados corretamente, 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:
    • Sempre fica claro o que fazer e como fazer.
    • 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 exibe 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 ocultados enquanto uma ação está sendo carregada.
Complemento do Google Workspace Nome

Complementos da Agenda

  • Se o complemento usar calendar.name ou common.name, o nome no manifesto será idêntico ao fornecido na página de detalhes do app.
  • Se o complemento usar calendar.conferenceSolution, o nome da solução de conferência não vai 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.
Complemento do Google Workspace Funcionalidade
  • 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 de forma adequada. 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 videoconferência, os campos de dados de conferência adequados são usados. Por exemplo, links de videoconferência, números de telefone, links SIP, códigos de acesso e outros atributos com suporte 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 edita apenas os detalhes da conferência e nenhum outro campo do evento.
  • Se o complemento oferece soluções de videoconferência, a criação leva 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/ está correto, mas https://altostrat não.
  • Os 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 saírem da reunião, como atualizar o navegador.
  • Se você estiver usando a experiência multijogador, o complemento precisa permitir que todos os participantes colaborem no conteúdo, mesmo que as permissões não sejam 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 o início 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
Complemento do Google Workspace Experiência do usuário
  • O complemento tem uma página inicial. Se o complemento do Google Workspace for um complemento do Gmail convertido, 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 mostra um card da página inicial personalizado (página da Web em 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 armazena 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" 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 fez login, o complemento precisa apresentar o comando de login com um toque encontrado em Exibir o recurso "Fazer login com o Google" e um substituto "Fazer login com o Google" encontrado em Autenticação. 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.
Complemento do Google Workspace Gráficos

Complementos do Agenda

  • O logotipo da solução de videoconferência é um URL público. Consulte Fornecer logotipos de soluções 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 usar calendar.logoUrl ou common.logoUrl, o logotipo será 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 manifesto do complemento.
Complemento do Google Workspace OAuth

Complementos do Drive

  • (recomendado) Se você quiser receber metadados limitados, o complemento inclui o escopo drive.addons.metadata.readonly.
App da Web Funcionalidade
  • 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.