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 rendre votre application disponible, vous devez la configurer dans le SDK Marketplace. Le SDK Marketplace est un kit d'outils qui vous permet de créer et de contrôler votre application sur Google Workspace Marketplace. Vous utilisez le SDK Marketplace pour gérer les paramètres de Marketplace, par exemple:

• Indique si votre application est disponible pour une organisation Google Workspace spécifique (application privée) ou pour tous les utilisateurs de Marketplace (application publique)
• Types d'utilisateurs 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 la personne qui a créé et gère l'application

Que vous publiiez votre application de manière privée ou publique, vous devez utiliser le SDK Marketplace pour la gérer sur Marketplace.

Activer le SDK Marketplace

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

Ouvrir votre projet Cloud dans la console Google Cloud

Si ce n'est pas déjà fait, ouvrez le projet Cloud que vous prévoyez d'utiliser pour cet exemple:

1. Dans la console Google Cloud, accédez à la page Sélectionner un projet.

   Sélectionner un projet Cloud

2. Sélectionnez le projet Google Cloud que vous souhaitez utiliser. Vous pouvez également cliquer sur Créer un projet et suivre les instructions à l'écran. Si vous créez un projet Google Cloud, vous devrez peut-être activer la facturation pour ce projet.

Activer le SDK Google Workspace Marketplace

Avant d'utiliser les API Google, vous devez les activer dans un projet Google Cloud. Vous pouvez activer une ou plusieurs API dans un même projet Google Cloud.

• Dans la console Google Cloud, activez le SDK Google Workspace Marketplace.

  Activer le SDK

Déterminer les paramètres de configuration de votre application

La référence suivante décrit les paramètres disponibles sur la page App Configuration (Configuration de l'application) du SDK Marketplace.

Choisir qui peut voir et installer votre application

Lorsque vous configurez votre application, vous spécifiez les utilisateurs qui peuvent y accéder à l'aide des paramètres suivants:

• Visibilité de l'application: si vous publiez une application dans une organisation Google Workspace, indiquez si votre fiche d'application est non listée, visible par tous les utilisateurs de votre organisation ou par tous ceux qui utilisent Google Workspace.
• Paramètres d'installation: indique si l'application ne peut être installée que par les administrateurs Google Workspace.

Quels que soient les paramètres que vous spécifiez dans la fiche de votre application, les utilisateurs appartenant à une organisation Google Workspace peuvent ne pas pouvoir découvrir, installer ni utiliser votre application en fonction des paramètres définis par leurs administrateurs. Les administrateurs peuvent avoir un impact sur la disponibilité de votre application de différentes manières:

• contrôler si leurs utilisateurs peuvent afficher les applications dans Marketplace et installer des applications pour leur compte ;
• utiliser une liste d'autorisation pour gérer et sélectionner les applications de leur organisation ; Si vous développez une application pour une organisation qui utilise des listes d'autorisation, demandez à un administrateur d'ajouter l'application à la liste d'autorisation.
• Désactiver certaines applications Google Workspace, par exemple en supprimant l'accès à Google Chat, aux applications Google Chat ou aux deux. Dans ce cas, les utilisateurs ne pourront pas installer votre application à partir de Marketplace.

Pour savoir comment les administrateurs gèrent l'accès à Marketplace, consultez la documentation d'aide pour les administrateurs Marketplace.

Paramètres de visibilité de l'application

L'option Visibilité des applications s'affiche si vous utilisez un compte Google Workspace (un compte créé par votre organisation professionnelle ou scolaire). Si vous utilisez un compte personnel (un compte se terminant par "@gmail.com"), vous ne pouvez publier que des contenus publics.

• Public: les personnes extérieures à votre domaine peuvent trouver et installer l'application. Si vous choisissez la visibilité publique, Google examine et approuve votre fiche d'application avant sa publication.
• Privé: seuls les membres de 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 n'apparaît pas dans les résultats de navigation ni de recherche. Les utilisateurs ne peuvent accéder à la page de la plate-forme de téléchargement de l'application qu'avec l'URL directe.

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

Paramètres d'installation des applications

L'option Installation Settings (Paramètres d'installation) détermine si les utilisateurs ou les administrateurs Google 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 des administrateurs pour leur domaine, leur unité organisationnelle ou 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 par un administrateur uniquement: l'application ne peut être installée que par les administrateurs pour leur domaine, leur unité organisationnelle ou un groupe d'utilisateurs. Votre application n'apparaît dans les résultats de recherche Google Workspace Marketplace que pour les administrateurs et les utilisateurs qui ne sont pas connectés à leur compte Google. Choisissez cette option si votre application nécessite une installation de domaine.

Paramètres d'installation et de visibilité courants

Le tableau suivant récapitule certaines des options de configuration d'application courantes pour l'installation et la visibilité:

