Activer le SDK Google Workspace Marketplace et l'API des modules complémentaires Google Workspace
Le SDK Google Workspace Marketplace et l'API Google Workspace Add-ons sont nécessaires pour développer des modules complémentaires Meet. Pour les activer, procédez comme suit :
En haut de l'écran, si un autre projet est déjà ouvert, sélectionnez le nom du projet de votre application pour changer de projet.
Cliquez sur API et services.
Sélectionnez Google Workspace Marketplace SDK pour afficher la page d'informations.
Créer votre déploiement
Vous pouvez créer votre déploiement directement dans la console Google Cloud en créant un déploiement HTTP (recommandé) ou en utilisant Google Apps Script.
Déploiement HTTP
Cliquez sur l'onglet Déploiements HTTP.
Cliquez sur Créer un déploiement et saisissez l'ID de déploiement du module complémentaire.
L'ID de déploiement est une chaîne arbitraire qui aide le développeur de modules complémentaires à identifier le déploiement contenant le fichier manifeste du module complémentaire. Les ID de déploiements sont obligatoires et peuvent comporter jusqu'à 100 caractères.
Cliquez sur Suivant.
Un panneau latéral s'ouvre pour vous permettre d'envoyer la spécification du fichier manifeste du module complémentaire au format JSON. Il est également appelé DEPLOYMENT.JSON.
Le fichier manifeste du module complémentaire est la configuration centrale d'un module complémentaire Google Meet. L'exemple de code suivant montre les champs Meet disponibles pour le Web dans le fichier manifeste du module complémentaire.
NAME : chaîne. Nom de votre module complémentaire Google Meet.
LOGO_URL : chaîne. URL du logo du module complémentaire Google Workspace. Il est utilisé pour le module complémentaire dans les produits Google Workspace.
SIDE_PANEL_URI : chaîne. URL du point d'entrée de votre application de module complémentaire. Elle s'affiche dans un iFrame du panneau latéral. L'origine de cette URL doit faire partie des origines spécifiées dans le champ ADD_ON_ORIGINS.
ADD_ON_ORIGINS : liste de chaînes. Liste des origines où votre module complémentaire est hébergé. Deux URL ont la même origine lorsqu'elles partagent le même schéma, le même hôte et le même port. Les sous-origines et les sous-domaines avec caractères génériques sont également autorisés. Pour en savoir plus, consultez Sécurité des modules complémentaires.
DARK_MODE_LOGO_URL : chaîne. URL spécifique au mode sombre du logo du module complémentaire. Fournir un logo pour le mode sombre permet de s'assurer que votre module complémentaire s'affichera de manière optimale dans n'importe quel thème Meet. Pour connaître les consignes de conception des logos, consultez Bonnes pratiques.
MEET_WEB_LOGO_URL : facultatif. Chaîne. URL spécifique à Meet du logo du module complémentaire. Ce logo est utilisé dans Meet. Si elle n'est pas présente, la valeur logoUrl de la section commune est utilisée. Pour connaître les consignes de conception des logos, consultez les Bonnes pratiques.
SUPPORTS_SCREENSHARING : facultatif. Valeur booléenne. Si la valeur est définie sur "false", les utilisateurs doivent utiliser le module complémentaire pour voir ce qui se passe dans une session de module complémentaire collaboratif. Si la valeur est "true", l'initiateur de la session de module complémentaire collaboratif peut partager son écran pour afficher sa vue du module complémentaire.
Dans l'onglet Configuration de l'application, sous Intégration de l'application, sélectionnez Module complémentaire Google Workspace. Sélectionnez Déployer à l'aide d'une ressource de déploiement cloud, puis choisissez le déploiement HTTP approprié.
Google Apps Script
Cliquez sur l'onglet Configuration de l'application.
Sous Intégration d'applications, sélectionnez Module complémentaire Google Workspace. Sélectionnez Déployer à l'aide de l'ID de déploiement Google Apps Script, puis saisissez l'ID de déploiement de votre script.
Cliquez sur Enregistrer.
Pour savoir comment créer un projet Apps Script, consultez la documentation Apps Script. Le module complémentaire Meet repose uniquement sur le fichier manifeste appsscript.json, également appelé manifeste du projet Apps Script. Assurez-vous que le fichier manifeste de votre projet Apps Script contient une section addOns et une section meet. Les sections addOns et meet suivent la même structure que celle décrite dans l'onglet de déploiement HTTP.
Contrairement aux autres modules complémentaires Google Workspace, les modules complémentaires Meet ne peuvent pas être entièrement créés dans Apps Script. Vous devez plutôt créer une application Web complète en créant un panneau latéral et une zone de contenu principal. L'URL du panneau latéral de votre application Web doit ensuite être spécifiée sous le SIDE_PANEL_URI du fichier manifeste appsscript.json.
Installer et tester le module complémentaire dans Meet
Pour tester votre module complémentaire dans Meet, vous devez d'abord l'installer pour l'utilisateur connecté :
Vous devriez maintenant pouvoir utiliser votre module complémentaire dans une réunion. Pour l'essayer, démarrez une réunion sur meet.google.com. Le module complémentaire installé est désormais visible dans le panneau "Activités".
En plus d'installer votre module complémentaire pour l'utilisateur connecté, vous pouvez également le publier. Lorsque vous publiez votre module complémentaire Google Workspace, vous permettez à d'autres utilisateurs de le trouver, de l'installer et de l'utiliser.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/01 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/01 (UTC)."],[],[],null,["Google Meet add-ons are created and configured as part of a Google Cloud project.\n| **Note:** Before following this deployment guide, you first must [create a web app](/workspace/meet/add-ons/guides/quickstart) that uses the Meet add-ons SDK, and then deploy that web app to a website that you own.\n\nCreate a Google Cloud project\n\nTo generate a Google Cloud project, see [Create a Google Cloud\nproject](/workspace/guides/create-project).\n\nEnable the Google Workspace Marketplace SDK and Google Workspace add-ons API\n\nThe Google Workspace Marketplace SDK and Google Workspace add-ons API are required to develop\nMeet add-ons. To enable them:\n\n1. Open the [Google Cloud\n console](https://console.cloud.google.com/).\n2. At the top, if a different project is already open, select the project name of your app's project to switch projects.\n3. At the top, in the search bar, type `Google Workspace Marketplace SDK` and press enter.\n4. Open the `Google Workspace Marketplace SDK` page, click **Enable**.\n\n | **Warning:** Make sure you enable the `Google Workspace Marketplace SDK`, not the API. The `Google Workspace Marketplace API` is a different tool used to integrate with Google's licensing and billing services.\n5. Repeat these steps to find and enable the `Google Workspace add-ons API`.\n\nCreate a deployment\n\nTo use an add-on in Meet, you need a\ndeployment and an [add-on manifest\nfile](/apps-script/add-ons/concepts/workspace-manifests).\n\nNavigate to the Google Workspace Marketplace SDK for your project in Google Cloud console\n\n1. Open the [Google Cloud\n console](https://console.cloud.google.com/).\n2. At the top, if a different project is already open, select the project name of your app's project to switch projects.\n3. Click **APIs \\& Services**.\n4. Select `Google Workspace Marketplace SDK` to view the details page.\n\nCreate your deployment\n\nYou can create your deployment directly in Google Cloud console by creating an\nHTTP deployment (recommended), or by using\nGoogle Apps Script. \n\nHTTP deployment\n\n1. Click the **HTTP deployments** tab.\n2. Click **Create new deployment** and enter the\n add-on's deployment ID.\n\n The deployment ID is an arbitrary string that helps the\n add-on developer identify the deployment\n containing the add-on manifest. Deployment\n IDs are required and can have at most 100 characters.\n3. Click **Next**.\n\n A side panel opens for you to submit the specification of the\n add-on manifest in JSON format. This is also\n called DEPLOYMENT.JSON.\n\n The [add-on manifest\n file](/apps-script/add-ons/concepts/workspace-manifests) is the\n central configuration for a Google Meet add-on. The\n following code sample shows the available Meet fields\n for web in the add-on manifest file. \n\n {\n \"addOns\": {\n \"common\": {\n \"name\": \"\u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e\",\n \"logoUrl\": \"\u003cvar translate=\"no\"\u003eLOGO_URL\u003c/var\u003e\"\n },\n \"meet\": {\n \"web\": {\n \"sidePanelUri\": \"\u003cvar translate=\"no\"\u003eSIDE_PANEL_URI\u003c/var\u003e\",\n \"addOnOrigins\": [\"\u003cvar translate=\"no\"\u003eADD_ON_ORIGINS\u003c/var\u003e\"],\n \"darkModeLogoUrl\": \"\u003cvar translate=\"no\"\u003eDARK_MODE_LOGO_URL\u003c/var\u003e\",\n \"logoUrl\": \"\u003cvar translate=\"no\"\u003eMEET_WEB_LOGO_URL\u003c/var\u003e\",\n \"supportsScreenSharing\": \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-err\"\u003eSUPPORTS_SCREENSHARING\u003c/span\u003e\u003c/var\u003e\n }\n }\n }\n }\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eNAME\u003c/var\u003e: String. The name of your Google Meet add-on.\n - \u003cvar translate=\"no\"\u003eLOGO_URL\u003c/var\u003e: String. The URL of the logo for the Google Workspace add-on. This is used for the add-on across Google Workspace products.\n - \u003cvar translate=\"no\"\u003eSIDE_PANEL_URI\u003c/var\u003e: String. The URL to the entry point of your add-on app. This is displayed in an iframe within the [side panel](/workspace/meet/add-ons/guides/overview#side-panel). The [origin](/workspace/meet/add-ons/guides/overview#origin) of this URL must be part of the origins specified in the \u003cvar translate=\"no\"\u003eADD_ON_ORIGINS\u003c/var\u003e field.\n - \u003cvar translate=\"no\"\u003eADD_ON_ORIGINS\u003c/var\u003e: List of strings. A list of [origins](/workspace/meet/add-ons/guides/overview#origin) where your add-on is hosted. Two URLs have the same origin when they share the same scheme, host, and port. Sub origins are also permitted, as are wildcard subdomains. For more information, see [Add-on security](/workspace/meet/add-ons/guides/add-on-security).\n - \u003cvar translate=\"no\"\u003eDARK_MODE_LOGO_URL\u003c/var\u003e: String. A dark mode specific URL of the logo for the add-on. Supplying a dark mode logo makes sure your add-on will look best in any Meet theme. For logo design guidelines, see [Best practices](/workspace/meet/add-ons/guides/best-practices#logo-design).\n - \u003cvar translate=\"no\"\u003eMEET_WEB_LOGO_URL\u003c/var\u003e: Optional. String. A Meet-specific URL of the logo for the add-on. This logo is used throughout Meet. If not present, the `logoUrl` from the common section is used. For logo design guidelines see [Best practices](/workspace/meet/add-ons/guides/best-practices#logo-design).\n - \u003cvar translate=\"no\"\u003eSUPPORTS_SCREENSHARING\u003c/var\u003e: Optional. Boolean. If set to false, users must use the add-on to see what's happening in a collaborative add-on session. If set to true, the initiator of the collaborative add-on session can screen share their view of the add-on.\n4. Click **Submit**.\n\n For more information on deployments, see [Create a\n deployment resource](/workspace/add-ons/guides/alternate-runtimes#create_a_deployment_resource).\n5. In the **App configuration** tab, under **App integration** , select\n **Google Workspace add-on** . Select\n **Deploy using cloud deployment resource** and then choose the correct\n HTTP deployment.\n\nGoogle Apps Script\n\n1. Click the **App configuration** tab.\n\n2. Under **App integration** , select **Google Workspace add-on** .\n Select **Deploy using Google Apps Script\n deployment ID** and enter your script's deployment ID.\n\n3. Click **Save**.\n\n For details on how to create an Apps Script project, see\n [Apps Script documentation](/apps-script/overview). The\n Meet add-on relies solely on the\n appsscript.json manifest file, also called the\n [Apps Script project manifest](/apps-script/concepts/manifests). Make sure the manifest\n file in your Apps Script project contains an `addOns`\n and a `meet` section. The `addOns` and `meet` sections follow the same\n structure as described in the HTTP deployment tab.\n\n Unlike other Google Workspace add-ons, Meet add-ons\n cannot be built entirely in Apps Script. You must,\n instead, build a full web app by\n [creating a side panel and main stage](/workspace/meet/add-ons/guides/quickstart).\n The side panel URL of your web app then must be specified under the\n \u003cvar translate=\"no\"\u003eSIDE_PANEL_URI\u003c/var\u003e of the appsscript.json manifest file.\n\nInstall and test the add-on in Meet\n\nTo test your add-on in Meet, you must\nfirst install it for the signed-in user: \n\nHTTP deployment\n\n1. [Navigate to the Google Workspace Marketplace SDK for your project in Google Cloud console](#navigate-to-marketplace_sdk).\n2. Click the **HTTP deployments** tab.\n3. Click **Install** under the **Actions** column.\n\nGoogle Apps Script\n\n1. Follow the Google Workspace add-on documentation to [Install an unpublished add-on](/workspace/add-ons/how-tos/testing-workspace-addons#install_an_unpublished).\n\nYou should now be able to use your add-on in a meeting.\nTo try it, start a meeting at [meet.google.com](https://meet.google.com). The\ninstalled add-on is now visible in the Activities\npanel.\n\nIn addition to installing your add-on for the\nindividual signed-in user, you can also [publish it](/workspace/meet/add-ons/guides/publish).\nWhen you publish your Google Workspace add-on, you make it available for\nothers to find, install, and use."]]