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 revisar seu app, você receberá um e-mail informando se ele precisa de mais trabalho ou se foi aprovado.

• Caso o app precise de mais trabalho: você vai 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, confira se ele está pronto para publicação. Veja mais detalhes em Preparar para o processo de publicação.

Duração da revisão

A revisão do app normalmente leva vários dias. O tempo necessário depende do seguinte:

• Quantos apps foram enviados recentemente
• De quanto trabalho adicional o 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 é definido como Interno ou o status de publicação é definido como Teste.
• O app não concluiu a verificação do 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 receber orientações, acesse as Diretrizes da promoção de marca do Google Workspace Marketplace.
• Os links não funcionam ou direcionam para informações incorretas. Por exemplo, o link de uma Política de Privacidade leva a 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 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 da 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 do Google Workspace Marketplace.

• Requisitos para todos os apps
• Requisitos para integrações específicas de apps

Requisitos para todos os apps

É possível usar as caixas de seleção para acompanhar sua revisão preliminar. Desmarcar caixas de seleção

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 nome na tela de permissão OAuth. O nome não é vago nem muito genérico. O nome tem 50 caracteres ou menos. (Recomendado) O nome usa letras maiúsculas e minúsculas do título. (Recomendado) O nome não tem pontuação, principalmente 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 comerciante ou não comerciante: Comerciante: é uma pessoa que age para fins relacionados a um comércio, empresa, 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, a mensagem "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 para as informações corretas. Por exemplo, o link de uma Política de Privacidade direciona a uma página que a descreve. Se o app interagir com um serviço de terceiros, a descrição descreverá o que esse serviço faz, como o app interage com ele e, opcionalmente, um link para o site relevante. As descrições breve e detalhada 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. 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 criado para fins de 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 propriedades da marca Google, marcas registradas ou conteúdo de marca do 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, as permissões de escopo não são solicitadas novamente aos usuários individuais. 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ção como "Excluir" e "Cancelar". Se o login for necessário, a funcionalidade de saída vai funcionar corretamente. Os tokens são revogados e o login pode começar do início. O feedback é sempre exibido, como mensagens de confirmação ou erro, para as ações. Não há links de imagem corrompidos ou imagens distorcidas.
Gráficos	Os ícones estão dimensionados corretamente, 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 (não em escala 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 aplicativo 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 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 de apps incluídas na página "Detalhes do app" para ver os critérios de revisã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. Desmarcar caixas de seleção

Complemento do Google Workspace Complemento do editor App da Web Aplicativo do Google Drive App Google Chat

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 a Z (maiúscula) ou de 0 a 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 é adicionado a um espaço. A mensagem de boas-vindas é diferente do comando "Help". Para mais informações, consulte Enviar uma mensagem de card da página inicial do app. O app oferece suporte ao comando "Help" e ajuda os usuários a começar a usá-lo. Para saber mais, consulte Responder a comandos de barra. O app sempre responde quando falado em um espaço ou Chat direto. As mensagens usam ortografia, letras maiúsculas, pontuação e gramática corretas e 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 enviará uma mensagem explicando o atraso. 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 cartões que o app usa atendem 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 os quais o app interage não pertencem a um ambiente de preparação 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, faça o seguinte: 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 Visualizar links. (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 funcionalidade manipulando o HTML do Drive diretamente. Se o app usa escopos confidenciais ou restritos, ele precisa passar por uma verificação 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 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 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 ele oferece todas as ferramentas necessárias para concluir o fluxo de trabalho. Por exemplo: Se o complemento aplicar estilo a todo o documento, ele oferece 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 exige que o usuário tenha uma conta, ele fornece links ou informações para criar facilmente uma conta, 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 do complemento do Editor. Os modos de autorização estão configurados corretamente. Consulte Modos de autorização. O complemento precisa ser implementado no ambiente de execução do V8 do Apps Script. Para saber mais, 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 você tenha um entendimento básico do produto e como usá-lo. O código do complemento não usa bibliotecas excessivamente, já que elas podem fazer com que o complemento perca o desempenho. Se possível, os erros são evitados e gerenciados adequadamente. Caso contrário: 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, 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. Isso significa que: Está sempre claro o que fazer e como. O complemento é acessível e simples de entender. Evite termos técnicos e jargões. Os fluxos de trabalho são claros e facilitam 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. Ele 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 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 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 será avisado e confirmará a ação antes que ela aconteça. É possível evitar esse requisito com mudanças no design. Por exemplo, um complemento do Planilhas Google que importa dados cria o risco de substituir o conteúdo atual. 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 ficam 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 poderá ter mais de 30 caracteres.
Complemento do Google Workspace	Funcionalidade	O complemento usa os widgets corretos 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 sem problemas. Por exemplo, a criação de conferências não falhará se o usuário selecionar uma agenda diferente a que tenha acesso para edição ao criar um evento. 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 videoconferência, os campos de dados 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 notas. 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 oferecer soluções de videoconferência, a criação da conferê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/ é aceitável, 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 complementar funciona corretamente. Por exemplo, não há cards duplicados. Os botões "Voltar", "Atualizar" e "Atualizar" funcionam adequadamente. Depois que o usuário autoriza o complemento, ele mostra um card personalizado na 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 vai mostrar 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: 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 pode ser maior além de 300p, de modo que não tenha uma barra de rolagem horizontal. O código do complemento não usa bibliotecas excessivamente, já que 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 prévias 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 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 despeja 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.
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 usar calendar.conferenceSolution, o logotipo da solução de conferência seguirá os requisitos de calendar.logoUrl. Consulte Recurso de manifesto do Agenda. Se o complemento usa calendar.logoUrl ou common.logoUrl, o logotipo é 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/
Complemento do Google Workspace	OAuth	Complementos do Drive (Recomendado) Para 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.