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 página "Detalhes do app" para verificar se eles 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 envie o app novamente 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, verifique se ele está pronto para publicação. Para mais detalhes, consulte Preparar para o processo de publicação.

Duração da revisão

A análise do app normalmente 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:

  • Configuração incorreta da tela de permissão OAuth. 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 do OAuth.

Problemas com a página do app:

  • Uso inadequado das marcas registradas do Google no nome, logotipo ou 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á em teste 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 o app para análise, confira se ele atende a todos os requisitos e obedece às políticas do programa do 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 páginas de detalhes do app 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 o formato de título.
  • (Recomendado) O nome não tem pontuação, principalmente parênteses.
  • (Recomendado) O nome corresponde ao nome exibido nos aplicativos do Google Workspace. Por exemplo, nos complementos do Google Workspace, o nome no manifesto é semelhante ao nome fornecido na página "Detalhes do app".
Informações do desenvolvedor
  • O nome e o site do desenvolvedor representam e direcionam com precisão para informações relevantes sobre ele.
  • 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 negociante ou um não negociante:
    • Negociante: uma pessoa que atua para fins relacionados a um comércio, negócio, ofício ou profissão; ou em nome ou em representação de um negociante.
    • Não negociante: uma pessoa que atua para fins não profissionais.

    Se não for especificado, "Status do trader não especificado" vai aparecer na página Detalhes 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 interagir com um serviço de terceiros, a descrição vai descrever o que o serviço de terceiros faz, como o app interage com ele e, opcionalmente, vai incluir um link para o site relevante.
  • As descrições curtas e detalhadas são compreensíveis.
  • As descrições curta e detalhada não são idênticas.
  • (Recomendado) As informações de preços estão completas e corretas.
  • (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, funcionam perfeitamente. 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 interagir com recursos disponíveis para usuários ou usuários pagos, uma conta de teste no sistema do desenvolvedor será fornecida à equipe de análise do Google.
Experiência do usuário
  • O app, incluindo o nome, não usa recursos de marca, marcas registradas ou conteúdo da marca Google. Consulte as diretrizes de marca do Google Workspace Marketplace.
  • A autorização e o login são necessários apenas uma vez. O app usa SSO com um clique ou, idealmente, com zero cliques.
  • Depois que um administrador concede permissões para os escopos do OAuth 2.0 no domínio, os usuários individuais não precisam conceder permissões de escopo de novo.
  • 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 começar 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 nem imagens desfocadas.
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 está em cores (não em escala de 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. Elas 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 passou na verificação do OAuth, usa os escopos do OAuth mais restritos possíveis e todos os escopos se integram corretamente às APIs dos Serviços do Google.

Outros requisitos para integrações de apps específicas

Selecione as integrações de apps 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.

Use 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 (maiúsculas) ou 0–9. Ele não pode começar com um símbolo.
App Google Chat Funcionalidade
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". Consulte a documentação.
  • O app é compatível com o comando "Ajuda" e ajuda os usuários a começar. Consulte a documentação.
  • O app sempre responde quando alguém fala com ele em um espaço ou no Chat direto.
  • As mensagens usam ortografia, letras maiúsculas, pontuação e gramática corretas. Elas não contêm material malicioso, ofensivo ou abusivo.
  • As mensagens usam formatação clara, concisa e consistente para texto ou cards de acordo com os requisitos do Google.
  • Se uma resposta levar mais de 2 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ções.
  • 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 a documentação.
  • 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 teste 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 Chat mostrar visualizações de links de um domínio de terceiros:
    • As prévias de link oferecem informações relevantes e complementares à mensagem do usuário. Por exemplo, ao visualizar um link para uma negociação de vendas, são adicionadas informações como conta, valor e estágio.
    • O desenvolvedor é afiliado ao domínio visualizado.

    Para saber como visualizar links, consulte a documentaçã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
  • O app não usa extensões do navegador Chrome para oferecer funcionalidades manipulando diretamente o HTML do Drive.
  • Se o app usa escopos sensíveis ou restritos, ele precisa passar pela verificação do OAuth. Consulte Enviar o app para verificação.
  • Se o app usa escopos restritos, ele também precisa passar por uma avaliação de segurança. Consulte Avaliação da Segurança.
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 descarta 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, e ele fornece todas as ferramentas necessárias para concluir o fluxo de trabalho. Por exemplo:
    • Se o complemento aplicar 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 com facilidade, caso o usuário ainda não tenha.
  • O complemento tem itens de menu na guia Complementos.
  • Mesmo que o complemento tenha apenas funções personalizadas, ele ainda inclui documentação adequada.
  • O complemento usa corretamente onInstall() e onOpen() 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 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 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 fornece todas as informações necessárias para entender o básico do produto e como usá-lo.
  • O código do complemento não usa bibliotecas em excesso, já que elas podem prejudicar o desempenho do complemento.
  • Os erros são evitados sempre que 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 corrigir em linguagem 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 abrem em novas janelas e estão corretos.
  • O complemento é intuitivo e bem projetado. Isso significa:
    • Sempre fica claro o que fazer e como fazer.
    • O complemento é acessível e fácil de entender. Evite usar jargões e termos técnicos.
    • 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. 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:
    • 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 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 será avisado e precisará confirmar a ação antes que ela aconteça.

    É possível evitar esse requisito fazendo mudanças no design. Por exemplo, um complemento do Planilhas Google que importa dados cria o risco de substituir conteúdo existente. Para remover o risco, crie uma planilha 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 da Agenda

  • Se o complemento usa calendar.name ou common.name, o nome no manifesto é idêntico ao nome fornecido na página 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 o elemento de interface correto (como widgets ou interface em iframes nos complementos do Meet) para a funcionalidade desejada. Por exemplo, use um interruptor para selecionar um valor booleano.

Complementos da Agenda

  • As agendas secundárias e a delegação são compatíveis ou, se não forem, são gerenciadas normalmente. Por exemplo, a criação de uma conferência não falha se o usuário selecionar outra agenda com acesso de 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 oferecer soluções de conferência, os campos de dados de conferência adequados 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 fornecidos no campo de observações.
  • Se o complemento oferecer soluções de videoconferência, ele só vai editar os detalhes da conferência, e não outros campos do evento.
  • Se o complemento oferecer soluções de videoconferência, a criação da conferência vai levar menos de 5 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.

Complementos do Meet

  • O login do complemento e as jornadas do usuário precisam funcionar mesmo que os cookies de terceiros estejam 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 estiver usando uma experiência multiplayer, o complemento precisa permitir que todos os participantes colaborem no conteúdo, mesmo que as permissões não estejam definidas com antecedência. O ajuste de permissão precisa estar disponível durante a sessão do complemento colaborativo.
  • O complemento precisa processar o cancelamento do fluxo de atividade de início e permitir que o usuário reinicie a atividade no app.
  • O complemento precisa fornecer um painel lateral para fazer login e configurar a experiência de atividade.
  • O complemento não pode oferecer funcionalidades para 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 elemento da interface (como um card de complemento ou uma interface em iframe nos complementos do Meet) funciona corretamente. Por exemplo, não há itens duplicados, e os botões "Voltar", "Atualizar" e "Atualizar" funcionam corretamente.
  • Depois que o usuário autoriza o complemento, ele mostra informações (como um card personalizado na página inicial ou uma página da Web nos complementos do Meet) para dar as boas-vindas 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 vai 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 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 em excesso, já que elas podem prejudicar o desempenho do complemento.

Complementos da Agenda

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

Complementos do Documentos

Se o complemento mostrar prévias de links de um domínio de terceiros (ícones inteligentes):

  • As visualizações de link oferecem informações relevantes e complementares ao usuário. Por exemplo, ao visualizar um link para uma negociação de vendas, são adicionadas informações como conta, valor e estágio.
  • O desenvolvedor é afiliado ao domínio visualizado (o padrão de URL especificado que aciona a criação do ícone inteligente).

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

Complementos do Drive

  • 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 descarta arquivos na pasta Meu Drive do usuário.
  • O complemento armazena apenas arquivos no Drive que estão conectados à funcionalidade documentada do complemento.

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.

Complementos do Meet

  • Se o complemento exigir uma licença ou assinatura: uma mensagem fácil de usar 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 corrija a situação.
  • A página do complemento no Google Workspace Marketplace precisa especificar detalhes sobre os requisitos de licença e assinatura necessários para usar o complemento. Se o complemento tiver um nível pago, a página 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 tiver feito login, o complemento precisa apresentar o comando de login com um toque encontrado em Mostrar o recurso Um toque do Google e um substituto de "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 ser funcionais mesmo que os cookies de terceiros estejam desativados.
  • O complemento não pode ter rolagem horizontal no iframe.
  • Se um complemento quiser usar a janela principal, ele precisa ser projetado para experiências multiplayer e permitir que o conteúdo seja manipulado por vários participantes ao mesmo tempo. Para experiências de um 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 deve ser baseado na preferência local definida pelo navegador, quando disponível.
  • (Recomendado) A seleção de conteúdo deve ser feita por 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 vai fechar o painel lateral depois de ser iniciado no palco principal.
Complemento do Google Workspace Gráficos

Complementos da Agenda

  • O logotipo da solução de conferência é um URL público. Consulte Fornecer logotipos de soluções de videoconferência.
  • Se o complemento usar calendar.conferenceSolution, o logotipo da solução de conferência vai seguir os requisitos 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 usar calendar.logoUrl ou common.logoUrl, o URL do logotipo começará da seguinte forma: https://lh3.googleusercontent.com/

Complementos do Meet

  • O logotipo da marca do complemento precisa ter um tamanho e um estilo que o identifiquem no painel lateral do Meet.
  • Os URLs adequados do logotipo no 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 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.