Configurar o app no SDK do Google Workspace Marketplace

Nesta página, explicamos como usar o SDK do Google Workspace Marketplace para configurar e gerenciar sua no Google Workspace Marketplace.

Para disponibilizar o app para uso, ele precisa ser configurado no SDK do Google Workspace Marketplace. O SDK do Google Workspace Marketplace é um kit de ferramentas para criar e controlar no Google Workspace Marketplace. Use o SDK do Google Workspace Marketplace para gerenciar Configurações do Marketplace, como as seguintes:

• Se o app está disponível para uma organização específica do Google Workspace (um aplicativo particular) ou para todos os usuários do Marketplace (um public)
• Os tipos de usuários do Marketplace que podem instalar seu aplicativo
• Com quais aplicativos do Google Workspace seu app se integra
• Os escopos do OAuth exigidos pelo app
• Informações sobre quem cria e faz a manutenção do app

Não importa se você está publicando seu app de forma pública ou particular, use o SDK do Google Workspace Marketplace para gerenciar app no Marketplace.

Ativar o SDK do Google Workspace Marketplace

Caso ainda não tenha feito isso, no seu projeto do Google Cloud, Ative o SDK do Google Workspace Marketplace:

1. Abra o Console do Google Cloud.
2. Na parte de cima, clique em Selecionar um projeto. Se outro projeto do Google Cloud for já estiver aberto, clique no nome do projeto do Cloud para alternar projetos do Google Cloud.
3. Selecione o projeto do Cloud do seu app e clique em Abrir.
4. Na parte de cima, na barra de pesquisa, digite Google Workspace Marketplace SDK e pressione Enter.

5. Abra a página do SDK do Google Workspace Marketplace.

6. Se o SDK do Google Workspace Marketplace ainda não estiver ativado, clique em Ativar.

Determinar as configurações do seu app

A referência a seguir descreve as configurações disponíveis no Gerenciador de Configuração do SDK do Google Workspace Marketplace.

Escolha quem pode acessar e instalar o app

Ao configurar o aplicativo, você especifica os usuários que podem acessá-lo usando as seguintes configurações:

• Visibilidade do app: se você estiver publicando um app em um organização do Google Workspace, quer a página "Detalhes do app" não esteja listada; visível para todos os usuários na sua organização ou para qualquer pessoa que use Google Workspace.
• Configurações de instalação: se o app só pode administradores do Google Workspace.

Independentemente das configurações especificadas na página "Detalhes do app", os usuários que pertencem a uma organização do Google Workspace pode não conseguir encontrar, instalar ou usar o app com base nas configurações definidas pelos administradores. Administradores podem afetar a disponibilidade do app das seguintes maneiras:

• Controlar se os usuários podem visualizar os apps na Marketplace e instalar apps em nome dos próprios usuários.
• Usar uma lista de permissões para gerenciar e selecionar apps para a organização. Se estiver desenvolvendo um app para uma organização que usa listas de permissões, consulte um administrador sobre como adicionar o app à lista de permissões.
• Desativação de determinados aplicativos do Google Workspace, como a remoção acesso ao Google Chat, aos apps do Google Chat ou a ambos. Nesses casos, os usuários não conseguirão instalar o app da Google Marketplace.

Para saber como os administradores gerenciam o acesso aos Marketplace, consulte a Documentação de ajuda para admins do Marketplace

Configurações de visibilidade do app

A opção Visibilidade do app vai aparecer se você estiver usando uma conta do Google Workspace , (uma conta criada por sua organização escolar ou de trabalho). Se você estiver com uma conta pessoal (que termina com "@gmail.com"), só é possível publicar publicamente.

• Público: o app pode ser encontrado e instalado por pessoas fora da sua domínio. Se você escolher a visibilidade pública, o Google vai analisar e aprovar seu app listagem antes que ela seja publicada.
• Particular: somente as pessoas no seu domínio podem encontrar e instalar o app.

Se você optar por publicar como Não listado, a página de detalhes do app não vai aparecer na navegação ou resultados de pesquisa. Os usuários só podem acessar a página da loja do aplicativo com o URL.

Se você quiser limitar em quais países e regiões o app está disponível, que você configura na seção Distribuição ao criar a página "Detalhes do app".

Configurações de instalação de apps

As configurações de instalação determinam se os usuários ou administradores do Workspace podem instalar seu app na página "Detalhes do app" no Google Workspace Marketplace.

• Instalação do administrador + individual (padrão): o app pode ser instalado pelo usuários individuais ou por administradores de seu domínio, unidade organizacional ou grupo de usuários. As políticas de domínio de um usuário podem impedir a instalação um app, mesmo que as instalações individuais estejam ativadas.
• Instalação apenas pelo administrador: o app só pode ser instalado por administradores para os domínio, unidade organizacional ou grupo de usuários. Seu app só aparece em Resultados da pesquisa do Google Workspace Marketplace para administradores e pessoas que não fizeram login na Conta do Google. Escolha essa opção se o app requer instalação no domínio.

Configurações comuns de instalação e visibilidade

