Endpoint global dan multi-regional

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

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

Jika Anda menggunakan endpoint multi-regional, data dalam penyimpanan dan pemrosesan machine learning Anda akan tetap berada dalam batas kontinental Uni Eropa atau Amerika Serikat. Endpoint multi-regional 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 hal yang berbeda jika dibandingkan dengan endpoint global:

  • Terjemahan teks yang menggunakan model AutoML khusus tidak didukung. Anda hanya dapat menggunakan model NMT terlatih.
  • 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 resource Cloud Translation - Advanced dengan membuat batasan lokasi resource. Jika ditetapkan, pengguna Cloud Translation - Advanced akan dapat membuat resource hanya di lokasi tertentu.

Membatasi penggunaan endpoint API global

Untuk membantu menerapkan penggunaan endpoint regional, administrator kebijakan organisasi dapat menggunakan batasan kebijakan organisasi constraints/gcp.restrictEndpointUsage untuk memblokir permintaan ke endpoint API global. Untuk informasi selengkapnya, baca artikel Membatasi penggunaan endpoint.

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 contoh, baca artikel Menetapkan lokasi menggunakan library klien dalam panduan Cloud Natural Language API.

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_NUMBER_OR_ID: ID numerik atau alfanumerik 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

Meminta isi JSON: 

{
  "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"
    }
  ]
}