Cliquez sur le connecteur personnalisé pour lequel vous souhaitez ajouter une version.
La page des détails de la connexion s'affiche.
Cliquez sur Versions.
Vous trouverez sur cette page toutes les versions du connecteur.
Cliquez sur Créer. La page Créer une version s'affiche avec le nouveau numéro de version. La procédure de création d'une version est semblable à celle de la création d'un connecteur personnalisé.
Cela signifie que vous pouvez créer une version avec une connectivité directe ou indirecte.
Cliquez sur le connecteur personnalisé qui comporte des versions.
La page des détails de la connexion s'affiche.
Cliquez sur Versions.
Les versions du connecteur sélectionné s'affichent.
Cliquez sur more_vertActions pour sélectionner l'une des options suivantes :
Afficher les détails : permet d'afficher les détails de la version du connecteur personnalisé.
Abandonner la version : permet d'abandonner la version.
Supprimer : permet de supprimer la version.
Exporter : permet de télécharger la version du connecteur en tant que fichier de spécification JSON. Pour en savoir plus, consultez Exporter et importer.
Exporter et importer
Vous pouvez partager le connecteur entre différents projets Google Cloud en exportant et en important la spécification du connecteur. Vous pouvez exporter n'importe quelle version de connexion, puis importer la spécification dans le même projet ou dans différents projets Google Cloud . L'exportation des versions de connecteurs obsolètes n'est pas prise en charge.
Rôles et autorisations requis
Pour obtenir les autorisations nécessaires à l'exportation et à l'importation d'un connecteur personnalisé, demandez à votre administrateur de vous accorder les rôles IAM suivants :
Administrateur de sécurité (roles/iam.securityAdmin) sur le projet contenant le secret. Vous pouvez également demander à votre administrateur de vous accorder, ou d'accorder au compte de service, les autorisations secretmanager.secrets.getIamPolicy et secretmanager.secrets.setIamPolicy sur le projet contenant le secret.
Parcourez et sélectionnez le fichier de spécification JSON du connecteur personnalisé. Si vous importez le connecteur dans un autre projet, le champ Compte de service n'est pas prérempli.
Selon que le connecteur existe déjà ou non, les scénarios suivants sont possibles :
Un connecteur portant le même nom n'existe pas : la page Créer un connecteur personnalisé s'affiche. La version du connecteur dans le fichier JSON importé est préremplie. Cette version ne peut pas être modifiée.
Un connecteur portant le même nom existe, mais la même version n'existe pas : la page Créer une version pour ce connecteur s'affiche. Les propriétés du connecteur (type, nom, description, etc.) sont préremplies à partir du connecteur existant et ne sont pas écrasées par le fichier JSON importé. Toutefois, les détails et le nom de la version du connecteur sont lus à partir du fichier JSON importé. Seul le nom de la version peut être modifié.
Un connecteur portant le même nom et la même version existe : un message d'avertissement s'affiche pour indiquer que la version existe déjà et qu'une nouvelle version sera utilisée lorsque vous importerez la spécification JSON. Si vous cliquez sur Importer, la page Créer une version pour ce connecteur s'affiche. Les propriétés du connecteur (type, nom, description, etc.) sont préremplies à partir du connecteur existant et ne sont pas écrasées par le fichier JSON importé. Toutefois, les détails de la version sont lus à partir du fichier JSON importé et peuvent être modifiés. Le numéro de la dernière version disponible est utilisé pour le nom de la version.
Renseignez les autres champs, puis cliquez sur Créer. Le connecteur est créé avec la spécification JSON importée.
Quotas et limites
Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.
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/09/03 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/03 (UTC)."],[[["\u003cp\u003eThis document guides you through creating and managing custom connector versions within Application Integration, including how to create a new version with direct or indirect connectivity.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage a custom connector version by viewing details, deprecating, deleting, or exporting it as a JSON specification file.\u003c/p\u003e\n"],["\u003cp\u003eConnectors can be shared between different Google Cloud projects by exporting the connector specification as a JSON file and then importing it into another project.\u003c/p\u003e\n"],["\u003cp\u003eImporting a connector specification allows you to create a new connector, or add a new version to an existing connector, depending on whether the connector name or version already exists.\u003c/p\u003e\n"],["\u003cp\u003eTo export or import custom connectors, ensure you have the required IAM roles, including \u003ccode\u003eStorage Object Admin\u003c/code\u003e and \u003ccode\u003eSecurity Admin\u003c/code\u003e, or the equivalent permissions.\u003c/p\u003e\n"]]],[],null,["# Manage custom connector version\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nManage custom connector version\n===============================\n\n|\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nCreate a custom connector version\n---------------------------------\n\nTo create a custom connector version, follow these steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\n\n This displays the list of custom connectors.\n2. Click the custom connector for which you want to add a version. The displays the connection details page.\n\n3. Click **Versions** .\n\n The page displays all the versions of the connector.\n4. Click **Create** . This displays the **Create new version** page with the new version number. The steps to create a new version are similar to that of creating a new custom connector. It means that you can create a version with direct or indirect connectivity.\n - For creating a version with direct connectivity, do steps (from step 3 onwards) as documented in [Create a custom connector with direct connectivity](/integration-connectors/docs/create-custom-connector#create-a-custom-connector-with-direct-connectivity).\n - For creating a version with indirect connectivity, do steps (from step 3 onwards) as documented in [Create a custom connector with indirect connectivity](/integration-connectors/docs/create-custom-connector#create-a-custom-connector-with-indirect-connectivity).\n\nManage a custom connector version\n---------------------------------\n\nTo edit a custom connector, do the following steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\n\n This displays the list of custom connectors.\n2. Click the custom connector that has versions. The displays the connection details page.\n\n3. Click **Versions** .\n\n The versions for the selected connector appears.\n4. Click more_vert **Actions** to select one of the following options:\n - **View Details**: To view the custom connector version details.\n - **Deprecate Version**: To deprecate the version.\n - **Delete**: To delete the version.\n - **Export** : To downloads the connector version as a JSON specification file. For more information, see [Export and import](#export-import).\n\nExport and import\n-----------------\n\nYou can share the connector between different Google Cloud projects by exporting and importing the connector specification. You can export any connection version and then import the specification to the same project or different Google Cloud projects. Exporting deprecated connector versions is not supported.\n\n### Required roles and permissions\n\n\nTo get the permissions that\nyou need to export and import a custom connector,\n\nask your administrator to grant you the\nfollowing IAM roles:\n\n- [Storage Object Admin](/iam/docs/roles-permissions/storage#storage.objectAdmin) (`roles/storage.objectAdmin`) on the Cloud Storage bucket\n- [Security Admin](/iam/docs/roles-permissions/iam#iam.securityAdmin) (`roles/iam.securityAdmin`) on the project in which the secret is present. Alternatively, you can also ask your administrator to grant you or the service account, the `secretmanager.secrets.getIamPolicy` and `secretmanager.secrets.setIamPolicy` permissions on the project in which the secret is present.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nYou might also be able to get\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\n### Export a custom connector\n\nTo export a connector version, follow these steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\n2. Click the custom connector that you want to export. The custom connector's overview page opens.\n3. Click **Versions**. A list of versions of the custom connector is displayed.\n4. Click more_vert **More Actions** and then click upload **Export**. A JSON specification file for the custom connector is downloaded.\n\n### Import a custom connector\n\nTo import a connector version, follow these steps:\n\n1. In the [Console](https://console.cloud.google.com/), go to the **Application Integration \\\u003e Custom connectors** page, and then select or create a Google Cloud project.\n\n\n [Go to the Custom connectors page](https://console.cloud.google.com/integrations/custom-connectors)\nThe **Custom connectors** page appears.\n2. Click download **Import**.\n3. Browse and select the JSON specification file for the custom connector. If you are importing the connector to a different project, then the **Service account** field is not prefilled.\n\n \u003cbr /\u003e\n\n | **Note:** Ensure that the connector that you want to import is not deprecated.\n\n Based on whether the connector already exists or not, the following scenarios are possible:\n - **Connector with the same name doesn't exist:** The **Create custom connector** page appears. The connector version in the imported JSON is prefilled. This version can't be changed.\n - **Connector with the same name exists but the same version doesn't exist:** The **Create version** page for that connector appears. Connector properties like connector type, name, description are prefilled from the existing connector and are not overwritten from the imported JSON. However, the connector version details and name are read from the imported JSON. Only the version name can be edited.\n - **Connector with the same name and version exists:** A warning message appears stating that the version already exists and a new version will be used when you import the JSON specification. If you click **Import** , the **Create version** page for that connector appears. Connector properties like the connector type, name, description are prefilled from the existing connector and are not overwritten by the imported JSON. However, the version details are read from the imported JSON and can be edited. The latest available version number is used for the version name.\n4. Fill the remaining details and click **Create**. The connector is created with the imported JSON specification.\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
