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.

Si quieres que tu app esté disponible para usarla, debes configurarla en el SDK de Google Workspace Marketplace. El SDK de Google Workspace Marketplace es un kit de herramientas que te permite crear y controlar tu app en Google Workspace Marketplace. Usa el SDK de Google Workspace Marketplace para administrar la configuración de Marketplace, como se muestra a continuación:

  • 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

Sin importar si publicas tu app de forma pública o privada, debes usar el SDK de Google Workspace Marketplace para administrar tu app en Marketplace.

Habilita el SDK de Google Workspace Marketplace

Si aún no lo hiciste, en tu proyecto de Google Cloud, habilita el SDK de Google Workspace Marketplace:

  1. Abre la consola de Google Cloud
  2. En la parte superior, haz clic en Seleccionar un proyecto. Si ya hay otro proyecto de Google Cloud abierto, haz clic en su nombre para cambiarlo.
  3. Selecciona el proyecto de Cloud de tu app y haz clic en Abrir.
  4. En la parte superior, en la barra de búsqueda, escribe Google Workspace Marketplace SDK y presiona Intro.
  5. Abre la página del SDK de Google Workspace Marketplace.

  6. Si aún no está habilitado el SDK de Google Workspace Marketplace, haz clic en Habilitar.

Ingresa la configuración de la app en el SDK de Google Workspace Marketplace

  1. Abre el SDK de Google Workspace Marketplace.
  2. Vaya a la pestaña App Configuration.
  3. Completa cada sección con la información sobre tu app. Para obtener información sobre cada parámetro de configuración, consulta la siguiente sección Parámetros de configuración de la app.
  4. Haz clic en Guardar.
  5. Puedes obtener estadísticas sobre el uso de la app en Google Analytics (opcional). Para ello, agrega un ID de Google Analytics en el SDK de Google Workspace Marketplace.
    1. Ve a la pestaña Estadísticas.
    2. Ingresa tu ID de Google Analytics.
    3. Haz clic en Guardar.

Parámetros de configuración de la app

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

Visibilidad de la aplicación

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 institución educativa). Si usas una cuenta personal (una cuenta que termina en "@gmail.com"), solo puedes publicar contenido de forma pública.

  • Pública: 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 el contenido como No listado, no se mostrará la ficha de la app en la navegación ni en los resultados de la búsqueda. 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 las regiones en los que está disponible tu app, configúralo en la sección Distribución cuando crees la ficha de Play Store.

Configuración de la instalación

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

  • Instalación individual + instalación de administrador (configuración predeterminada): Los usuarios individuales o administradores pueden instalar la app en su dominio, unidad organizativa o grupo de usuarios. Es posible que las políticas de dominio de un usuario impidan que este instale una app, incluso si las instalaciones individuales están habilitadas.
  • Instalación solo para administradores: Solo los administradores pueden instalar la app en 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 sus Cuentas de Google. Elige esta opción si tu app requiere la instalación de un dominio.

Integración en la app

Elige los servicios de Google Workspace con los que está diseñado 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 Enumera 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 uno:

Complemento de Google Workspace (Apps Script)

Para publicar un complemento de Google Workspace, debes proporcionar su ID de implementación. Para encontrar el ID de implementación, sigue estos pasos:

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

Complemento de Google Workspace (entorno de ejecución alternativo)

Si creaste tu complemento de Google Workspace en un lenguaje de programación que no sea Google Apps Script, sigue estos pasos para obtener el ID de implementación del recurso de implementación de Google Cloud.

  1. En la página Configuración de la app, en “Complemento de Google Workspace”, haz clic en Implementar con el recurso de implementación en la nube > Seleccionar implementación.
  2. Selecciona la implementación que quieres publicar.
  3. 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 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 la 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 de Google Chat, debes configurar la API de Google Chat. Consulta Publicación de apps.

App de Drive

Para publicar una app de Drive, debes habilitar y configurar la API de Drive.

Aplicación web

Para publicar una app web, debes proporcionar su URL de navegación universal, que es 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 completas la página de la ficha de Play Store, debes proporcionar íconos adicionales con un tamaño de 96 x 96 y 48 x 48 píxeles.

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

  1. Abre el 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.

Permisos de OAuth

Proporciona una lista completa de los permisos de OAuth 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 alcances de cada una a la página de configuración de la app del SDK de Google Workspace Marketplace y tu pantalla de consentimiento de OAuth.

Usa siempre el menor alcance posible (por ejemplo, no incluyas un permiso completo de Drive si solo necesitas un permiso de solo lectura).

Para los proyectos de Apps Script, consulta Permisos para obtener más detalles.

Información para programadores

Estos campos aparecen en la página de la ficha de Play Store de la app.

Campos
Estado del comerciante

Debido a las leyes de protección al consumidor, se debe informar a los consumidores que se encuentran en el Espacio Económico Europeo (EEE) si un comercio de Google Workspace Marketplace es comerciante o no comerciante:

  • Comerciante: Es una persona que actúa con fines relacionados con una actividad comercial, un negocio, un oficio o una profesión, o en nombre de un comerciante o en su nombre.
  • No comerciante: Un no comerciante (consumidor) es una persona que actúa con fines no profesionales.

Si no se especifica, aparece "Estado del comerciante sin especificar" en la página de la ficha de Play Store de tu app.

Dirección de correo postal del desarrollador

Obligatorio para los comerciantes. No se recopila para los no comerciantes.

La ubicación de tu empresa. Ingresa una dirección de correo postal válida para que los usuarios puedan comunicarse contigo.

Nombre del desarrollador Es el nombre que se mostrará como el autor de la app. Si eres un comerciante, proporciona tu nombre comercial o legal.
URL del sitio web del desarrollador El sitio web que te describe a ti (o a tu organización) como 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 se mantenga actualizada, ya que se usa de la siguiente manera:

  • 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 de informe de problemas 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 la app.