Endpoint global dan multi-regional

Cloud Translation - Advanced menawarkan endpoint global serta endpoint multiregional Uni Eropa dan AS:

  • translate.googleapis.com(global)
  • translate-eu.googleapis.com
  • translate-us.googleapis.com

Jika Anda menggunakan endpoint multiwilayah, data dalam penyimpanan dan pemrosesan machine learning Anda akan tetap berada dalam batas kontinental Uni Eropa atau Amerika Serikat. Endpoint multiwilayah ini penting jika lokasi data Anda harus dikontrol untuk mematuhi persyaratan peraturan setempat.

Jika Anda tidak menentukan endpoint, Cloud Translation - Advanced akan menggunakan endpoint global secara default.

Endpoint global versus multi-regional

Saat menggunakan endpoint multi-regional, ada beberapa perbedaan jika dibandingkan dengan menggunakan endpoint global:

  • Terjemahan teks yang menggunakan model AutoML kustom tidak didukung. Anda hanya dapat menggunakan model NMT terlatih.
  • Menerjemahkan dokumen berformat (disebut juga terjemahan dokumen) tidak didukung
  • Fitur yang bukan GA (masih dalam Pratinjau) tidak didukung.
  • Panggilan melalui endpoint global tidak dapat mengakses resource yang dibuat menggunakan endpoint multi-regional. Demikian pula, panggilan melalui endpoint multi-regional tidak dapat mengakses resource yang dibuat menggunakan endpoint global.

Membatasi lokasi resource

Administrator kebijakan organisasi dapat membatasi region yang tersedia untuk Cloud Translation - Resource lanjutan dengan membuat batasan lokasi resource. Jika ditetapkan, Cloud Translation - Pengguna tingkat lanjut akan dapat membuat resource hanya di lokasi tertentu.

Menentukan endpoint

Contoh berikut menunjukkan terjemahan teks yang menggunakan endpoint multi-regional. Jika Anda menggunakan library klien, tetapkan endpoint API sebagai bagian dari opsi klien. Untuk beberapa contohnya, lihat Menetapkan lokasi menggunakan library klien dalam panduan Cloud Natural Language API.

REST

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

  • PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik untuk project Google Cloud Anda
  • ENDPOINT: Endpoint regional, yang menentukan tempat data Anda berada. Contoh, translate-eu.googleapis.com.
  • LOCATION: Region tempat Anda ingin menjalankan operasi ini. Anda harus memilih region di dalam batas benua untuk endpoint regional. Misalnya, jika Anda menggunakan endpoint translate-eu.googleapis.com, tentukan region di Eropa seperti europe-west1.

Metode HTTP dan URL: 

POST https://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText

Isi JSON permintaan: 

{
  "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base",
  "sourceLanguageCode": "en",
  "targetLanguageCode": "de",
  "contents": ["Come here!"]
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

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://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText"

PowerShell

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://ENDPOINT/v3/projects/PROJECT_NUMBER_OR_ID/locations/LOCATION:translateText" | Select-Object -Expand Content

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

{
  "translations": [
    {
      "translatedText": "Komm her!",
      "model": "projects/PROJECT_NUMBER_OR_ID/locations/LOCATION/models/general/base"
    }
  ]
}