Utilisateurs cibles de l'application	Paramètre Visibilité des applications	Paramètre Installation d'applications	Qui peut installer mon application ?	Qui peut utiliser mon application ?
Pour les applications créées pour une organisation Google Workspace
Utilisateurs spécifiques de votre organisation	Privé et Non répertoriée	Installation individuelle + administrateur	Si vous l'autorisez, tous les membres de votre organisation disposant de l'URL de la fiche de l'application.	Toute personne de votre organisation qui dispose de l'URL sur la fiche de l'application, le cas échéant.
Votre entreprise	Privé	Installation individuelle + administrateur	Si autorisé, tous les membres de votre organisation.	Si autorisé, tous les membres de votre organisation.
Votre entreprise	Privé	Administrateur uniquement	Administrateurs	Utilisateurs dont l'application a été installée par leur administrateur.
Pour les applications disponibles pour les utilisateurs en dehors d'une organisation Google Workspace spécifique
Utilisateurs des organisations Google Workspace	Publique	Administrateur uniquement	Administrateurs	Utilisateurs qui ont installé l'application par leur administrateur.
Tous les utilisateurs de Google Workspace	Publique	Installation individuelle + administrateur	Toute personne qui utilise les applications Google Workspace pour un usage personnel Si autorisé, les utilisateurs des organisations Google Workspace	Toute personne qui utilise les applications Google Workspace à des fins personnelles Si autorisé, les utilisateurs des organisations Google Workspace

Identifier comment votre application s'intègre aux applications Google Workspace

Choisissez les services Google Workspace avec lesquels votre application ou votre module complémentaire doit fonctionner, par exemple 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'applications dans la fiche de votre application. Consultez Lister les intégrations d'applications.

En fonction des intégrations d'applications 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 la configuration supplémentaire requise pour chacun d'eux:

Spécifier le niveau d'accès requis par votre application

Sous Champs d'application OAuth, fournissez la liste complète des champs d'application OAuth 2.0 requis par votre application. Les niveaux d'accès OAuth que vous saisissez ici doivent correspondre à ceux 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, assurez-vous d'ajouter les champs d'application de chacune d'elles à la page de configuration de l'application du SDK Marketplace et à votre écran de consentement OAuth.

Utilisez toujours les champs d'application les plus restreints 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 en savoir plus sur les projets Apps Script, consultez la section Champs d'application de l'autorisation.

Fournir des informations sur le développeur de l'application

Sous Informations sur le développeur, indiquez vos coordonnées et d'autres informations. Ces champs apparaissent sur la page de la fiche Play Store de votre application.

Champs
État du commerçant	Conformément à la législation sur la protection des consommateurs, les consommateurs basés dans l'Espace économique européen (EEE) doivent être informés si un marchand de la place de marché Google Workspace est un commerçant ou un non-commerçant: Commercial: un professionnel est une personne qui agit dans le cadre d'un commerce, d'une entreprise, d'un métier ou d'une profession, ou au nom d'un professionnel ou au nom de celui-ci. Non-commerçant: un non-commerçant (consommateur) est une personne qui agit à des fins non professionnelles. Si ce champ n'est pas renseigné, la mention "Statut de professionnel non spécifié" s'affiche sur la fiche Play Store de votre application.
Nom du développeur	Nom à afficher en tant qu'auteur de l'application. Si vous êtes un marchand, indiquez votre raison sociale ou votre nom légal.
Adresse postale du développeur	Obligatoire pour les traders. Non collectées pour les non-professionnels. L'adresse de votre entreprise Saisissez une adresse postale valide à laquelle vous pouvez être contacté.
URL du site Web du développeur	Site Web qui vous décrit (ou votre organisation) comme le développeur.
Adresse e-mail du développeur	Adresse e-mail à utiliser comme point de contact. Elle n'est pas incluse dans la fiche de votre application. Assurez-vous que cette adresse e-mail est à jour, car elle est utilisée: Si Google doit contacter le développeur (par exemple, lors du processus d'examen de l'application). Pour envoyer des commentaires à partir des modules complémentaires pour les éditeurs si aucune URL de signalement de problème n'est fournie sur la page de fiche Play Store.
URL du site Web de l'application	Facultatif. Site Web qui décrit plus en détail votre application.

Enregistrer les paramètres de configuration de votre application dans le SDK Marketplace

À l'aide des informations de la section précédente, enregistrez la configuration de votre application dans le SDK Marketplace:

1. Dans la console Google Cloud, accédez à la page Configuration du SDK Marketplace:

   Accéder à la page de configuration du SDK Marketplace

2. Remplissez chaque section en fonction de ce que vous avez déterminé dans la section précédente.

3. Cliquez sur Enregistrer.

4. (Facultatif) Vous pouvez obtenir des données analytiques sur l'utilisation de l'application dans Google Analytics. Pour ce faire, ajoutez un ID Google Analytics dans le SDK de la place de marché.

   1. Accédez à l'onglet Analytics.
   2. Saisissez votre ID Google Analytics.
   3. Cliquez sur Enregistrer.