Configuration technique

Avant de commencer

Avant de commencer, vous avez besoin des éléments suivants:

• Accès super-administrateur à votre domaine de revendeur. Pour en savoir plus, découvrez comment accéder à l'API Cloud Channel.

• Accès à la console Google Cloud et à Partner Sales Console.

Étape 1: Préparez la Partner Sales Console

Avant de pouvoir utiliser l'API, vous devez accepter les conditions d'utilisation de la plate-forme Channel Services.

Connectez-vous à la console Ventes partenaires au moins une fois en tant qu'administrateur du domaine du revendeur. La première fois que vous vous connectez, vous devez accepter les conditions d'utilisation du revendeur, le cas échéant. Si vous avez accepté des conditions d'utilisation spécifiques hors connexion, cette étape ne vous concerne pas.

Vous pouvez accepter des conditions d'utilisation supplémentaires sur la page Conditions de Partner Sales Console.

Remarque :Vous avez besoin de votre ID de compte, disponible sur la page "Paramètres de la Partner Sales Console", pour l'intégration de l'API.

Étape 2: Configurer votre projet Google Cloud

Pour utiliser une API Google, vous devez disposer d'un projet Google Cloud.

Créer un projet Google Cloud

Pour créer un projet, accédez à la section Projects (Projets) de la console Google Cloud, puis cliquez sur Create Project (Créer un projet).

Pour obtenir des instructions plus détaillées sur la création d'un projet et une liste de bonnes pratiques, consultez notre guide Créer et gérer des projets.

La plupart des revendeurs créent des projets Google Cloud dans leur organisation Google Cloud principale plutôt que dans le domaine du revendeur. Pour accéder aux données du domaine du revendeur, configurez la délégation au niveau du domaine afin d'autoriser un compte de service à accéder aux données du domaine du revendeur.

Attribuez un nom descriptif au projet. L'ID de projet est un identifiant arbitraire qui n'a aucune incidence sur votre capacité à appeler l'API Cloud Channel.

Activer l'API

Accédez à la section Bibliothèque d'API de la console Google Cloud, puis activez l'API Cloud Channel.

Créer un compte de service

Pour créer votre compte de service, accédez à la page Comptes de service.

Accéder à la page "Comptes de service"

Remarque : Les clés de compte de service constituent un risque pour la sécurité si elles ne sont pas gérées correctement. Dans la mesure du possible, vous devez choisir une alternative plus sécurisée aux clés de compte de service. Si vous devez vous authentifier avec une clé de compte de service, vous êtes responsable de la sécurité de la clé privée et des autres opérations décrites dans la section Bonnes pratiques pour la gestion des clés de compte de service. Si vous ne parvenez pas à créer une clé de compte de service, la création de clé de compte de service peut être désactivée pour votre organisation. Pour en savoir plus, consultez la page Gérer les ressources d'organisation sécurisées par défaut.

1. Cliquez sur Créer un compte de service.
2. Saisissez le nom du compte de service (et la description facultative du compte de service), puis cliquez sur Créer.
3. Cliquez sur Continuer pour ignorer l'option Accorder l'accès au projet au compte de service.
4. Ignorez la section Accorder l'accès à ce compte de service à des utilisateurs, puis cliquez sur OK pour terminer la création du compte.

Une fois votre compte créé, créez une clé de compte de service:

1. Dans la console Google Cloud, cliquez sur l'adresse e-mail du compte de service que vous avez créé.
2. Cliquez sur Clés.
3. Cliquez sur Add key (Ajouter une clé), puis sur Create new key (Créer une clé).

4. Cliquez sur Créer. Un fichier de clé JSON est téléchargé sur votre ordinateur.

   Veillez à stocker le fichier de clé en toute sécurité, car il peut être utilisé pour s'authentifier en tant que compte de service. Vous pouvez déplacer et renommer ce fichier comme vous le souhaitez.

5. Cliquez sur Fermer.

Vous pouvez supprimer et créer des fichiers de clé privée sur la page "Comptes de service".

Étape 3: Autorisez le compte de service pour le domaine du revendeur

Vous avez besoin de l'ID client de votre compte de service pour cette section. Dans le menu Actions, sélectionnez Gérer les informations, puis copiez votre ID unique.

Accédez à la page de délégation au niveau du domaine à l'aide du compte super-administrateur de votre domaine de revendeur.

• Cliquez sur Ajouter et saisissez l'ID de votre compte de service dans le champ ID client.
• Saisissez https://www.googleapis.com/auth/apps.order dans le champ Champs d'application OAuth.
• Cliquez sur Autoriser pour autoriser votre compte de service à utiliser l'API Cloud Channel dans le contexte de votre compte Channel Services.

Remarque :Si vous utilisez des API supplémentaires dans votre intégration finale, vous pouvez avoir plusieurs champs d'application pour le client de votre compte de service.

Cliquez ensuite sur Authorize (Autoriser) pour que votre compte de service puisse utiliser l'API Cloud Channel dans le contexte de votre compte Channel Services.

Remarque :Vous devrez peut-être activer d'autres API et ajouter d'autres champs d'application dans d'autres ateliers de programmation. Votre intégration finale peut avoir plusieurs champs d'application pour le client de votre compte de service.

Étapes suivantes

Maintenant que vous avez effectué une intégration technique initiale, vous pouvez découvrir l'API en lisant la documentation de l'API Cloud Channel.

Remarque :Si vous disposez également d'une console Ventes partenaires de test, suivez les étapes 1 à 4 avec votre domaine revendeur de test. Veillez à créer un projet distinct, car les API Google ont des quotas par projet. Le partage d'un projet entre les environnements peut entraîner un impact des quotas de votre compte de production sur vos comptes de test.