Processo de revisão de apps e requisitos do Google Workspace Marketplace

Para publicar um app publicamente no Google Workspace Marketplace, o Google analisa o app e as informações do produto para garantir que eles atendam às diretrizes de design, conteúdo e estilo do Google.

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

  • Se o app exigir trabalho adicional: 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 o app para revisão, verifique se ele está pronto para publicação. Veja mais detalhes em Preparar-se para o processo de publicação.

Duração da análise

Esse processo geralmente leva vários dias. Isso depende do seguinte:

  • Quantos apps foram enviados recentemente
  • De quanto trabalho a mais o app precisa

Motivos comuns para um app não ser aprovado

Verificação OAuth:

  • A tela de permissão OAuth foi configurada incorretamente. Por exemplo, o tipo de usuário está definido como Interno ou o status de publicação está definido como Teste.
  • O app não concluiu a verificação OAuth.

Problemas na página "Detalhes do app":

  • Uso inadequado de marcas registradas do Google no nome, no logotipo ou nas descrições do app. Para ver orientações, consulte as diretrizes da promoção de marca do Google Workspace Marketplace.
  • Os links não funcionam ou direcionam o usuário para as informações incorretas. Por exemplo, um link para 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 revisão

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 do Google Workspace Marketplace.

Requisitos para todos os apps

É possível usar 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 um número de versão.
  • O nome corresponde ao exibido 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.
  • (Recomendado): o nome não tem pontuação, principalmente parênteses.
Informações do desenvolvedor
  • O nome e o site do desenvolvedor representam e direcionam às informações relevantes dele de maneira precisa.
  • Devido às leis de proteção ao consumidor, consumidores localizados no Espaço Econômico Europeu (EEE) precisam ser informados se um comerciante no Google Workspace Marketplace é um comerciante ou não comerciante:
    • Comerciante: 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.
    • Não comerciante: um não comerciante (consumidor) é uma pessoa que atua para fins não profissionais.

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

Descrição do aplicativo
  • Todos os links fornecidos funcionam e direcionam às informações corretas. Por exemplo, um link para uma Política de Privacidade aponta para uma página que descreve essa política.
  • Se o app interagir com um serviço de terceiros, a descrição vai descrever o que esse serviço faz, como ele interage com ele e, opcionalmente, 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 sobre 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 foi feito para fins de publicidade ou spam.
  • O app é totalmente funcional e não foi feito para fins de teste. Isso não é um trabalho em andamento.
  • Se o app interagir com recursos disponíveis para usuários ou usuários pagantes, uma conta de teste no sistema do desenvolvedor vai 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 nem 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 com um clique ou, de preferência, o SSO com zero clique.
  • Depois que um administrador concede permissões para os escopos do OAuth 2.0 para o domínio, os usuários individuais não precisam conceder permissões de escopo novamente.
  • Os usuários não precisam inserir as credenciais depois de fazer login na Conta do Google. No máximo, é preciso clicar no botão "Fazer login com o Google" para ter acesso.
  • Existem 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, o recurso de logout vai funcionar corretamente. Os tokens serão revogados, e o login poderá ser iniciado desde o início.
  • O feedback é sempre exibido, como mensagens de confirmação ou erro, para ações.
  • Não há links de imagem corrompidos ou imagens difusas.
Gráficos
  • Os ícones têm o tamanho correto, são quadrados e têm planos de fundo transparentes. Consulte Recursos gráficos.
  • O ícone representa corretamente o nome ou a funcionalidade do app.
  • O ícone é colorido, e não escala em 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 com precisão.
  • (Recomendado) As capturas de tela mostram claramente como usar o app e o que ele faz.
OAuth
  • O app foi aprovado na verificação do OAuth, usa os escopos de OAuth mais restritos possível e todos os escopos se integram corretamente às APIs dos Serviços do Google.

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

Selecione as integrações incluídas na página "Detalhes do app" para ver os critérios de análise relevantes. Clique nos nomes das colunas para classificar os critérios, por exemplo, por categoria.

