Labels erstellen und verwalten (Advanced)

Die Cloud Translation API unterstützt das Hinzufügen benutzerdefinierter Labels (Schlüssel/Wert-Paare) zu TranslateText-, BatchTranslateText- und DetectLanguage-Anfragen. Informationen zur Nutzung in einer Anfrage werden an das Abrechnungssystem weitergeleitet, sodass Sie Ihre Abrechnungsgebühren durch Filtern nach Label aufschlüsseln können.

Anwendungsfall

Ein wichtiger Anwendungsfall für Labels sind Kunden, die Übersetzungsdienste für viele Kunden anbieten. Ein einzelnes Projekt kann für mehrere Kunden verwendet werden. Zu Abrechnungszwecken ist es wichtig, bestimmte Anfragen ihren jeweiligen Kunden zuzuordnen. Hier kommen Labels ins Spiel. Wenn Sie im Namen eines Kunden einen Aufruf ausführen, fügen Sie der Anfrage ein kundenspezifisches Label hinzu. Diese Labels stehen dann im Bereich Berichte von Google Cloud für Filterzwecke zur Verfügung.

Anforderungen an Labels

Die Labels, die auf eine Anfrage angewendet werden, müssen die folgenden Anforderungen erfüllen:

Jede Anfrage kann bis zu 64 Labels haben.
Jedes Label muss ein Schlüssel/Wert-Paar sein.
Schlüssel haben eine Mindestlänge von 1 Zeichen und eine maximale Länge von 63 Zeichen und dürfen nicht leer sein. Werte dürfen leer sein und haben eine maximale Länge von 63 Zeichen.
Schlüssel und Werte enthalten nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche. Alle Zeichen müssen UTF-8-codiert sein. Internationale Zeichen sind zulässig.
Der Schlüsselabschnitt eines Labels muss innerhalb einer einzelnen Anfrage eindeutig sein. Beispiel: {'country':'india'} ist zulässig, {'country':'india','country':'sweden'} ist jedoch nicht zulässig.
Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen.

Labels und Abrechnung

In Cloud Translation können Sie Labels verwenden, um Gebühren nach Rechnungskonto zu organisieren. Sie werden für die Verwendung von Labels in Cloud Translation nicht geändert.

Die Gebühren sind dem Rechnungskonto des Projekts zugeordnet, das die Anfrage enthält. Wenn ein benutzerdefiniertes Modell oder ein NMÜ-Modell (neuronale maschinelle Übersetzung) verwendet wird, fallen Gebühren für das Projekt mit dem Modellan.

Zu Abrechnungszwecken können alle abrechenbaren Anfragen eigene Labels haben. Diese abrechenbaren Anfragen umfassen Batchübersetzungen, Spracherkennung und Übersetzung von Text.

Labels mit der Cloud Translation API erstellen und verwalten

Verwenden Sie die Cloud Translation API, um einer Anfrage Labels hinzuzufügen.

REST

Im folgenden Beispiel werden die Labels {'country':'russia'}, {'env':'test'} zur Anfrage translateText hinzugefügt.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_NUMBER_OR_ID: Die numerische oder alphanumerische ID Ihres Google Cloud-Projekts

HTTP-Methode und URL:

POST https://translation.googleapis.com/v3/projects/PROJECT_NUMBER_OR_ID:translateText

JSON-Text anfordern:

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$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

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Preisbericht

Rufen Sie in der Abrechnungskonsole von Google Cloud die Ansicht Berichte auf, um diese Labels als Filter für Abfragen zu verwenden.

Klicken Sie im Dashboard oben links auf das Hamburgersymbol und wählen Sie im Drop-down-Menü die Option "Abrechnung" aus. Wenn Sie mehrere Rechnungskonten haben, wird eine Seite angezeigt, auf der Sie aufgefordert werden, eine Auswahl zu treffen. Klicken Sie auf "Zum verknüpften Rechnungskonto".
Wählen Sie auf der Seite "Abrechnung" die Option Berichte im linken Navigationsbereich aus.
Verwenden Sie die Filter im rechten Navigationsbereich, um die Nutzung von Anfragen zu prüfen.