Configurer votre application dans le SDK Google Workspace Marketplace

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

Pour pouvoir utiliser votre application, 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 sur Google Workspace Marketplace. Vous utilisez le SDK Google Workspace Marketplace pour gérer Paramètres de la place de marché, tels que les suivants:

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

Que vous publiiez ou non votre application en mode public ou privé, vous devez utiliser le SDK Google Workspace Marketplace pour gérer sur Marketplace.

Activer le SDK Google Workspace Marketplace

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

  1. Ouvrez Google Cloud Console.
  2. En haut de la page, cliquez sur Sélectionner un projet. Si un autre projet Google Cloud déjà ouvert, cliquez sur le nom du projet Cloud des projets Google Cloud.
  3. Sélectionnez le projet Cloud de votre application et cliquez sur Ouvrir.
  4. Dans la barre de recherche située en haut, 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.

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

Le document de référence suivant décrit les paramètres disponibles dans l'application page "Configuration" du SDK Google Workspace 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 un d'une organisation Google Workspace, que la fiche de votre appli ne soit pas répertoriée, visible par tous les utilisateurs de votre organisation ou par toute personne utilisant Google Workspace.
  • Paramètres d'installation: indique si l'application ne peut être installé par les administrateurs Google Workspace.

Quels que soient les paramètres spécifiés dans la fiche de votre application, les utilisateurs appartenant à une organisation Google Workspace pourrait ne pas être en mesure de détecter, d'installer ou utiliser votre application en fonction des paramètres définis par leurs administrateurs. Administrateurs peut affecter la disponibilité de votre application de différentes manières:

  • contrôler si leurs utilisateurs peuvent afficher les applications dans les Marketplace et installent des applications utilisateurs.
  • utiliser une liste d'autorisation pour gérer et organiser les applications de son organisation ; Si vous développez une application pour une organisation qui utilise des listes d'autorisation, consultez un administrateur sur l'ajout de l'application à la liste d'autorisation.
  • désactiver certaines applications Google Workspace, comme la suppression l'accès à Google Chat, aux applications Google Chat ou aux deux. Dans ces cas, les utilisateurs ne pourront pas installer votre appli Place de marché.

Pour savoir comment les administrateurs gèrent l'accès aux sur la place de marché, consultez le Documentation d'aide pour les administrateurs Marketplace

Paramètres de visibilité des applications

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 à l'aide d'un compte personnel (un compte se terminant par "@gmail.com"), vous ne pouvez et le rendre public.

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

Si vous choisissez de publier l'application en tant que Non répertoriée, la fiche de l'application n'apparaît pas dans la section de navigation ou des résultats de recherche. Les utilisateurs ne peuvent accéder à la page commerciale de l'application URL.

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

Paramètres d'installation des applications

Les paramètres d'installation déterminent si les utilisateurs ou les administrateurs Workspace peuvent installer votre application depuis la fiche Play Store de votre application. 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 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: seuls les administrateurs peuvent installer l'application pour un domaine, une unité organisationnelle ou un groupe d'utilisateurs. Votre application n'apparaît que dans Résultats de recherche Google Workspace Marketplace pour les administrateurs et les utilisateurs qui ne sont pas connectés à leur compte Google. Choisissez cette option si votre application nécessite l'installation du domaine.

Paramètres d'installation et de visibilité courants

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

Utilisateurs de l'application prévus Paramètre Visibilité des applications Paramètre Installation d'applications Qui peut installer mon application ? Qui peut utiliser mon application ?
Pour les applications conçues pour une organisation Google Workspace  
Utilisateurs spécifiques de votre organisation Privée et Non répertoriée Installation individuelle + administrateur Toute personne de votre organisation qui dispose de l'URL sur la fiche de l'application, le cas échéant. 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 Toute personne de votre organisation, si cela y est autorisé. Toute personne de votre organisation, si cela y est autorisé.
Votre entreprise Privé Administrateur uniquement Administrateurs Utilisateurs qui ont installé l'application 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 Google Workspace Publique Installation individuelle + administrateur
  • Toute personne qui utilise les applications Google Workspace à des fins personnelles.
  • S'ils y sont autorisés, 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 la manière dont votre application s'intègre aux applications Google Workspace