A tabela a seguir resume algumas das opções comuns de configurações de aplicativo para instalação e visibilidade:

Usuários pretendidos do app	Configuração Visibilidade do app	Configuração Instalação de apps	Quem pode instalar meu app?	Quem pode usar meu app?
Para apps criados para uma organização do Google Workspace
Usuários específicos na sua organização	Privado e Não listado	Instalação pelo administrador e individual	Se permitido, qualquer pessoa na sua organização que tenha o URL da página "Detalhes do app".	Se permitido, qualquer pessoa na sua organização que tenha o URL da página "Detalhes do app".
Sua organização	Privado	Instalação pelo administrador e individual	Se permitido, qualquer pessoa na sua organização.	Se permitido, qualquer pessoa na sua organização.
Sua organização	Privado	Somente administrador	Administradores	Usuários que instalaram o app pelo administrador.
Para apps disponíveis para usuários fora de uma organização específica do Google Workspace
Usuários em organizações do Google Workspace	Público	Somente administrador	Administradores	Usuários que instalaram o app pelo administrador.
Todos os usuários do Google Workspace	Público	Instalação pelo administrador e individual	Qualquer pessoa que usa os aplicativos do Google Workspace para uso pessoal. Se permitido, os usuários em organizações do Google Workspace.	Qualquer pessoa que usa os aplicativos do Google Workspace para uso pessoal. Se permitido, os usuários em organizações do Google Workspace.

Identificar como seu app se integra aos aplicativos do Google Workspace

Escolha os serviços do Google Workspace para os quais o app ou complemento foi desenvolvido trabalhar, como um complemento do Google Workspace app Google Chat. É preciso escolher pelo menos uma opção. Em alguns casos, é possível incluir várias integrações na página "Detalhes do app". Consulte Listar integrações de apps.

Dependendo das integrações de apps que você escolher, talvez seja necessário fornecer mais e ativar APIs relevantes no projeto do Google Cloud. O seguinte tabela descreve a configuração adicional necessária para cada um:

Especificar o nível de acesso exigido pelo app

Em Escopos do OAuth, forneça uma lista completa dos escopos do OAuth do seu app. exige. Os escopos do OAuth inseridos aqui devem corresponder ao que você exibe na Tela de permissão OAuth e, se aplicável, o manifesto do Apps Script.

Se você incluir mais de uma integração de app, adicione os escopos do cada um para a página de configuração do app SDK do Google Workspace Marketplace e seu consentimento do OAuth tela.

Sempre use os escopos mais estreitos possíveis (por exemplo, não inclua um Impulsione o escopo se você precisar apenas de um escopo somente leitura).

Para projetos do Apps Script, consulte Escopos para mais detalhes.

Fornecer informações sobre o desenvolvedor do app

Em Informações do desenvolvedor, preencha os dados de contato e outros detalhes. Esses campos aparecem página "Detalhes do app".

Campos
Status do comerciante	Devido às leis de proteção ao consumidor, os consumidores com sede na Europa do Espaço Econômico (EEE) precisa ser informado se um comerciante na O Google Workspace Marketplace é um comercial ou um não comerciante: Empreendedor: é uma pessoa que age para fins relacionados a um comércio, empresa, ofício ou profissão; no nome de ou em em nome de um comerciante. Não comerciante: um não comerciante (consumidor) é uma pessoa que atua para para fins não profissionais. Se não for especificado, "Status do comerciante não especificado" aparece na tela do seu app página "Detalhes do app" página.
Endereço de correspondência do desenvolvedor	Obrigatório para comerciantes. Não coletado para não comerciantes. A localização da sua empresa. Insira um endereço de correspondência válido pode ser contatado.
Nome do desenvolvedor	O nome a ser exibido como o autor do aplicativo. Se você é comerciante, forneça seu nome comercial ou razão social.
URL do site do desenvolvedor	O site que descreve você (ou sua organização) como desenvolvedor.
E-mail do desenvolvedor	O endereço de e-mail a ser usado como ponto de contato. Está não incluídos na página "Detalhes do app". Verifique se esse endereço de e-mail está atualizado data. Ela é usada: Se o Google precisar entrar em contato com o desenvolvedor, por exemplo, durante a processo de revisão de apps. Para enviar feedback dos complementos do Editor caso o URL "Informar problema" não seja fornecidos na página "Detalhes do app".
URL do site do aplicativo	Opcional. O site que descreve melhor seu aplicativo.

Salvar as configurações do app no SDK do Google Workspace Marketplace

Com as informações da seção anterior, salve a configuração do app no SDK do Google Workspace Marketplace:

1. Abra o SDK do Google Workspace Marketplace.
2. Acesse a guia App Configuration.
3. Preencha cada seção com base no que você determinou no seção anterior.
4. Clique em Salvar.
5. (Opcional) Você pode receber análises sobre o uso do aplicativo. no Google Analytics. Para fazer isso, adicione um ID do Google Analytics. no SDK do Google Workspace Marketplace.
   1. Acesse a guia Analytics.
   2. Insira seu ID do Google Analytics.
   3. Clique em Salvar.