Tem cinco minutos? Ajude a melhorar a documentação do Google Workspace Marketplace respondendo a uma pesquisa on-line rápida.

Esta página foi traduzida pela API Cloud Translation.

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:

Abra o Console do Google Cloud.
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.
Selecione o projeto do Cloud do seu app e clique em Abrir.
Na parte de cima, na barra de pesquisa, digite Google Workspace Marketplace SDK e pressione Enter.
Abra a página do SDK do Google Workspace Marketplace.

Aviso :ative o SDK do Google Workspace Marketplace, não a API. O A API Google Workspace Marketplace é outra ferramenta usada para integração Serviços de licenciamento e faturamento do Google.
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íveis para todos os usuários na sua organização ou para qualquer pessoa que use no 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 individual + administração (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:

Complemento do Google Workspace (Apps Script)

Para publicar um complemento do Google Workspace, você precisa fornecer o ID de implantação. Para encontrar o ID de implantação, siga estas etapas:

Abrir seu complemento do Google Workspace no Apps Script editor.
Clique em Implantar > Gerenciar implantações.
Abaixo do ID de implantação, clique em Copiar.

Complemento do Google Workspace (tempo de execução alternativo)

Se você criou seu complemento do Google Workspace em outra linguagem de programação Google Apps Script, siga estas etapas para conseguir o ID de implantação da recurso de implantação do Google Cloud.

Na página "Configuração do app", em "Complemento do Google Workspace", clicar Implantar usando o recurso de implantação na nuvem > Selecione Implantação.
Selecione a implantação que você quer publicar.
Clique em Selecionar.

Complemento Editor (Documentos, Planilhas, Apresentações, Formulários)

Para publicar um complemento do editor, forneça o ID do script do projeto e a versão que você quer publicar.

Para encontrar o ID do script do projeto, siga estas etapas:

Abra o complemento no editor do Apps Script.
À esquerda, clique em Configurações do projeto.
Em "IDs", copie o ID do script.

Para encontrar a versão, siga estas etapas:

Abra o complemento no editor do Apps Script.
No canto superior direito, clique em Implantar > Gerenciar implantações.
O número da versão está em "Configuração".

App Google Chat

Para publicar um app do Google Chat, configure a API Google Chat. Consulte Publicações apps.

Aplicativo do Google Drive

Para publicar um app do Drive, você precisa ativar e configurar o API Drive.

App da Web

Para publicar um app da Web, é preciso fornecer o URL de navegação universal, o URL que aponta para o app da Web a partir do menu do Google apps . Seu app da Web precisa estar em produção e totalmente funcional.

Ao preencher a página "Detalhes do app", é preciso fornecer ícones adicionais dimensionados para 96 x 96 e 48 x 48 pixels.

Se você criou seu app da Web no Apps Script, para ter a versão , siga estas etapas:

Abrir seu complemento do Google Workspace no Apps Script editor.
Clique em Implantar > Nova implantação.
Em "Selecionar tipo", Clique em App da Web.
Preencha as opções e clique em Implantar.
Clique em Copiar.

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:

Abra o SDK do Google Workspace Marketplace.
Acesse a guia App Configuration.
Preencha cada seção com base no que você determinou no seção anterior.
Clique em Salvar.
(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.