É possível usar 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ú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 "Ajuda". Para mais informações sobre como criar uma boa mensagem de boas-vindas, consulte Criar apps do Chat que ajudam e agradam os usuários.
  • O app oferece suporte ao comando "Ajuda" e ajuda os usuários a começar a usar o app. Para mais informações sobre como criar uma boa mensagem de ajuda, consulte Criar apps de chat que ajudem e agradem os usuários.
  • O app sempre responde quando falado em um espaço ou no Chat direto.
  • As mensagens têm ortografia, letras maiúsculas, pontuação e gramática 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 a resposta levar mais de dois segundos, o app 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 usado pelo app atende aos requisitos do Google. Consulte Criar cards interativos.
  • O app está disponível na opção Encontrar apps do 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 para o 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 de vendas adiciona informações como conta, valor e estágio.
    • O desenvolvedor é afiliado ao domínio visualizado.

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

  • (Recomendado) Para permitir que os administradores do Workspace instalem seu app em nome dos usuários da 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 oferecer funcionalidades manipulando o HTML do Drive diretamente.
  • Se o app usa escopos confidenciais ou restritos, ele precisa passar pela verificação do OAuth. Consulte Como solicitar a 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 descarta arquivos na pasta Meu Drive do usuário.
  • O app só armazena arquivos no Drive conectados à funcionalidade documentada dele.
Complemento do Editor Funcionalidade
  • As ações esperadas e necessárias estão incluídas no complemento, e ele fornece todas as ferramentas necessárias para concluir o fluxo de trabalho. Por exemplo:
    • Se o complemento aplicar um 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, haverá um link para esse feed para facilitar a navegação.
    • Se o complemento exigir que o usuário tenha uma conta, ele fornece 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 outro arquivo é 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 fornece todas as informações necessárias para que os usuários tenham uma compreensão básica do produto e como usá-lo.
  • O código do complemento não usa bibliotecas demais, porque elas podem fazer com que o complemento perca o desempenho.
  • Se possível, os erros serão evitados e gerenciados adequadamente. Caso contrário:
    • As mensagens de erro são exibidas em uma caixa de diálogo, não em um alerta de JavaScript ou na barra vermelha padrão. Elas 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, 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 abertos em novas janelas e estão corretos.
  • O complemento é intuitivo e bem projetado. O que isso significa:
    • 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 o máximo possível.
    • O usuário e o conteúdo dele precisam estar o mais seguros possível.
  • O complemento segue o Guia de estilo da IU 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 IU 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 requer confirmação ou exibe avisos para todas as ações confidenciais. 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 isso com mudanças no design. Por exemplo, um complemento das Planilhas Google que importa dados cria um risco de substituir o conteúdo atual. É possível remover o risco criando uma página para os dados como a 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 do Google Agenda

  • Se o complemento usar calendar.name ou common.name, o nome no manifesto será idêntico ao 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 vai 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 Google Agenda

  • As agendas secundárias e a delegação são compatíveis ou, se não há suporte, são gerenciadas de maneira adequada. Por exemplo, a criação de videoconferências não falha quando o usuário seleciona outra agenda e 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 videoconferência será fornecida.
  • Se o complemento oferecer soluções de videoconferência, serão usados campos de dados de videoconferência apropriados. 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 de videoconferência, ele só vai editar os detalhes da videoconferência e nenhum outro campo de evento.
  • Se o complemento oferecer soluções de videoconferência, a criação da videoconferência 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/ está correto, mas https://altostrat não.
  • Não é possível usar caracteres curinga 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 vai ser aplicada.
  • O cartão de complemento funciona corretamente. Por exemplo, não há cards duplicados. Os botões "Voltar", "Atualizar" e "Atualizar" funcionam corretamente.
  • Depois que o usuário autoriza o complemento, ele exibe um card personalizado da página inicial para dar as boas-vindas ao usuário com um botão de 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 de terceiros funcionando fora do Google Workspace.
  • A IU 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 código do complemento não usa bibliotecas demais, já que elas podem fazer com que o complemento perca o desempenho.

Complementos do Google Agenda

  • Se o complemento oferecer soluções de videoconferência, as videoconferências criadas serão válidas e exibidas corretamente no site da 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 relevantes e complementares ao usuário. Por exemplo, a visualização de um link para uma oferta de vendas adiciona informações como conta, valor e estágio.
  • 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 descarta arquivos na pasta Meu Drive do usuário.
  • O complemento armazena apenas arquivos no Drive que estão conectados à funcionalidade documentada dele.

Complementos do Gmail

  • O complemento não menciona nem 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.
Complemento do Google Workspace Gráficos

Complementos do Google 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 videoconferência vai seguir os requisitos de calendar.logoUrl. Consulte Recurso do 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á da seguinte maneira: 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.