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 administrar tu app en Google Workspace Marketplace.

Para que tu app esté disponible, 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 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)
• 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 Marketplace.

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 esta muestra:

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

   Selecciona un proyecto de Cloud

2. Selecciona el proyecto de Google Cloud que deseas usar. O bien, haz clic en Crear proyecto y sigue 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.

  Habilita el SDK

Advertencia: Asegúrate de habilitar el SDK de Google Workspace Marketplace, no la API. La API de Google Workspace Marketplace es una herramienta diferente que se usa para integrar los servicios de facturación y licencias de Google.

Determina la configuración de tu app

En la siguiente referencia, se describen los parámetros de configuración disponibles 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 los siguientes parámetros de configuración:

• Visibilidad de la app: Si publicas una app en una organización de Google Workspace, indica si la ficha de Play Store de la app no está disponible en la lista, si 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 tu app, es posible que los usuarios que pertenezcan a una organización de Google Workspace no puedan descubrir, instalar o usar tu app según la configuración establecida por sus administradores. Los administradores pueden afectar la disponibilidad de tu app de las siguientes maneras:

• Controlar si sus usuarios pueden ver apps en Marketplace y si pueden instalarlas en nombre de sus usuarios
• Usar una lista de entidades permitidas para administrar y seleccionar apps para su organización Si desarrollas una app para una organización que usa listas de entidades permitidas, consulta con un administrador para que la agregue 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

Advertencia: Una vez que elijas una opción de visibilidad y guardes la página Configuración de la app, no podrás cambiar tu selección más adelante.

