Processo de análise de apps e requisitos para o Google Workspace Marketplace
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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.
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.
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.
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.
(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 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:
Trader: é 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.
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 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 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 são dimensionados corretamente, 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 restritos 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 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 links 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.
(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 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 Enviar seu 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 criam e reutilizam 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 enviar dados de 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 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 estão configurados corretamente. Consulte
Modos de autorização.
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, se não:
As mensagens de erro são exibidas em uma caixa 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.
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 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 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 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 a interface em iframe nos complementos do Meet) para a funcionalidade desejada. Por exemplo, use um
switch 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 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 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 elemento da interface (como um card de complemento ou uma interface em iframe em 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 informações (como um card personalizado
da página inicial ou uma 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 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 com visualização (o padrão de URL especificado que aciona a criação do ícone inteligente).
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 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" more_vert
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 "Detalhes do app" 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 do One Tap em Mostrar o Google One Tap e um substituto do recurso "Fazer login com o Google" 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.
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 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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-02-20 UTC."],[[["Google Workspace Marketplace app reviews focus on design, content, functionality, and user experience to ensure compliance with platform standards."],["Common reasons for app rejection include incomplete OAuth verification, inaccurate app listings, and functionality issues."],["Apps must have clear, concise names, detailed descriptions, bug-free functionality, and intuitive user interfaces."],["Specific requirements exist for Google Chat, Google Drive, and Editor add-ons to ensure seamless integration with respective services."],["Developers should follow detailed guidelines for graphics, OAuth scopes, and platform-specific functionalities to enhance user experience and app quality."]]],["Developers submitting apps to the Google Workspace Marketplace must undergo a review process. The app's name, developer information, and description must be accurate and follow specific guidelines. The app must be fully functional, bug-free, and offer a positive user experience. Graphics, including icons and screenshots, must be high-quality and relevant. OAuth verification and scope usage must be correct. Specific requirements exist for Google Chat, Drive, Editor, and Workspace add-ons, focusing on functionality, user experience, and graphics. Apps can be approved or require resubmission based on the review.\n"]]
