Configura tu app en el SDK de Google Workspace Marketplace

En esta página, se explica cómo usar el SDK de Google Workspace Marketplace para configurar y gestionar tu app en Google Workspace Marketplace.

Si quieres que tu app esté disponible para su uso, debes configurarla en el SDK de Marketplace. El SDK de Marketplace es un kit de herramientas que te permite crear y controlar tu app en Google Workspace Marketplace. Usas el SDK de Marketplace para administrar la configuración de Marketplace, como la siguiente:

• Si tu app está disponible para una organización específica de Google Workspace (una app privada) o para todos los usuarios de Marketplace (una app pública)
• Los tipos de usuarios del mercado que pueden instalar tu app
• Con qué aplicaciones de Google Workspace se integra tu app
• Los permisos de OAuth que requiere tu app
• Información sobre quién compiló y mantiene la app

Independientemente de si publicas tu app de forma privada o pública, debes usar el SDK de Marketplace para administrar tu app en la plataforma.

Habilita el SDK de Marketplace

Si aún no lo has hecho, habilita el SDK de Google Workspace Marketplace en tu proyecto de Google Cloud.

Abre tu proyecto de Cloud en la consola de Google Cloud

Si aún no está abierto, abre el proyecto de Cloud que deseas usar para este ejemplo:

1. En la consola de Google Cloud, ve a la página Selecciona un proyecto.

   Selecciona un proyecto de Cloud

2. Selecciona el proyecto de Google Cloud que deseas usar. También puedes hacer clic en Crear proyecto y seguir las instrucciones en pantalla. Si creas un proyecto de Google Cloud, es posible que debas activar la facturación para el proyecto.

Activa el SDK de Google Workspace Marketplace

Antes de usar las APIs de Google, debes activarlas en un proyecto de Google Cloud. Puedes activar una o más APIs en un solo proyecto de Google Cloud.

• En la consola de Google Cloud, habilita el SDK de Google Workspace Marketplace.

  Habilita el SDK

Determina los parámetros de configuración de tu app

En la siguiente referencia, se describe la configuración disponible en la página Configuración de la app del SDK de Marketplace.

Elige quién puede ver e instalar tu app

Cuando configuras tu app, especificas los usuarios que pueden acceder a ella con la siguiente configuración:

• Visibilidad de la app: Si publicas una app en una organización de Google Workspace, debes indicar si la ficha de la app está oculta, es visible para todos los usuarios de tu organización o para cualquier persona que use Google Workspace.
• Configuración de instalación: Indica si solo los administradores de Google Workspace pueden instalar la app.

Independientemente de la configuración que especifiques en la ficha de la app, es posible que los usuarios que pertenecen a una organización de Google Workspace no puedan descubrir, instalar ni usar tu app según la configuración que establezcan sus administradores. Los administradores pueden afectar la disponibilidad de tu app de las siguientes maneras:

• Controlar si los usuarios pueden ver apps en el mercado y, además, instalarlas en su nombre
• Usar una lista de entidades permitidas para administrar y seleccionar apps para su organización Si estás desarrollando una app para una organización que usa listas de entidades permitidas, consulta con un administrador para agregar la app a la lista.
• Desactiva ciertas aplicaciones de Google Workspace, como la de quitar el acceso a Google Chat, a las apps de Google Chat o ambas. En estos casos, los usuarios no podrán instalar tu app desde el mercado.

Para obtener información sobre cómo los administradores administran el acceso a Marketplace, consulta la documentación de ayuda para administradores de Marketplace.

Configuración de visibilidad de la app

Verás la opción Visibilidad de la app si usas una cuenta de Google Workspace (una cuenta creada por tu organización de trabajo o educativa). Si usas una cuenta personal (una cuenta que termina en "@gmail.com"), solo puedes publicar contenido de forma pública.

• Pública: Las personas ajenas a tu dominio pueden encontrar y también instalar la app. Si eliges la visibilidad pública, Google revisará y aprobará la ficha de la app antes de que se publique.
• Privada: Solo las personas del dominio pueden encontrar e instalar tu app.

Si eliges publicar como No listada, la ficha de la app no se mostrará en los resultados de la búsqueda ni en la navegación. Los usuarios solo pueden acceder a la página de la tienda de la app con la URL directa.

Si quieres limitar los países y regiones en los que está disponible tu app, puedes configurarlo en la sección Distribución cuando crees la ficha de Play Store.

Configuración de instalación de la app

La opción Configuración de instalación determina si los usuarios o los administradores de Google Workspace pueden instalar tu app desde la página de la ficha de Play Store en Google Workspace Marketplace.

• Instalación individual + de administrador (predeterminada): Los usuarios individuales o los administradores pueden instalar la app para su dominio, unidad organizativa o un grupo de usuarios. Las políticas de dominio de un usuario pueden impedir que instale una app, incluso si las instalaciones individuales están habilitadas.
• Instalación solo para administradores: Solo los administradores pueden instalar la app para su dominio, unidad organizativa o un grupo de usuarios. Tu app solo aparecerá en los resultados de la búsqueda de Google Workspace Marketplace para los administradores y las personas que no hayan accedido a sus Cuentas de Google. Elige esta opción si tu app requiere la instalación de un dominio.

Configuración común de instalación y visibilidad

