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.
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 sepertieurope-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" } ] }