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 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 le Page des conditions d'utilisation de Partner Sales Console.

Remarque :Vous avez besoin de votre ID de compte, que vous trouverez dans les paramètres de la Partner Sales Console. pour l'intégration de l'API.

Étape 2: Configurez 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 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 pour obtenir la liste des consultez notre guide Créer et gérer des projets.

La plupart des revendeurs créent des projets Google Cloud organisation Google Cloud plutôt que sous le domaine du revendeur. Accès les données du domaine de revendeur sont accordées en configurant délégation au niveau du domaine pour permettre à un compte de service d'accéder à partir du domaine de revendeur.

Donnez un nom descriptif au projet. L'ID du projet est un identifiant arbitraire cela 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 le compte de service facultatif description), puis cliquez sur Créer.
3. Cliquez sur Continue (Continuer) pour ignorer l'étape Grant service account access to project (Accorder l'accès au compte de service au projet). .
4. Ignorez la section Autoriser les utilisateurs à accéder à ce compte de service et cliquez sur OK pour finaliser la création du compte.

Après avoir créé votre compte, créez une clé de compte de service:

1. Dans la console Google Cloud, cliquez sur l'adresse e-mail du 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 Create (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

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

Accédez au Page "Délégation au niveau du domaine" en utilisant le 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 le l'API Cloud Channel dans le contexte de votre compte Channel Services.

Remarque :Si vous utilisez d'autres API dans votre intégration finale, vous devrez peut-être 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 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 inclure plusieurs champs d'application pour l'accès client.

Étapes suivantes

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

Remarque :Si vous disposez également d'une Test Partner Sales Console, suivez les étapes un à quatre à votre domaine de revendeur test. Veillez à créer un projet distinct puisque Les API Google ont des quotas par projet. Partager un projet entre plusieurs environnements peut avoir une incidence sur les quotas de votre compte de production.