Verás la opción Visibilidad de la app si usas una cuenta de Google Workspace (una cuenta creada por tu organización laboral 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 tu 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 Play Store 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 Play Store de la app con la URL directa.

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

Configuración de instalación de la app

La opción Installation Settings 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 Marketplace.

Nota: En el caso de las apps de Google Chat, solo puedes seleccionar Instalación individual + instalación de administrador, ya que las personas pueden descubrir e instalar apps de Chat directamente desde Google Chat. Para obtener detalles sobre cómo funciona la instalación, consulta Cómo descubren y usan los usuarios las apps de Chat.

• Instalación individual + de administrador (predeterminada): Los usuarios individuales o los administradores pueden instalar la app para su dominio, unidad organizativa o grupo de usuarios. Es posible que las políticas del dominio de un usuario le impidan instalar 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 grupo de usuarios. Tu app solo aparece en los resultados de la búsqueda de Google Workspace Marketplace para los administradores y las personas que no accedieron a su Cuenta de Google. Elige esta opción si tu app requiere la instalación del 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	Parámetro de configuración de instalación de apps	¿Quién puede instalar mi app?	¿Quiénes pueden usar mi app?
Para apps creadas para una organización de Google Workspace
Usuarios específicos de tu organización	Privado y No listado	Instalación individual + 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 + 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 que tienen la app instalada por su administrador.
Para las apps disponibles para los usuarios fuera de una organización específica de Google Workspace
Usuarios de organizaciones de Google Workspace	Pública	Solo para administradores	Administradores	Usuarios que tienen la app instalada por su administrador.
Todos los usuarios de Google Workspace	Pública	Instalación individual + de administrador	Cualquier persona que use las aplicaciones de Google Workspace para uso personal Si se permite, los usuarios de organizaciones de Google Workspace	Cualquier persona que use las aplicaciones de Google Workspace para uso personal Si se permite, los usuarios de 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, 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 tu app. Consulta Cómo enumerar las integraciones de apps juntas.

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

Complemento de Google Workspace

Para publicar un complemento de Google Workspace, debes proporcionar su ID de implementación.

Para encontrar el ID de implementación en Apps Script, sigue estos pasos:

1. Abre tu complemento de Google Workspace en el editor de Apps Script.
2. Haz clic en Implementar > Administrar implementaciones.
3. Debajo del ID de implementación, haz clic en Copiar.

Para encontrar el ID de implementación de un complemento de HTTP, sigue estos pasos:

1. En la página Configuración de la app, en "Complemento de Google Workspace", haz clic en Implementaciones HTTP o de otro tipo > Seleccionar implementación.
2. Selecciona la implementación que deseas publicar.
3. Haz clic en Seleccionar.

Nota: Si tu complemento extiende Google Chat, también debes configurar la API de Google Chat. Para conocer los pasos, consulta Cómo configurar una app de Chat.

Complemento del editor (Documentos, Hojas de cálculo, Presentaciones y Formularios)

Para publicar un complemento del 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:

1. Abre el complemento en el editor de Apps Script.
2. A la izquierda, haz clic en Configuración del proyecto .
3. En "IDs", copia el ID de secuencia de comandos.

Para encontrar la versión, sigue estos pasos:

1. Abre el complemento en el editor de Apps Script.
2. En la esquina superior derecha, haz clic en Implementar > Administrar implementaciones.
3. El número de versión se encuentra en "Configuración".

App de Google Chat

Para publicar una app interactiva de Google Chat, consulta la siguiente documentación:

• Si creaste tu app de Chat como un complemento, debes configurar los parámetros del complemento en la API de Chat. Para conocer los pasos, consulta Configura una app de Chat en la documentación del complemento de Google Workspace.
• Si creaste tu app de Chat con eventos de interacción, debes configurar los parámetros de configuración de los eventos de interacción en la API de Chat. Para conocer los pasos, consulta Cómo recibir y responder a eventos de interacción en la documentación de la API de Chat.
• Si compilaste tu app de Chat con la configuración automática de AppSheet, publícala siguiendo los pasos que se describen en la documentación de AppSheet, Comparte tu app de Chat con la configuración automática.

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, que es la URL que apunta 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, deberás proporcionar íconos adicionales de 96 x 96 y 48 x 48 píxeles.

Si creaste tu aplicación web en Apps Script, sigue estos pasos para obtener la URL de navegación universal:

1. Abre tu complemento de Google Workspace en el editor de Apps Script.
2. Haz clic en Implementar > Nueva implementación.
3. En "Seleccionar tipo", haz clic en Aplicación web.
4. Completa las opciones y haz clic en Implementar.
5. 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 los que se muestran 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 la 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 específicos posibles (por ejemplo, no incluyas un permiso completo de Drive si solo necesitas un permiso de solo lectura).

Para los 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, se debe informar a los consumidores que residen en el Espacio Económico Europeo (EEE) si un comercio del Marketplace es un comerciante o un no comerciante: Comerciante: Un comerciante es una persona que actúa con fines relacionados con un comercio, negocio, oficio o profesión, o en nombre de un comerciante. No comerciante: Un no comerciante (consumidor) es una persona que actúa con fines no profesionales. Si no se especifica, aparecerá el mensaje "Estado de comerciante no especificado" en la página de la ficha de Play Store de tu app.
Nombre del desarrollador	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 operadores. No se recopilan para los no comerciantes. La ubicación de tu empresa Ingresa una dirección postal válida para que los usuarios puedan comunicarse contigo.
URL del sitio web del desarrollador	El sitio web que lo describe a usted (o a su organización) como el desarrollador.
Correo electrónico del desarrollador	Dirección de correo electrónico que se usará como punto de contacto. No se incluye en la ficha de Play Store de tu app. Asegúrate de que esta dirección de correo electrónico esté actualizada, ya que se usa para lo siguiente: Si Google necesita comunicarse con el desarrollador, por ejemplo, durante el proceso de revisión de la app Enviar comentarios desde los complementos del Editor si no se proporciona una URL de Informe de problemas en la página de Play Store
URL del sitio web de la aplicación	Opcional. Es el sitio web que describe tu app con más detalle.

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 de la app del SDK de Marketplace:

   Ir a la página de 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 borrador.

4. (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.

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

Solucionar problemas

En esta sección, se describen los problemas comunes que puedes encontrar.

Faltan los permisos obligatorios cuando se publican apps en Marketplace

No puedes publicar apps en Marketplace, ya que los intentos de configurar la aplicación en la página Configuración de la aplicación del SDK de Marketplace fallan y muestran 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 se produce 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 de roles/appmetadata.workspaceMarketplaceAppConfigurationAdmin a 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 faltantes.

• Se pueden usar los tipos primitivos roles/editor o roles/owner para publicar apps. Sin embargo, la documentación de Usa IAM de forma segura considera que esta es una práctica inadecuada, ya que no se puede restringir fácilmente el acceso de edición a otros recursos del proyecto.