Signaler l'utilisation avec des libellés (version Advanced)

L'API Cloud Translation permet d'ajouter des libellés définis par l'utilisateur (paires clé/valeur) aux requêtes TranslateText, BatchTranslateText et DetectLanguage. Les informations sur l'utilisation d'une requête sont transmises au système de facturation, dans lequel vous pouvez consulter le détail des frais apparaissant sur votre facture en fonction des libellés.

Cas d'utilisation

Un cas d'utilisation important des libellés concerne les clients qui fournissent des services de traduction à de nombreux clients. Un même projet peut être utilisé pour plusieurs clients. À des fins de facturation, il est important d'associer des requêtes spécifiques à leur client respectif. C'est là qu'interviennent les libellés. Lorsque vous effectuez un appel pour le compte d'un client, ajoutez à la requête un libellé propre au client. Les libellés peuvent ensuite être filtrés dans la section Rapports de Google Cloud.

Exigences relatives aux libellés

Les libellés appliqués à une requête doivent répondre aux exigences suivantes :

  • Chaque requête peut posséder plusieurs libellés, jusqu'à un maximum de 64.
  • Chaque libellé doit correspondre à une paire clé/valeur.
  • Les clés doivent comporter un (1) caractère au minimum et 63 au maximum, et ne peuvent pas être vides. Les valeurs peuvent être vides et comporter 63 caractères au maximum.
  • Les clés et les valeurs ne contiennent que des lettres minuscules, des chiffres, des traits de soulignement et des tirets. Tous les caractères doivent être au format d'encodage UTF-8. Les caractères internationaux sont autorisés.
  • La partie clé d'un libellé doit être unique au sein d'une même requête. Par exemple, {'country':'india'} convient, mais {'country':'india','country':'sweden'} n'est pas autorisé.
  • Les clés doivent commencer par une lettre minuscule ou un caractère international.

Libellés et facturation

Dans Cloud Translation, vous pouvez organiser les frais par compte de facturation à l'aide de libellés. L'utilisation des libellés Translation ne vous est pas facturée.

Des frais sont associés au compte de facturation du projet qui contient la requête. Si vous utilisez un modèle personnalisé ou général, des frais sont associés au projet contenant le modèle.

Pour les besoins de la facturation, toutes les requêtes facturables peuvent avoir leur propre libellé. Celles-ci incluent la traduction par lot, la détection de la langue et la traduction du texte.

Créer et gérer des libellés à l'aide de l'API Cloud Translation

Utilisez l'API Cloud Translation pour ajouter des libellés à une requête.

API REST et ligne de commande

Dans l'exemple suivant, les libellés {'country':'russia'} et {'env':'test'} sont ajoutés à la requête translateText.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • project-number-or-id par le numéro ou l'ID de votre projet Google Cloud

Méthode HTTP et URL :

POST https://translation.googleapis.com/v3/projects/project-number-or-id:translateText

Corps JSON de la requête :

{
  source_language_code: 'en',
  target_language_code: 'ru',
  contents: 'Dr. Watson, come here!',
  labels: {'country':'russia','env':'test'}
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
https://translation.googleapis.com/v3/projects/project-number-or-id:translateText

PowerShell

.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://translation.googleapis.com/v3/projects/project-number-or-id:translateText " | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "translations": [
    {
      "translatedText": "Доктор Ватсон, иди сюда!"
    }
  ]
}

Rapport de tarification

Accédez à la vue Rapports de la console de facturation Google Cloud pour utiliser ces libellés comme filtres d'utilisation des requêtes.

  1. Dans le tableau de bord, cliquez sur l'icône à trois barres dans l'angle supérieur gauche, puis sélectionnez "Facturation" dans le menu déroulant. Si vous possédez plusieurs comptes de facturation, une page s'affiche et vous invite à faire votre choix. Cliquez sur "Accéder au compte de facturation associé".
  2. Sur la page "Facturation", sélectionnez Rapports dans le menu de navigation de gauche.
  3. Utilisez les filtres du menu de navigation de droite pour vérifier l'utilisation des requêtes.