Configurer votre application dans le SDK Google Workspace Marketplace

Cette page explique comment utiliser le SDK Google Workspace Marketplace pour configurer et gérer votre application sur Google Workspace Marketplace.

Pour que votre application puisse être utilisée, vous devez la configurer dans le SDK Google Workspace Marketplace. Le SDK Google Workspace Marketplace est un kit d'outils qui vous permet de créer et de contrôler votre application sur Google Workspace Marketplace. Le SDK Google Workspace Marketplace permet de gérer les paramètres de Marketplace, tels que les suivants:

  • La disponibilité de votre application pour une organisation Google Workspace spécifique (application privée) ou pour tous les utilisateurs de Marketplace (application publique)
  • Types d'utilisateurs de Marketplace pouvant installer votre application
  • les applications Google Workspace auxquelles votre application s'intègre ;
  • Champs d'application OAuth requis par votre application
  • Informations sur le créateur et la maintenance de l'application

Que vous publiiez votre application de façon publique ou privée, vous devez utiliser le SDK Google Workspace Marketplace pour gérer votre application sur Marketplace.

Activer le SDK Google Workspace Marketplace

Si vous ne l'avez pas déjà fait, activez le SDK Google Workspace Marketplace dans votre projet Google Cloud:

  1. Ouvrez Google Cloud Console.
  2. En haut de la page, cliquez sur Sélectionner un projet. Si un autre projet Google Cloud est déjà ouvert, cliquez sur son nom pour changer de projet Cloud.
  3. Sélectionnez le projet Cloud de votre application, puis cliquez sur Open (Ouvrir).
  4. En haut, dans la barre de recherche, saisissez Google Workspace Marketplace SDK, puis appuyez sur Entrée.
  5. Ouvrez la page du SDK Google Workspace Marketplace.

  6. Si le SDK Google Workspace Marketplace n'est pas déjà activé, cliquez sur Activer.

Saisir les paramètres de l'application dans le SDK Google Workspace Marketplace

  1. Ouvrez le SDK Google Workspace Marketplace.
  2. Accédez à l'onglet App Configuration (Configuration de l'application).
  3. Remplissez chaque section avec les informations concernant votre application. Pour en savoir plus sur chaque paramètre, consultez la section Paramètres de configuration de l'application.
  4. Cliquez sur Enregistrer.
  5. (Facultatif) Vous pouvez obtenir des données analytiques sur l'utilisation des applications dans Google Analytics. Pour ce faire, ajoutez un ID Google Analytics dans le SDK Google Workspace Marketplace.
    1. Accédez à l'onglet Données d'analyse.
    2. Saisissez votre ID Google Analytics.
    3. Cliquez sur Enregistrer.

Paramètres de configuration de l'application

Le document de référence suivant décrit les paramètres disponibles sur la page Configuration de l'application du SDK Google Workspace Marketplace.

Visibilité de l'application

L'option Visibilité de l'application s'affiche si vous utilisez un compte Google Workspace (un compte créé par votre entreprise ou votre établissement scolaire). Si vous utilisez un compte personnel (c'est-à-dire un compte se terminant par "@gmail.com"), vous ne pouvez publier qu'en mode public.

  • Publique: l'application peut être trouvée et installée par des personnes externes à votre domaine. Si vous choisissez une visibilité publique, Google examine et approuve votre fiche d'application avant sa publication.
  • Privé: seules les personnes appartenant à votre domaine peuvent trouver et installer votre application.

Si vous choisissez de publier votre application en tant que Non répertoriée, la fiche de l'application ne s'affiche pas dans les résultats de navigation ni de recherche. Les utilisateurs ne peuvent accéder à la page commerciale de l'application qu'avec l'URL directe.

Si vous souhaitez limiter les pays et régions dans lesquels votre application est disponible, configurez-le dans la section Distribution lorsque vous créez la fiche Play Store.

Paramètres d'installation

Les paramètres d'installation déterminent si les utilisateurs ou les administrateurs Workspace peuvent installer votre application à partir de votre fiche Play Store sur Google Workspace Marketplace.

  • Installation individuelle + administrateur (par défaut): l'application peut être installée par des utilisateurs individuels ou par les administrateurs de leur domaine, de leur unité organisationnelle ou d'un groupe d'utilisateurs. Les règles de domaine d'un utilisateur peuvent l'empêcher d'installer une application, même si les installations individuelles sont activées.
  • Installation administrateur uniquement: l'application ne peut être installée que par les administrateurs de leur domaine, de leur unité organisationnelle ou d'un groupe d'utilisateurs. Votre application ne s'affiche dans les résultats de recherche Google Workspace Marketplace que pour les administrateurs et les personnes qui ne sont pas connectées à leur compte Google. Choisissez cette option si votre application nécessite une installation sur un domaine.

Intégration dans une appli

Choisissez les services Google Workspace compatibles avec votre application ou module complémentaire, comme un module complémentaire Google Workspace ou une application Google Chat. Vous devez choisir au moins une option. Dans certains cas, vous pouvez inclure plusieurs intégrations d'application dans la fiche de votre application. Consultez Répertorier les intégrations d'applications ensemble.

Selon les intégrations d'application que vous choisissez, vous devrez peut-être fournir plus d'informations et activer les API pertinentes dans votre projet Google Cloud. Le tableau suivant décrit les configurations supplémentaires requises pour chacun d'eux:

