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 el mercado. 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 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 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 Create project 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 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 App Configuration 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 e instalarlas en nombre de sus usuarios
- 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.
- 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 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 e 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 la 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 el mercado.
- 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é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 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 tu app se integra 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 las 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 compilaste 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 HTTP o alguna otra implementación > Seleccionar implementación.
- Selecciona la implementación que deseas publicar.
- Haz clic en Seleccionar.
Complemento del editor (Documentos, Hojas de cálculo, Presentaciones y Formularios)
Para publicar un complemento de Editor, debes proporcionar el ID de la 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 parte 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 el 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, en 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 proyectos de Apps Script, consulta Alcances de autorización para obtener más detalles.
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 es un comerciante o un no comerciante:
Si no se especifica, aparecerá el mensaje "Estado del comerciante no especificado" en la página de la ficha de Play Store de tu 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 recopila para los usuarios que no son 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 en el que se 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 esté actualizada a medida que la uses:
|
| 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.
Solucionar problemas
En esta sección, se describen los problemas habituales que puedes encontrar.
Faltan los permisos obligatorios cuando se publican apps en el mercado
No puedes publicar apps en Marketplace, ya que los intentos de configurar la aplicación en la página Configuración de la app del SDK de Marketplace fallan con el siguiente mensaje de error:
You are missing at least one of the following required permissions: Project workspacemarketplace.appconfiguration.view / workspacemarketplace.appconfiguration.update
Este error ocurre cuando la API del SDK de Marketplace está habilitada y cuando se usa un rol de IAM que no sea Editor o Owner.
Para resolver el error, implementa una de las siguientes soluciones:
Pídele al propietario del proyecto que asigne el rol
roles/appmetadata.workspaceMarketplaceAppConfigurationAdmina la cuenta con los permisos faltantes para permitirle configurar y administrar la app en el SDK de Marketplace.Pídele al propietario del proyecto que agregue los permisos faltantes a un rol personalizado a través de la página IAM y administración > Roles en la consola de Google Cloud. Luego, asigna el rol personalizado a la cuenta con los permisos que faltan.
Se puede usar
roles/editororoles/ownerprimitivo para publicar apps. Sin embargo, la documentación Cómo usar IAM de forma segura considera que esta es una práctica incorrecta, ya que no se puede restringir fácilmente el acceso de edición a otros recursos del proyecto.