En la siguiente tabla, se resumen algunas de las opciones de configuración comunes de la app para la instalación y la visibilidad:

Usuarios previstos de la app	Parámetro de configuración de Visibilidad de la app	Configuración de instalación de apps	¿Quién puede instalar mi app?	¿Quién puede usar mi app?
Para apps compiladas para una organización de Google Workspace
Usuarios específicos de tu organización	Privada y No listada	Instalación individual y de administrador	Si lo permites, cualquier miembro de tu organización que tenga la URL de la ficha de la app.	Si se permite, cualquier persona de tu organización que tenga la URL de la ficha de la app
Tu organización	Privado	Instalación individual y de administrador	Si se permite, cualquier persona de tu organización.	Si lo permites, cualquier miembro de tu organización.
Tu organización	Privado	Solo para administradores	Administradores	Usuarios a los que el administrador les instaló la app.
Para apps disponibles para usuarios fuera de una organización específica de Google Workspace
Usuarios de organizaciones de Google Workspace	Pública	Solo para administradores	Administradores	Usuarios a los que el administrador les instaló la app.
Todos los usuarios de Google Workspace	Pública	Instalación individual y de administrador	Cualquier persona que use las aplicaciones de Google Workspace para uso personal. Si se permite, los usuarios de las organizaciones de Google Workspace	Cualquier persona que use las aplicaciones de Google Workspace para uso personal. Si se permite, los usuarios de las organizaciones de Google Workspace

Identifica cómo se integra tu app con las aplicaciones de Google Workspace

Elige los servicios de Google Workspace con los que se diseñaron tu app o complemento para funcionar, como un complemento de Google Workspace o una app de Google Chat. Debes elegir al menos una opción. En algunos casos, puedes incluir varias integraciones de apps en la ficha de la app. Consulta Cómo enumerar integraciones de apps.

Según las integraciones de apps que elijas, es posible que debas proporcionar más información y habilitar las APIs relevantes en tu proyecto de Google Cloud. En la siguiente tabla, se describe la configuración adicional necesaria para cada una de ellas:

Especifica el nivel de acceso que requiere tu app

En OAuth Scopes, proporciona una lista completa de los permisos de OAuth 2.0 que requiere tu app. Los permisos de OAuth que ingreses aquí deben coincidir con lo que muestres en la pantalla de consentimiento de OAuth y, si corresponde, con el manifiesto de Apps Script.

Si incluyes más de una integración de app, asegúrate de agregar los permisos de cada una a la página de configuración de la app del SDK de Marketplace y a la pantalla de consentimiento de OAuth.

Usa siempre los alcances más reducidos posibles (por ejemplo, no incluyas un alcance de Drive completo si solo necesitas un alcance de solo lectura).

Para obtener más información sobre los proyectos de Apps Script, consulta Permisos de autorización.

Proporciona información sobre el desarrollador de la app

En Información del desarrollador, completa la información de contacto y otros detalles. Estos campos aparecen en la página de la ficha de Play Store de tu app.

Campos
Estado del comerciante	Debido a las leyes de protección al consumidor, los consumidores que residen en el Espacio Económico Europeo (EEE) deben saber si un comercio del mercado de Google Workspace es un comerciante o un no comerciante: Comerciante: Es una persona que actúa con fines relacionados con un comercio, negocio, oficio o profesión, o en nombre de un comerciante o en su representación. No comerciante: Un no comerciante (consumidor) es una persona que actúa con fines no profesionales. Si no se especifica, aparece el mensaje "Estado del comerciante no especificado" en la página de la ficha de Play Store de la app.
Nombre del desarrollador	Es el nombre que se mostrará como autor de la app. Si eres comerciante, proporciona tu nombre comercial o legal.
Dirección de correo postal del desarrollador	Obligatorio para los comercios. No se recopilan para no comerciantes. La ubicación de tu empresa. Ingresa una dirección de correo postal válida para que los usuarios puedan comunicarse contigo.
URL del sitio web del desarrollador	El sitio web que te describe a ti (o a tu organización) como el desarrollador
Correo electrónico del desarrollador	La dirección de correo electrónico que se usará como punto de contacto. No se incluye en la ficha de la app. Asegúrate de que esta dirección de correo electrónico esté actualizada a medida que la uses: Si Google necesita comunicarse con el desarrollador, por ejemplo, durante el proceso de revisión de la app. Para enviar comentarios desde los complementos de editor si no se proporciona una URL para informar un problema en la página de la ficha de Play Store.
URL del sitio web de la aplicación	Opcional. Es el sitio web que describe mejor tu app.

Guarda la configuración de tu app en el SDK de Marketplace

Con la información de la sección anterior, guarda la configuración de tu app en el SDK de Marketplace:

1. En la consola de Google Cloud, ve a la página Configuración del SDK de Marketplace:

   Ve a la página Configuración del SDK de Marketplace

2. Completa cada sección según lo que determinaste en la sección anterior.

3. Haz clic en Guardar.

4. De forma opcional, puedes obtener estadísticas sobre el uso de la app en Google Analytics. Para hacerlo, agrega un ID de Google Analytics en el SDK de Marketplace.

   1. Ve a la pestaña Analytics.
   2. Ingresa tu ID de Google Analytics.
   3. Haz clic en Guardar.