Module complémentaire Google Workspace (Apps Script)

Pour publier un module complémentaire Google Workspace, vous devez fournir l'ID de déploiement du module complémentaire. Pour trouver l'ID de déploiement, procédez comme suit:

  1. Ouvrez votre module complémentaire Google Workspace dans l'éditeur Apps Script.
  2. Cliquez sur Déployer> Gérer les déploiements.
  3. Sous l'ID de déploiement, cliquez sur Copier.

Module complémentaire Google Workspace (environnement d'exécution alternatif)

Si vous avez créé votre module complémentaire Google Workspace dans un langage de codage autre que Google Apps Script, procédez comme suit pour obtenir l'ID de déploiement à partir de la ressource de déploiement Google Cloud.

  1. Sur la page "Configuration de l'application", sous "Module complémentaire Google Workspace", cliquez sur Déployer à l'aide d'une ressource de déploiement cloud> Sélectionner un déploiement.
  2. Sélectionnez le déploiement que vous souhaitez publier.
  3. Cliquez sur Sélectionner.

Module complémentaire d'éditeur (Docs, Sheets, Slides, Forms)

Pour publier un module complémentaire d'éditeur, vous devez fournir l'ID du script du projet et la version que vous souhaitez publier.

Pour trouver l'ID de script du projet, procédez comme suit:

  1. Ouvrez le module complémentaire dans l'éditeur Apps Script.
  2. Sur la gauche, cliquez sur Paramètres du projet .
  3. Sous "ID", copiez l'ID de script.

Pour identifier la version que vous utilisez, procédez comme suit:

  1. Ouvrez le module complémentaire dans l'éditeur Apps Script.
  2. En haut à droite, cliquez sur Déployer> Gérer les déploiements.
  3. Le numéro de version se trouve sous "Configuration".

Application Google Chat

Pour publier une application Google Chat, vous devez configurer l'API Google Chat. Consultez la page Publier des applications.

Application Drive

Pour publier une application Drive, vous devez activer et configurer l' API Drive.

Application Web

Pour publier une application Web, vous devez fournir son URL de navigation universelle, c'est-à-dire l'URL qui pointe vers l'application Web depuis le menu des applications Google . Votre application Web doit être en production et entièrement fonctionnelle.

Lorsque vous remplissez la fiche Play Store, vous devez fournir des icônes supplémentaires de 96 x 96 et 48 x 48 pixels.

Si vous avez créé votre application Web dans Apps Script, procédez comme suit pour obtenir l'URL de navigation universelle:

  1. Ouvrez votre module complémentaire Google Workspace dans l'éditeur Apps Script.
  2. Cliquez sur Déployer > Nouveau déploiement.
  3. Sous "Sélectionner le type", cliquez sur Application Web.
  4. Indiquez les options requises, puis cliquez sur Déployer.
  5. Cliquez sur Copier.

Champs d'application OAuth

Fournissez la liste complète des champs d'application OAuth requis par votre application. Les champs d'application OAuth que vous saisissez ici doivent correspondre à ce que vous affichez sur votre écran de consentement OAuth et, le cas échéant, au fichier manifeste Apps Script.

Si vous incluez plusieurs intégrations d'applications, veillez à ajouter les champs d'application de chacune d'elles sur la page "Configuration de l'application" du SDK Google Workspace Marketplace et sur votre écran de consentement OAuth.

Utilisez toujours les champs d'application les plus étroits possible (par exemple, n'incluez pas un champ d'application Drive complet si vous n'avez besoin que d'un champ d'application en lecture seule).

Pour les projets Apps Script, consultez la section Champs d'application pour en savoir plus.

Informations concernant le développeur

Ces champs apparaissent sur la fiche Play Store de votre application.

Champs
État du marchand

Conformément à la législation sur la protection des consommateurs, les consommateurs basés dans l'Espace économique européen (EEE) doivent savoir si un marchand sur Google Workspace Marketplace est un commerçant ou un non-commerçant:

  • Trader : personne agissant à des fins liées à un commerce, une entreprise, un métier ou une profession, ou au nom d'un professionnel ou pour son compte.
  • Non-commerçant : un non-commerçant (consommateur) est une personne qui agit à des fins non professionnelles.

En l'absence de configuration, le message "État du trading non spécifié" s'affiche sur la fiche Play Store de votre application.

Adresse postale du développeur

Obligatoire pour les négociants. Non collectées pour les non-commerçants.

Adresse de votre entreprise. Saisissez une adresse postale valide à laquelle vous contacter.

Nom du développeur Nom à afficher en tant qu'auteur de l'application. Si vous êtes un professionnel, indiquez votre nom commercial ou votre nom légal.
URL du site Web pour les développeurs Site Web qui vous décrit (ou qui décrit votre organisation) en tant que développeur.
Adresse e-mail du développeur

Adresse e-mail à utiliser comme point de contact. Il n'est pas inclus sur la fiche de votre application. Assurez-vous que cette adresse e-mail est à jour. Elle est utilisée:

  • Si Google doit contacter le développeur, par exemple pendant le processus d'examen de l'application.
  • Pour envoyer des commentaires à partir des modules complémentaires de l'éditeur si aucune URL "Signaler un problème" n'est fournie sur la fiche Play Store.
URL du site Web de l'application Facultatif. Site Web qui décrit davantage votre application.