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 Cloud Translation ne vous est pas facturée.

Des frais sont associés au compte de facturation du projet qui contient la requête. Si un modèle de traduction automatique neuronale (NMT, Neural Machine Translation) ou personnalisé est utilisé, des frais sont associés au projet qui contient 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.

REST

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 : ID numérique ou alphanumérique 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, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

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 print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER_OR_ID" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER_OR_ID" }

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.

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é".
Sur la page "Facturation", sélectionnez Rapports dans le menu de navigation de gauche.
Utilisez les filtres du menu de navigation de droite pour vérifier l'utilisation des requêtes.