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 do app geralmente leva vários dias. O tempo necessário depende do seguinte:

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

Motivos comuns para um app não ser aprovado na avaliaçã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 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 mais orientações, acesse as Diretrizes da promoção 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 seu app para revisão, verifique se ele atende a todos os requisitos e está em conformidade com as políticas do programa Google Workspace Marketplace.

Requisitos para todos os apps

Você pode usar 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 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 breve e detalhada 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 feito para fins de teste. Ele não é um trabalho em andamento.
  • Se o app interagir com recursos disponíveis para usuários ou usuários pagos, uma conta de teste no sistema do desenvolvedor será fornecida para a equipe de revisão 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 da promoção de marca 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 clique;
  • 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 as permissões de escopo novamente.
  • 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 exibido, como mensagens de confirmação ou erro, para as ações.
  • Não há links de imagens corrompidos ou imagens desfocadas.
Gráficos
  • Os ícones são dimensionados corretamente, 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 é colorido (não em escala cinza).
  • O ícone não usa 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 foi aprovado na verificação OAuth, usa os escopos OAuth mais restritos possíveis e todos os escopos se integram corretamente às APIs Google Services.

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

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

É possível usar as caixas de seleção para acompanhar sua revisão 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 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 falado em um espaço ou 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 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 reconhecível e claro.
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 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.
Complemento do editor Experiência do usuário
  • 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, 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, será exibido um botão que corrige 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 que:
    • Sempre fica claro o que fazer e como fazer.
    • O complemento é acessível e simples de entender. Evite termos técnicos e jargões.
    • 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 principal 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 a tela verticalmente.
    • A largura do conteúdo não vai além de 300p, de modo 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.
Complemento do Google Workspace Nome

Complementos do Agenda

  • Se o complemento usar calendar.name ou common.name, o nome no manifesto será idêntico ao informado na página "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.
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 uma chave 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 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 anotações.
  • Se o complemento oferece soluções de videoconferência, ele só edita os detalhes da videoconferê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 atividade de início e permitir que o usuário reinicie o início da atividade no app.
  • O complemento precisa ter um painel lateral para login e configuração da 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 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 oferecer soluções de videoconferência, as videoconferências criadas serão válidas e exibidas corretamente no site de videoconferência de terceiros.

Complementos do Documentos

Se o complemento visualizar 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 crie e reutilize 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 salva 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 precisará indicar claramente por que o complemento não pode ser usado e sugerir uma providência para resolver 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 uma camada paga, a listagem do Marketplace precisará fornecer 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 que os cookies de terceiros estejam 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 se basear na preferência local definida pelo navegador, quando disponível.
  • (Recomendado) A seleção do conteúdo deve ser feita por uma interface de navegação de conteúdo com 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 usa calendar.conferenceSolution, o logotipo da solução de conferência segue os requisitos de calendar.logoUrl. Consulte Recurso de manifesto do 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 tamanho e estilo que possam ser identificados no painel lateral do Meet.
  • Os URLs de logotipos adequados para o modo escuro precisam ser especificados no manifest 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.