Présentation de l'API Reseller

Google propose des services de produits Google aux utilisateurs par le biais de canaux de distribution de services tels que les revendeurs Google Workspace agréés. Lorsque vous utilisez l'API Reseller, il est important de comprendre les relations conceptuelles entre les revendeurs et les clients, les forfaits, les SKU de produits et les licences.

Revendeur

Un revendeur achète des licences utilisateur à Google et les revend à des clients Google. Un revendeur peut gérer directement les abonnements des clients. S'il personnalise plusieurs services, il peut faire appel à un intégrateur de services pour gérer les clients.

Les revendeurs peuvent choisir parmi les forfaits suivants :

  • Engagement annuel : le revendeur achète un nombre fixe de licences à Google pour un an. Les clients peuvent créer jusqu'au nombre de licences autorisé, mais les revendeurs sont facturés pour le nombre de licences commandées. Si les clients ont besoin de licences supplémentaires, les revendeurs peuvent utiliser l'appel d'API subscriptions.changeSeats pour augmenter le nombre de licences commandées.
  • flexible : chaque fois qu'un client crée un utilisateur, Google facture cette licence au revendeur. Le contrat du revendeur avec Google décrit le prix, les spécifications et le nombre maximal de licences.

En plus de gérer les licences utilisateur, le revendeur (ou ses intégrateurs de services partenaires) propose aux clients un large éventail de services supplémentaires tels que la formation, les promotions, la publicité, la tarification, les personnalisations de déploiement, le dépannage et la maintenance.

Licences

Une licence permet à un utilisateur disposant d'un compte Google d'accéder aux services Google Workspace. Lorsqu'un client attribue une licence à un utilisateur, elle devient active. Seules les licences actives sont comptabilisées lors du calcul du nombre total d'utilisateurs d'un client.

Client

Un client Google commence par un compte Google Workspace que le revendeur configure. Lors de la configuration du compte du client, le revendeur fournit un nom de domaine principal, une adresse e-mail secondaire et une adresse physique. Le revendeur crée ensuite un abonnement pour chaque SKU de produit disponible pour le client. Le client héberge chaque compte utilisateur individuel. Pour en savoir plus, consultez Commander un nouveau compte client.

Forfaits

Un forfait définit les conditions de facturation d'un revendeur avec Google. Ces forfaits ne définissent pas la relation de facturation entre un revendeur et ses clients. Les revendeurs définissent leurs propres conditions de facturation avec leurs clients.

L'API Reseller est compatible avec le système de post-paiement mensuel Google Workspace, qui propose plusieurs forfaits :

  • ANNUAL_MONTHLY_PAY : engagement annuel avec paiements mensuels
  • ANNUAL_YEARLY_PAY : engagement annuel avec un paiement annuel
  • FLEXIBLE : forfait sans engagement avec paiements mensuels
  • TRIAL : forfait d'essai sans frais
    • La durée de l'essai est variable, jusqu'à un maximum de 30 jours.
    • Limite d'envoi quotidienne de 500 messages Gmail par utilisateur.
  • FREE : forfait sans frais uniquement pour les abonnements Cloud Identity Free Edition

Pour en savoir plus sur ces forfaits, consultez Choisir le forfait de vos clients.

Abonnement

Un abonnement gère la relation entre le forfait d'un client Google et le SKU d'un produit, les licences utilisateur, l'état de l'essai sans frais de 30 jours et les options de renouvellement. Le rôle principal d'un revendeur est de gérer les abonnements du client Google.

Dans l'API Reseller, un abonnement est une ressource d'API principale. Il définit les paramètres d'un forfait, des licences, d'un essai sans frais de 30 jours, du renouvellement et du bon de commande d'un revendeur. Un client peut disposer de plusieurs abonnements, un pour chaque SKU de produit que le revendeur lui attribue.

Chaque abonnement possède un identifiant unique, un subscriptionId. Étant donné qu'un subscriptionId change lorsque l'abonnement change, n'utilisez pas de valeur subscriptionId comme clé pour les données persistantes. Cette clé ne fonctionnera plus si l'abonnement change.

Pour en savoir plus, consultez Gérer les abonnements.

Produits et SKU de produits

Un produit est une offre commerciale d'un ensemble spécialisé de fonctionnalités de services et d'applications Google. Un produit peut avoir des versions personnalisées des conditions, des tarifs et d'autres détails de l'accord. Chacune de ces versions de produit est identifiée par un SKU de produit. Dans cette version, l'API Reseller propose un abonnement pour chaque SKU des produits Google Workspace, Google Vault et Google Drive. Pour en savoir plus, consultez Produits et SKU.