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 à la 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 Partner Sales Console au moins une fois en tant qu'administrateur du domaine de revendeur. Lors de votre première connexion, 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 d'utilisation de la Partner Sales Console.

Remarque :Pour intégrer l'API, vous aurez besoin de votre ID de compte, disponible sur la page des paramètres de la Partner Sales Console.

Étape 2: Configurez votre projet Google Cloud

Pour utiliser n'importe quelle 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 Projets de la console Google Cloud, puis cliquez sur Créer un projet.

Pour obtenir des instructions plus détaillées sur la création d'un projet et la liste des 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 de revendeur. L'accès aux données du domaine du revendeur est autorisé en configurant une délégation au niveau du domaine, pour permettre à un compte de service d'accéder aux données du domaine du revendeur.

Attribuez un nom descriptif au projet. L'ID du projet est un identifiant arbitraire qui n'affecte pas votre capacité à appeler l'API Cloud Channel.

Activer l'API

Accédez à la section Bibliothèque d'API de la console Google Cloud et 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 du compte de service facultative), puis cliquez sur Créer.
3. Cliquez sur Continuer pour ignorer l'option Accorder au compte de service l'accès au projet.
4. Ignorez la section Autoriser les utilisateurs à accéder à ce compte de service et 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 depuis la page "Comptes de service".

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

Pour cette section, vous avez besoin de l'ID client de votre compte de service. Dans le menu Actions, sélectionnez Gérer les détails et copiez votre ID unique.

Accédez à la page 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 permettre à votre compte de service d'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 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 des champs d'application dans d'autres ateliers de programmation. Votre intégration finale peut comporter plusieurs champs d'application pour le client de votre compte de service.

Étapes suivantes

Maintenant que vous disposez d'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 test. Étant donné que les API Google ont des quotas par projet, veillez à créer un projet distinct. Le partage d'un projet entre plusieurs environnements peut entraîner l'impact de vos comptes de test sur les quotas de votre compte de production.