Présentation de l'API Reseller

Google propose les services des produits Google aux utilisateurs via des 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 des revendeurs avec les clients, les forfaits, les codes SKU des produits et les licences.

Revendeur

Un revendeur achète des licences utilisateur auprès de Google et les revend à ses clients. Un revendeur peut gérer directement les abonnements des clients ou, 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 auprès de Google pour un an. Les clients peuvent créer jusqu'au nombre de licences, mais les revendeurs sont facturés en fonction du 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.
  • Flexibilité: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, celle-ci devient une licence active. Seules les licences actives sont comptabilisées pour calculer le 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 compte client.

Plans

Un forfait définit les conditions de facturation d'un revendeur auprès de 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 postpayé mensuel Google Workspace, qui propose plusieurs forfaits de paiement:

  • ANNUAL_MONTHLY_PAY: engagement annuel avec paiements mensuels
  • ANNUAL_YEARLY_PAY: engagement annuel avec un paiement annuel
  • FLEXIBLE: forfait sans engagement avec paiement mensuel
  • TRIAL: forfait d'essai sans frais
    • La durée de l'essai est variable, mais ne peut pas dépasser 30 jours.
    • Limite d'envoi quotidienne de 500 messages par utilisateur dans Gmail.
  • FREE: forfait sans frais uniquement pour les abonnements à l'édition sans frais de Cloud Identity

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

Abonnement

Un abonnement gère la relation entre le forfait de paiement 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 des clients Google.

Dans l'API Reseller, un abonnement est une ressource API principale. Il définit les paramètres d'un forfait, des licences, de l'essai sans frais de 30 jours, du renouvellement et de la commande d'achat d'un revendeur. Un client peut avoir plusieurs abonnements, un pour chaque code 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é sera endommagée si l'abonnement change.

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

Produits et codes produit

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 informations du contrat. 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 la section Produits et SKU.