Choisir les services Google Workspace pour lesquels votre application ou module complémentaire est conçu tel qu'un module complémentaire Google Workspace ou Application Google Chat. Vous devez sélectionner au moins une option. Dans certains cas, vous pouvez inclure plusieurs intégrations d'applications dans la fiche de votre application. Voir Répertorier les intégrations d'applications ensemble

Selon les intégrations d'applications que vous choisissez, vous devrez peut-être fournir plus et activer les API pertinentes dans votre projet Google Cloud. Les éléments suivants : décrit dans le tableau ci-dessous la configuration supplémentaire requise pour chacun d'eux:

Module complémentaire Google Workspace (Apps Script)

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

  1. Ouvrir votre module complémentaire Google Workspace dans Apps Script éditeur.
  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 (déploiements HTTP)

Si vous avez créé votre module complémentaire Google Workspace à l'aide de points de terminaison HTTP, procédez comme suit pour obtenir l'ID de déploiement à partir du ressource de déploiement Google Cloud.

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

de l'éditeur (Docs, Sheets, Slides, Forms)

Pour publier un module complémentaire d'éditeur, vous devez indiquer L'ID de 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 connaître la version, 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 figure sous "Configuration".

Application Google Chat

Pour publier une application Google Chat, vous devez configurer l'API Google Chat. Voir Publication applications.

Application Drive

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

Application Web

Pour publier une application Web, vous devez indiquer son URL de navigation universelle, à savoir l'URL que 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 page de la fiche Play Store, vous devez fournir des icônes supplémentaires dont la taille est de 96 x 96 et 48 x 48 pixels.

Si vous avez créé votre application Web dans Apps Script, vous pouvez obtenir nav, procédez comme suit:

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

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 de votre application. requiert. Les habilitations OAuth que vous saisissez ici doivent correspondre à celles affichées dans votre Écran de consentement OAuth et, le cas échéant, fichier manifeste Apps Script

Si vous incluez plusieurs intégrations d'applications, veillez à ajouter les champs d'application à la page de configuration de l'application du SDK Google Workspace Marketplace et votre autorisation OAuth l'écran.

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

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

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

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

Champs
Statut de négociant

Conformément à la législation sur la protection des consommateurs, les consommateurs résidant en Europe L'Espace économique (EEE) doit être informé si un marchand situé sur le Google Workspace Marketplace est un professionnel non-professionnel:

  • Négociateur : un professionnel est une personne qui agit pour des raisons liées à un commerce, une entreprise, un métier ou une profession ; ou au nom de ou sur pour le compte d'un professionnel.
  • Non-professionnel : un non-professionnel (consommateur) est une personne qui agit pour le compte à des fins non professionnelles.

Si aucune valeur n'est spécifiée, "État du négociateur non spécifié" apparaît sur l'interface utilisateur fiche Play Store .

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 .

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

Adresse e-mail à utiliser comme contact. Il est ne sont pas incluses dans la fiche de votre application. Assurez-vous que cette adresse e-mail reste à jour date – il est utilisé:

  • Si Google doit contacter le développeur, par exemple, pendant la le processus d'examen des applications.
  • Pour envoyer des commentaires à partir des modules complémentaires de l'éditeur si l'URL "Signaler un problème" n'est pas sur la page de la 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 Google Workspace Marketplace

En vous basant sur les informations de la section précédente, enregistrez la configuration de votre application dans le SDK Google Workspace Marketplace:

  1. Ouvrez le SDK Google Workspace Marketplace.
  2. Accédez à l'onglet Configuration de l'application.
  3. Remplissez chaque section en fonction de ce que vous avez déterminé dans section précédente.
  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. du SDK Google Workspace Marketplace.
    1. Accédez à l'onglet Analytics.
    2. Saisissez votre ID Google Analytics.
    3. Cliquez sur Enregistrer.