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 as informações dele para garantir que atendam às diretrizes de design, conteúdo e estilo do Google.

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

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

Antes de enviar seu app para revisão, verifique se ele está pronto para publicar. Veja mais detalhes em Preparar-se para o processo de publicação.

Duração da análise

A análise do app normalmente leva vários dias. O tempo que leva depende de:

  • Quantos apps foram enviados recentemente
  • De 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 permissão OAuth está configurada incorretamente. Por exemplo, o tipo de usuário está definido como Interno ou o status de publicação é definido como Teste.
  • O app não concluiu a verificação do OAuth.

Problemas com a página "Detalhes do app":

  • Uso inadequado de marcas registradas do Google no nome, logotipo ou descrição do aplicativo. Para receber orientações, acesse as diretrizes da promoção de marca do Google Workspace Marketplace.
  • Os links não funcionam ou não direcionam o usuário para as informações incorretas. Por exemplo, o link de uma Política de Privacidade aponta para uma página de suporte ao desenvolvedor.
  • Capturas de tela e imagens são de baixa qualidade ou não representam com precisão a funcionalidade do app.

Prontidão do app:

  • O app ainda está sendo testado e não está pronto para o público.
  • O app tem bugs ou não é totalmente funcional.

Critérios de análise

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

Use as caixas de seleção para acompanhar a revisão preliminar.

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

    Se não for especificado, "Status do comerciante não especificado" aparecerá na página Detalhes do app.
Descrição do aplicativo
  • Todos os links fornecidos funcionam e direcionam às informações corretas. Por exemplo, o link de uma Política de Privacidade aponta para uma página que a descreve.
  • Se o app interagir com um serviço de terceiros, a descrição descreve o que o serviço faz, como o app interage com ele e, opcionalmente, inclui um link para o site relevante.
  • As descrições curtas e detalhadas são compreensíveis.
  • As descrições breve e detalhada não são idênticas.
  • (Recomendado) As informações de preços estão completas e precisas.
  • (Recomendado) O conjunto completo de atributos por idioma (nome, descrição breve e descrição detalhada) está 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 se destina a fins de publicidade ou spam.
  • O app é totalmente funcional e não foi feito para testes. Ele não é um trabalho em andamento.
  • Se o app interagir com recursos disponíveis para usuários ou pagantes, 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 propriedades da marca Google, 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 aplicativo usa o SSO de um clique ou, idealmente, de zero clique.
  • Depois que um administrador concede permissões para os escopos do OAuth 2.0 para o domínio, as permissões de escopo não são solicitadas aos usuários individuais novamente.
  • Os usuários não precisam inserir as credenciais após fazer login na Conta do Google. É preciso clicar no 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 for necessário fazer login, a funcionalidade de saída está funcionando corretamente. Os tokens são revogados e o login pode começar do início.
  • O feedback das ações, como mensagens de erro ou confirmação, é sempre exibido.
  • Não há links de imagem corrompidos ou imagens confusas.
Gráficos
  • Os ícones são dimensionados corretamente, são quadrados e têm fundos transparentes. Consulte Recursos gráficos.
  • O ícone representa corretamente o nome ou a funcionalidade do app.
  • O ícone é colorido, e não escalado para cinza.
  • O ícone não usa marcas registradas do Google.
  • As capturas de tela e as imagens não estão desfocadas, difíceis de ler ou inadequadas. Eles representam o app de maneira precisa.
  • (Recomendado) As capturas de tela mostram claramente como usar e o que o app faz.
OAuth
  • O app passou na verificação do OAuth, usa os escopos OAuth mais estreitos possíveis e todos os escopos se integram corretamente às APIs dos Serviços do Google.

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

Selecione as integrações do app incluídas na página "Detalhes do app" para conferir os critérios de revisão relevantes. É possível clicar nos nomes das colunas para classificar os critérios, por exemplo, por categoria.

Use as caixas de seleção para acompanhar a 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 (maiúscula) ou 0–9. 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 Enviar uma mensagem de card inicial do app.
  • O app é compatível com o 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 um chat direto.
  • As mensagens apresentam ortografia, letras maiúsculas, pontuação e gramática 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 levar 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 usar as @menções para adicionar o app a um espaç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 de cards que o app usa atende aos requisitos do Google. Consulte Criar 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 preparo ou 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 do Chat visualizar links de um domínio de terceiros:
    • As visualizações de links oferecem informações relevantes e complementares à mensagem do usuário. Por exemplo, a visualização de um link para uma oferta adiciona informações como conta, valor e etapa.
    • O desenvolvedor é afiliado ao domínio visualizado.

    Para mais informações, consulte Visualizar links.

  • (Recomendado) Para permitir que os administradores do Workspace instalem seu app em nome dos usuários na organização, o app precisa ser capaz de receber e enviar mensagens diretas.
App Google Chat Gráficos
  • O app tem um avatar claro e reconhecível.
App do Google Drive Funcionalidade
  • O app não usa extensões do navegador Chrome para fornecer funcionalidade manipulando o HTML do Drive diretamente.
  • Se o app usa escopos sensíveis ou restritos, ele precisa passar pela verificação do OAuth. Consulte Como enviar 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?.
App do Google Drive Experiência do usuário
  • 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 app só armazena arquivos no Drive conectados à funcionalidade documentada do app.
