Présentation de l'API Reseller

Google propose des produits aux utilisateurs par le biais de canaux de distribution tels que les revendeurs Google Workspace agréés. Lorsque vous utilisez l'API Reseller, vous devez comprendre les relations conceptuelles entre les revendeurs, 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. Un revendeur peut gérer les abonnements des clients directement ou collaborer avec un intégrateur de services pour gérer les clients lorsqu'il personnalise plusieurs services.

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, mais les revendeurs sont facturés pour le nombre de licences commandées. Pour augmenter le nombre de licences, les revendeurs peuvent utiliser la méthode subscriptions.changeSeats.
  • flexible : chaque fois qu'un client crée un utilisateur, Google facture la 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 fournissent aux clients des services 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 dans 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, le revendeur fournit un nom de domaine principal, une adresse e-mail secondaire et une adresse physique. Le revendeur crée également un abonnement pour chaque SKU de produit disponible pour le client. Le client héberge chaque compte utilisateur. 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 les forfaits suivants :

  • 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 peut varier jusqu'à 30 jours.
    • Limite d'envoi Gmail quotidienne de 500 messages par utilisateur.
  • FREE : Forfait sans frais uniquement pour les abonnements Cloud Identity Free Edition.

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

Abonnement

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

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 d'un bon de commande d'un revendeur. Un client peut disposer de plusieurs abonnements, un pour chaque SKU de produit qui lui est attribué.

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

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

Produits et SKU de produits

Un produit est une offre commerciale 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. Chaque version est identifiée par un SKU de produit. L'API Reseller propose des abonnements pour les SKU des produits Google Workspace, Google Vault et Google Drive. Pour en savoir plus, consultez Produits et SKU.