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 console Ventes partenaires.

É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 console Ventes partenaires au moins une fois en tant qu'administrateur du domaine du 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 de la console Ventes partenaires.

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 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 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 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.

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 la description facultative du compte de service), 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 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 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 autoriser votre compte de service à utiliser 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 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 inclure plusieurs champs d'application pour le champ d'application de votre compte de service client.

É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 test, suivez les étapes un à quatre avec votre domaine de revendeur test. Veillez à créer un projet distinct puisque Les API Google ont des quotas par projet. Le partage d'un projet entre les environnements peut entraîner un impact sur les quotas de votre compte de production par vos comptes de test.