Complemento do Editor Funcionalidade
  • As ações esperadas e obrigatórias estão incluídas no complemento e fornecem todas as ferramentas necessárias para concluir o fluxo de trabalho. Por exemplo:
    • Se o complemento aplicar um estilo a todo o documento, ele oferecerá a opção de aplicar o estilo apenas ao texto selecionado.
    • Se o complemento fizer upload dos 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 fornecerá links ou informações para criar uma conta com facilidade, caso o usuário ainda não tenha 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 de menu são preenchidos quando o complemento é instalado pela primeira vez e quando um arquivo diferente é aberto. Consulte Autorização de complementos do Editor.
  • Os modos de autorização estão configurados corretamente. Consulte Modos de autorização.
Complemento do Editor Experiência do usuário
  • O complemento oferece todas as informações necessárias para que os usuários tenham um entendimento básico do produto e como usá-lo.
  • O código do complemento não usa bibliotecas em excesso, porque elas podem fazer com que o complemento perca o desempenho.
  • Se possível, evitaremos erros e serão gerenciados corretamente quando não houver:
    • As mensagens de erro são exibidas em uma janela de diálogo, não em um alerta JavaScript ou na barra vermelha padrão. Eles comunicam o problema e descrevem o que o usuário precisa fazer para corrigi-lo em uma linguagem simples.
    • Quando possível, se o usuário estiver fazendo algo errado, um botão será exibido para corrigir o problema.
    • Para mais informações, consulte o guia de estilo de complementos.
  • Os links para páginas externas são abertos em uma nova janela e estão corretos.
  • O complemento é intuitivo e bem projetado. O que isso significa:
    • Está sempre 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 o mais simples possível.
    • O usuário e o conteúdo dele sã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 exibe uma caixa de diálogo por vez. Ele não se sobrepõe ou tem várias caixas de diálogo abertas ao mesmo tempo.
  • A interface do complemento se encaixa perfeitamente em espaços alocados:
    • O texto e os rótulos não são cortados com "..."
    • O usuário não precisa fazer muita rolagem vertical.
    • A largura do conteúdo não se estende além de 300p para que ele 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 receberá um aviso e confirmará a ação antes que ela aconteça.

    É possível evitar esse requisito com mudanças no design. Por exemplo, um complemento das Planilhas Google que importa dados cria um risco de substituir o conteúdo atual. Para remover esse risco, crie uma página com 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 ficam desativados ou ficam 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 nome fornecido na página "Detalhes do app".
  • Se o complemento usar calendar.conferenceSolution, o nome da solução de videoconferência não vai conter "Google Agenda".
  • (Recomendado) Se o complemento usar calendar.conferenceSolution, o nome da solução de videoconferência não terá mais de 30 caracteres.
Complemento do Google Workspace Funcionalidade
  • O complemento usa os widgets corretos 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 podem ser usadas ou, se não forem, gerenciadas de maneira eficiente. Por exemplo, a criação de conferências não falha quando o usuário seleciona outra agenda que tem acesso para edição ao criar um evento.
  • Os eventos recorrentes funcionam corretamente.
  • Se o complemento usar calendar.conferenceSolution, pelo menos uma solução de conferência será fornecida.
  • Se o complemento fornecer soluções de videoconferência, os campos de dados de videoconferência apropriados serã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 incluídos no campo de notas.
  • Se o complemento oferecer soluções para videoconferência, ele só vai editar os detalhes da videoconferência e nenhum outro campo do evento.
  • Se o complemento fornecer soluções de videoconferência, a criação vai levar menos de cinco segundos.

Complementos do Gmail

Se o complemento usar UrlFetchApp ou OpenLinkUrl:

  • O URL é válido.
  • O URL usa HTTPS, e 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.
  • Caracteres curinga não podem ser usados em UrlFetchApp.
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 convertido do Gmail, uma página inicial padrão será aplicada.
  • O cartão de complemento funciona corretamente. Por exemplo, não há cards duplicados, e os botões "Voltar", "Atualizar" e "Atualizar" funcionam corretamente.
  • Depois que o usuário autorizar o complemento, ele exibirá um card personalizado na página inicial para dar as boas-vindas ao usuário com um botão para fazer login (se necessário), um logotipo e uma breve descrição do complemento.
    • Se o botão de login for acionado, ele apresentará uma página de login personalizada do fornecedor terceirizado que indica claramente que há um serviço terceirizado funcionando fora do Google Workspace.
  • A interface do complemento se encaixa perfeitamente em espaços alocados:
    • O texto e os marcadores não são cortados por "..."
    • O usuário não precisa fazer muita rolagem vertical.
    • A largura do conteúdo não se estende além de 300p para que ele não tenha uma barra de rolagem horizontal.
  • O código do complemento não usa bibliotecas demais, porque elas podem fazer com que o complemento perca o 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 links oferecem informações complementares relevantes ao usuário. Por exemplo, a visualização de um link para uma oferta adiciona informações como conta, valor e etapa.
  • O desenvolvedor é afiliado ao domínio visualizado.

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 armazena apenas arquivos no Drive que estejam conectados à funcionalidade documentada do complemento.

Complementos do Gmail

  • O complemento não menciona nem inclui links para 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.
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ências.
  • Se o complemento usar calendar.conferenceSolution, o logotipo da solução de conferência vai seguir os requisitos de calendar.logoUrl. Consulte Recurso de manifesto do Google 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 usar calendar.logoUrl ou common.logoUrl, o URL do logotipo começará assim: https://lh3.googleusercontent.com/
Complemento do Google Workspace OAuth

Complementos do Drive

  • (Recomendado) Se você quiser receber metadados limitados, o complemento vai incluir 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.