Bonnes pratiques pour les rapports d'utilisation

Pour les produits SaaS basés sur l'utilisation, Google Cloud Marketplace attribue l'utilisation à un seul projet Google Cloud, spécifié par le champ usageReportingId. Dans certains cas, un produit SaaS peut être largement partagé au sein de l'organisation d'un client et utilisé dans de nombreux projets. Pour permettre une attribution des coûts plus précise, nous vous recommandons d'inclure le champ userLabels facultatif dans l'opération de votre rapport d'utilisation des produits SaaS basés sur l'utilisation.

Si votre service est déjà compatible avec un concept d'étiquettes de ressource, nous vous recommandons de transférer ces étiquettes dans vos rapports d'utilisation. Les libellés doivent être conformes aux exigences de syntaxe.

Libellés d'utilisation

Cloud Marketplace réserve les libellés suivants. Vous pouvez utiliser ces étiquettes pour identifier un contexte supplémentaire à utiliser dans votre plate-forme de service. Nous vous recommandons d'inclure ces étiquettes dans vos rapports d'utilisation par défaut.

Clé du libellé	Valeur du libellé	Description >
cloudmarketplace.googleapis.com/resource_name	USER_SUPPLIED	Nom de la ressource associée à une métrique d'utilisation.
cloudmarketplace.googleapis.com/container_name	USER_SUPPLIED	Nom d'un conteneur de ressources.

Les libellés sont transférés vers les outils de gestion des coûts de Cloud Billing, y compris les rapports de coût et les exportations de la facturation.

Exemple de libellé d'utilisation

Pour cet exemple, imaginons que votre organisation propose un produit de stockage appelé SaaS Storage Solutions.

Un client, Carl, a acheté votre offre de stockage pour son projet Google Cloud e-commerce-website afin d'héberger les bases de données user_profiles_db et products_db de son site Web d'e-commerce:

• user_profiles_db contient des informations sur les utilisateurs qui visitent le site de Carl.
• products_db contient des informations sur les produits que Carl vend sur son site.

Si vous souhaitez fournir à Carl une répartition détaillée des coûts de son utilisation, vous pouvez utiliser la paire clé-valeur userLabels pour enregistrer le coût d'utilisation de chaque base de données séparément.

Par exemple, pour indiquer le coût attribué à l'utilisation de l'espace de stockage products_db de Carl, vous pouvez envoyer le rapport suivant, qui indique que l'espace de stockage products_db de Carl lui coûte 100 unités:

operation = {
  'operationId': '<UUID>',
  'operationName': 'db-total-storage',
  'consumerId': 'project:carl_website',
  'startTime': '<Timestamp>',
  'endTime': '<Timestamp>',
  'metricValues': [{
      'int64Value': 100,
  }],
  'userLabels': {
    'cloudmarketplace.googleapis.com/container_name': 'e-commerce-website',
    'cloudmarketplace.googleapis.com/resource_name': 'products_db'
  }
}

service.services().report(
  serviceName=service_name, body={
    'operations': [operation]
}).execute()

Dans cet exemple, service_name est l'ID de projet du projet Google Cloud de Carl.

Pour obtenir un exemple plus détaillé de l'utilisation de userLabels, consultez l'atelier de programmation sur les SaaS.