Pelaporan penggunaan dengan label (Lanjutan)

Cloud Translation API mendukung penambahan label yang ditentukan pengguna (key-value pair) ke permintaan TranslateText, BatchTranslateText, dan DetectLanguage. Informasi tentang penggunaan permintaan diteruskan ke sistem penagihan, yang dapat Anda gunakan untuk memerinci biaya penagihan dengan memfilter berdasarkan label.

Kasus penggunaan

Kasus penggunaan penting untuk label melibatkan pelanggan yang menyediakan layanan terjemahan kepada banyak klien. Satu project dapat digunakan untuk beberapa klien. Untuk tujuan penagihan, penting untuk mengaitkan permintaan tertentu dengan kliennya masing-masing. Di sinilah fungsi label. Saat melakukan panggilan atas nama klien, Anda memberi label permintaan dengan label khusus klien. Label ini kemudian tersedia untuk tujuan pemfilteran di bagian Reports di Google Cloud.

Persyaratan untuk label

Label yang diterapkan ke permintaan harus memenuhi persyaratan berikut:

• Setiap permintaan dapat memiliki beberapa label, hingga maksimum 64 label.
• Setiap label harus berupa pasangan nilai kunci.
• Kunci memiliki panjang minimum 1 karakter dan panjang maksimum 63 karakter, serta tidak boleh kosong. Nilai boleh kosong, dan memiliki panjang maksimum 63 karakter.
• Kunci dan nilai hanya berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Semua karakter harus menggunakan encoding UTF-8, dan karakter internasional diizinkan.
• Bagian kunci label harus unik dalam satu permintaan (misalnya, {'country':'india'} boleh saja, tetapi {'country':'india','country':'sweden'} tidak diizinkan).
• Kunci harus diawali dengan huruf kecil atau karakter internasional.

Label dan penagihan

Di Cloud Translation, Anda dapat menggunakan label untuk mengatur biaya berdasarkan akun penagihan. Penggunaan label Cloud Translation tidak berubah.

Biaya terkait dengan akun penagihan project yang berisi permintaan. Atau, jika model Terjemahan Mesin Neural (NMT) atau khusus digunakan, biaya akan dikaitkan dengan project yang berisi model tersebut.

Untuk tujuan penagihan, semua permintaan yang dapat ditagih dapat memiliki labelnya sendiri. Permintaan yang dapat ditagih ini mencakup terjemahan batch, mendeteksi bahasa, dan menerjemahkan teks.

Membuat dan mengelola label menggunakan API Cloud Translation

Gunakan Cloud Translation API untuk menambahkan label ke permintaan.

REST

Pada contoh berikut, label {'country':'russia'},{'env':'test'} ditambahkan ke permintaan translateText.

Sebelum menggunakan data permintaan apa pun, lakukan penggantian sebagai berikut:

• PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik untuk project Google Cloud Anda

Metode HTTP dan URL:

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

Isi JSON permintaan:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login gcloud CLI. Anda dapat memeriksa akun yang saat ini sedang aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

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)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI dengan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login gcloud CLI. Anda dapat memeriksa akun yang saat ini sedang aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$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

Anda akan menerima respons JSON yang mirip dengan yang berikut ini:

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

Laporan harga

Buka tampilan Reports konsol penagihan Google Cloud untuk menggunakan label ini sebagai filter untuk penggunaan permintaan.

1. Dari dasbor, klik ikon tiga garis di sisi kiri atas dan pilih "Penagihan" dari menu drop-down. Jika Anda memiliki beberapa akun penagihan, akan muncul halaman yang meminta Anda untuk memilih. Klik "Buka akun penagihan tertaut".
2. Dari halaman Penagihan, pilih Reports di navigasi sebelah kiri.
3. Gunakan filter di navigasi sebelah kanan untuk memeriksa penggunaan permintaan.