Creazione di report sull'utilizzo con etichette (avanzato)

L'API Cloud Translation supporta l'aggiunta di etichette definite dall'utente (coppie chiave-valore) alle richieste TranslateText, BatchTranslateText e DetectLanguage. Le informazioni sull'utilizzo di una richiesta vengono inoltrate al sistema di fatturazione, dove puoi suddividere i costi di fatturazione filtrando per etichetta.

Caso d'uso

Un caso d'uso importante per le etichette riguarda i clienti che forniscono servizi di traduzione a molti clienti. Un singolo progetto può essere utilizzato per più clienti. Ai fini della fatturazione, è importante associare richieste specifiche ai rispettivi clienti. È qui che entrano in gioco le etichette. Quando effettui una chiamata per conto di un cliente, etichetti la richiesta con un'etichetta specifica per il cliente. Queste etichette sono poi disponibili per il filtraggio nella sezione Report di Google Cloud.

Requisiti per le etichette

Le etichette applicate a una richiesta devono soddisfare i seguenti requisiti:

• Ogni richiesta può avere più etichette, fino a un massimo di 64.
• Ogni etichetta deve essere una coppia chiave-valore.
• Le chiavi hanno una lunghezza minima di 1 carattere e una lunghezza massima di 63 caratteri e non possono essere vuote. I valori possono essere vuoti e avere una lunghezza massima di 63 caratteri.
• Chiavi e valori contengono solo lettere minuscole, caratteri numerici, trattini bassi e trattini. Tutti i caratteri devono utilizzare la codifica UTF-8 e sono consentiti i caratteri internazionali.
• La parte della chiave di un'etichetta deve essere univoca all'interno di una singola richiesta (ad esempio, {'country':'india'} va bene, ma {'country':'india','country':'sweden'} non è consentito).
• Le chiavi devono iniziare con una lettera minuscola o un carattere internazionale.

Etichette e fatturazione

In Cloud Translation, puoi utilizzare le etichette per organizzare le tariffe per account di fatturazione. Non ti viene addebitato alcun costo per l'utilizzo delle etichette Cloud Translation.

Le tariffe sono associate all'account di fatturazione del progetto che contiene la richiesta. In alternativa, se viene utilizzato un modello personalizzato o di traduzione automatica neurale (NMT), le tariffe sono associate al progetto che contiene il modello.

Ai fini della fatturazione, tutte le richieste fatturabili possono avere etichette proprie. Queste richieste fatturabili includono la traduzione batch, il rilevamento della lingua e la traduzione del testo.

Creazione e gestione delle etichette utilizzando l'API Cloud Translation

Utilizza l'API Cloud Translation per aggiungere etichette a una richiesta.

REST

Nel seguente esempio, le etichette {'country':'russia'},{'env':'test'} vengono aggiunte alla richiesta translateText.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_NUMBER_OR_ID: l'ID numerico o alfanumerico del tuo Google Cloud progetto

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

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

Report sui prezzi

Vai alla visualizzazione Google Cloud Report della console di fatturazione per utilizzare queste etichette come filtri per l'utilizzo delle richieste.

1. Nel pannello, fai clic sull'icona a forma di hamburger in alto a sinistra e seleziona "Fatturazione" dal menu a discesa. Se disponi di più account di fatturazione, viene visualizzata una pagina che ti chiede di effettuare una selezione. Fai clic su "Vai all'account di fatturazione collegato".
2. Nella pagina Fatturazione, seleziona Report nel menu di navigazione a sinistra.
3. Utilizza i filtri nel riquadro di navigazione a destra per controllare l'utilizzo delle richieste.