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 tus en Google Workspace Marketplace.

Si quieres que tu app esté disponible para su uso, 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 tus en Google Workspace Marketplace. Usas el SDK de Google Workspace Marketplace para administrar 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 aplicación
  • 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

Ya sea que publiques o no pública o privada de tu app, debes usar el SDK de Google Workspace Marketplace para administrar tus 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 Google Cloud Console
  2. En la parte superior, haz clic en Seleccionar un proyecto. Si un proyecto de Google Cloud diferente ya abiertos, haz clic en el nombre del proyecto de Cloud para cambiar proyectos de Google Cloud.
  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 el SDK de Google Workspace Marketplace no está habilitado, haz clic en Habilitar.

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

En la siguiente referencia, se describe la configuración disponible en la App Página Configuración del SDK de Google Workspace 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 un organización de Google Workspace, ya sea que la ficha de tu app no esté listada visibles para todos los usuarios de tu organización o cualquier persona que utilice en Google Workspace.
  • Configuración de instalación: Indica si la app solo puede que los administradores de Google Workspace instalen.

Independientemente de la configuración que especifiques en la ficha de la aplicación, los usuarios que pertenezcan a es posible que una organización de Google Workspace no pueda descubrir, instalar o usar tu app según la configuración establecida por sus administradores. Administradores puede afectar la disponibilidad de tu app de las siguientes maneras:

  • Controla si los usuarios pueden ver las apps en la Marketplace e instalar apps en nombre de su 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 a un administrador sobre cómo agregar la app a la lista de apps permitidas.
  • Desactivar ciertas aplicaciones de Google Workspace, como quitar acceso a Google Chat, a las apps de Google Chat o a ambas. En estos casos, los usuarios no podrán instalar tu app desde la Marketplace.

Para obtener información sobre cómo los administradores gestionan el acceso a Marketplace, consulta las 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 laboral o institución educativa). Si estás con una cuenta personal (una cuenta que termine en "@gmail.com"), solo podrás públicamente.

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

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

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

Configuración de instalación de apps

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

  • Instalación individual + instalación de administrador (predeterminada): la aplicación puede ser instalada por usuarios individuales o por los administradores de su dominio, unidad organizativa o un grupo de usuarios. Las políticas de dominio de un usuario podrían impedir que lo instale una aplicación, incluso si están habilitadas las instalaciones individuales.
  • Instalación solo para administradores: Solo los administradores pueden instalar la aplicación para sus dominio, unidad organizativa o un grupo de usuarios. Tu app solo aparece en Resultados de la búsqueda de Google Workspace Marketplace para administradores y personas que no hayan accedido 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 las apps para instalación y visibilidad:

Usuarios previstos de la aplicación Parámetro de configuración de Visibilidad de la app Parámetro de configuración de Instalación de apps ¿Quiénes pueden instalar mi app? ¿Quiénes pueden usar mi app?
Apps diseñadas para organizaciones con Google Workspace  
Usuarios específicos de tu organización Privado y no listado 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 lo permites, cualquier miembro 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 lo permites, cualquier miembro de tu organización. Si lo permites, cualquier miembro de tu organización.
Tu organización Privado Solo para administradores Administradores Usuarios que tienen la app instalada por su administrador.
Apps disponibles para usuarios ajenos a 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 y de administrador
  • Cualquier persona que use aplicaciones de Google Workspace para uso personal.
  • Si se permite, los usuarios de las organizaciones de Google Workspace.
  • Cualquier persona que use aplicaciones de Google Workspace para uso personal.
  • Si se permite, los usuarios de las organizaciones de Google Workspace.

Identificar cómo tu app se integra en las aplicaciones de Google Workspace

Elige los servicios de Google Workspace para los que se diseñaron tu app o complemento trabajarás, 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 Enumera las integraciones de apps en conjunto.

Según las integraciones de apps que elijas, es posible que debas proporcionar información y habilitar las APIs relevantes en tu proyecto de Google Cloud. Lo siguiente se describe la configuración adicional necesaria para cada uno de los siguientes:

Complemento de Google Workspace (Apps Script)

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

  1. Abre el complemento de Google Workspace en Apps Script Editor.
  2. Haz clic en Implementar > Administra las implementaciones.
  3. Debajo del ID de implementación, haz clic en Copiar (Copy).

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

Si creaste tu complemento de Google Workspace en un lenguaje de programación distinto del 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 apps, en “Complemento de Google Workspace”, haz clic en Implementar con el recurso de implementación en la nube > Selecciona Deployment.
  2. Selecciona la implementación que deseas publicar.
  3. Haz clic en Seleccionar.

complemento de Editor (Documentos, Hojas de cálculo, Presentaciones, 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 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 > Administra las 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 apps.

App de Drive

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

App web

Para publicar una aplicación web, debes proporcionar su URL de navegación universal, la URL que dirige a la aplicación web desde el menú de aplicaciones 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. un tamaño de 96 x 96 y 48 x 48 píxeles.

Si creó su aplicación web en Apps Script, para obtener la configuración URL de navegación, sigue estos pasos:

  1. Abre el complemento de Google Workspace en Apps Script Editor.
  2. Haz clic en Implementar > Implementación nueva.
  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 Alcances de OAuth, proporciona una lista completa de los alcances de OAuth de tu app. la infraestructura y los procesos que requiere la administración de datos. Los permisos de OAuth que ingreses aquí deben coincidir con los que muestres en tu Pantalla de consentimiento de OAuth y, si corresponde, manifiesto de Apps Script.

Si incluyes más de una integración de aplicación, asegúrate de agregar los alcances de a cada uno a la página de configuración de apps del SDK de Google Workspace Marketplace y tu consentimiento en la pantalla.

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

Para obtener información sobre proyectos de Apps Script, consulta Alcances para obtener más informació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 el bucket de tu app ficha de Play Store.

Campos
Estado del comerciante

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

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

Si no se especifica, indica “Estado del comerciante no especificado” aparece en la API de tu app ficha de Play Store .

Dirección de correo postal del desarrollador

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

La ubicación de tu empresa. Ingresa una dirección de correo postal válida donde y las personas a las que se puede contactar.

Nombre del desarrollador El nombre que se mostrará como autor de la app. Si eres comerciante, Su nombre comercial o legal.
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. Es no se incluye en la ficha de la aplicación. Asegúrate de que esta dirección de correo electrónico esté actualizada date, sino que se utiliza:

  • Si Google necesita comunicarse con el desarrollador, por ejemplo, durante la de revisión de la app.
  • Para enviar comentarios desde los complementos de Editor si la URL del informe de problemas no está configurada que se proporciona en la página de la ficha de Play Store.
URL del sitio web de la aplicación Opcional. El sitio web que describe mejor tu aplicación.

Guarda los parámetros de configuración de tu app en el SDK de Google Workspace Marketplace

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

  1. Abre el SDK de Google Workspace Marketplace.
  2. Ve a la pestaña Configuración de la app.
  3. Completa cada sección según lo que hayas determinado en la sección anterior.
  4. Haz clic en Guardar.
  5. Puedes obtener estadísticas sobre el uso de la app (opcional). en Google Analytics. Para ello, agrega un ID de Google Analytics. en el SDK de Google Workspace Marketplace.
    1. Ve a la pestaña Analytics.
    2. Ingresa tu ID de Google Analytics.
    3. Haz clic en Guardar.