En esta página, se explica cómo usar el SDK de Google Workspace Marketplace para configurar y administrar tu app en Google Workspace Marketplace.
Para 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 de Marketplace 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 creó y mantiene la app
Independientemente de si publicas tu app de forma privada o pública, debes usar el SDK de Marketplace para administrarla en el mercado.
Habilita el SDK de Marketplace
Si aún no lo hiciste, 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:
- En la consola de Google Cloud, ve a la página Seleccionar un proyecto.
- 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.
Determina la 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 sobre cómo agregar la app a la lista.
- Desactivar ciertas aplicaciones de Google Workspace, como quitar el acceso a Google Chat, a las apps de Google Chat o a ambos En estos casos, los usuarios no podrán instalar tu app desde Marketplace.
Para obtener información sobre cómo los administradores gestionan 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 de tu 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 | Configuración de visibilidad de la app | Configuración de instalación de apps | ¿Quién puede instalar mi app? | ¿Quiénes pueden usar mi app? | |
|---|---|---|---|---|---|
| Apps diseñadas para organizaciones con Google Workspace | |||||
| Usuarios específicos de tu organización | Privada y No listada | Instalación individual y de administrador | Si se permite, cualquier persona 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 se permite, cualquier persona 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 |
|
|
|
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:
Complemento de Google Workspace (Apps Script)
Para publicar un complemento de Google Workspace, debes proporcionar el ID de implementación del complemento. Para encontrar el ID de implementación, sigue estos pasos:
- Abre el complemento de Google Workspace en el editor de Apps Script.
- Haz clic en Implementar > Administrar implementaciones.
- Debajo del ID de implementación, haz clic en Copiar.
Complemento de Google Workspace (implementaciones HTTP)
Si creaste tu complemento de Google Workspace con extremos HTTP, sigue estos pasos para obtener el ID de implementación del recurso de implementación de Google Cloud.
- En la página Configuración de la app, en “Complemento de Google Workspace”, haz clic en Implementaciones de HTTP o de otro tipo > Seleccionar implementación.
- Selecciona la implementación que deseas publicar.
- Haz clic en Seleccionar.
Complemento del editor (Documentos, Hojas de cálculo, Presentaciones, Formularios)
Para publicar un complemento de editor, debes proporcionar el ID de secuencia de comandos del proyecto y la versión que deseas publicar.
Para encontrar el ID de la secuencia de comandos del proyecto, sigue estos pasos:
- Abre el complemento en el editor de Apps Script.
- A la izquierda, haz clic en Configuración del proyecto .
- En "IDs", copia el ID de la secuencia de comandos.
Para encontrar la versión, sigue estos pasos:
- Abre el complemento en el editor de Apps Script.
- En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
- El número de versión se encuentra en "Configuración".
App de Google Chat
Para publicar una app de Google Chat, debes configurar la API de Google Chat. Consulta Cómo publicar apps de Google Chat.
App de Drive
Para publicar una app de Drive, debes habilitar y configurar la API de Google Drive.
App web
Para publicar una app web, debes proporcionar su URL de navegación universal, la URL que dirige a la app web desde el menú de apps de Google . Tu app web debe estar en producción y ser completamente funcional.
Cuando completes la página de la ficha de Play Store, debes proporcionar íconos adicionales de 96 × 96 y 48 × 48 píxeles.
Si compilaste tu app web en Apps Script, sigue estos pasos para obtener la URL de navegación universal:
- Abre tu complemento de Google Workspace en el editor de Apps Script.
- Haz clic en Implementar > Nueva implementación.
- En "Seleccionar tipo", haz clic en Aplicación web.
- Completa las opciones y haz clic en Implementar.
- Haz clic en Copiar.
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.
Siempre usa los permisos más limitados posibles (por ejemplo, no incluyas un permiso de Drive completo si solo necesitas uno 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, se debe informar a los consumidores que residen en el Espacio Económico Europeo (EEE) si un comercio en Google Workspace Marketplace es un comerciante o un no comerciante de la siguiente manera:
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 | 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 |
Es 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 se mantenga actualizada mientras se usa:
|
| 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:
En la consola de Google Cloud, ve a la página Configuración del SDK de Marketplace:
Completa cada sección según lo que determinaste en la sección anterior.
Haz clic en Guardar.
De forma opcional, puedes obtener estadísticas sobre el uso de la app en Google Analytics. Para ello, agrega un ID de Google Analytics en el SDK de Marketplace.
- Ve a la pestaña Analytics.
- Ingresa tu ID de Google Analytics.
- Haz clic en Guardar.