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.
  • 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.

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 mengetahui informasi selengkapnya, lihat 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 contohnya, lihat 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 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"
    }
  ]
}