Regionalisasi

Menentukan region sangat membantu dalam kasus penggunaan berikut:

• Sistem Anda memiliki persyaratan peraturan atau kebijakan yang mengatur lokasi data Anda harus berada.
• Latensi jaringan Anda mungkin meningkat jika data berada di region yang sama dengan pelanggan Anda. Misalnya, jika pelanggan di Belgia menggunakan europe-west1, mereka dapat mengharapkan latensi yang lebih baik.

Wilayah yang tersedia

Pengelompokan negara	Lokasi geografis	Endpoint	Lokasi Resource
Global	Penayangan global, data saat tidak digunakan di AS	contactcenterinsights.googleapis.com	us-central1
Amerika	Carolina Selatan	us-east1-contactcenterinsights.googleapis.com	us-east1
Amerika	Oregon	us-west1-contactcenterinsights.googleapis.com	us-west1
Amerika	Montréal	northamerica-northeast1-contactcenterinsights.googleapis.com	northamerica-northeast1
Amerika	Multi-Region	us-contactcenterinsights.googleapis.com	us
Eropa	Belgia	europe-west1-contactcenterinsights.googleapis.com	europe-west1
Eropa	London	europe-west2-contactcenterinsights.googleapis.com	europe-west2
Eropa	Frankfurt	europe-west3-contactcenterinsights.googleapis.com	europe-west3
Eropa	Belanda	europe-west4-contactcenterinsights.googleapis.com	europe-west4
Eropa	Zurich	europe-west6-contactcenterinsights.googleapis.com	europe-west6
Asia Pasifik	Tokyo	asia-northeast1-contactcenterinsights.googleapis.com	asia-northeast1
Asia Pasifik	Seoul	asia-northeast3-contactcenterinsights.googleapis.com	asia-northeast3
Asia Pasifik	Mumbai	asia-south1-contactcenterinsights.googleapis.com	asia-south1
Asia Pasifik	Singapura	asia-southeast1-contactcenterinsights.googleapis.com	asia-southeast1
Asia Pasifik	Jakarta	asia-southeast2-contactcenterinsights.googleapis.com	asia-southeast2
Asia Pasifik	Sydney	australia-southeast1-contactcenterinsights.googleapis.com	australia-southeast1

Catatan: Panggilan ke region global mungkin memiliki latensi yang lebih tinggi saat dipanggil dari luar Amerika Serikat. Jika memungkinkan, pilih region yang lebih spesifik dan lebih dekat dengan layanan dan pengguna akhir Anda. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Region Google Cloud dan Geografi dan region Google Cloud.

Catatan: Untuk alasan historis, Customer Experience Insights menggunakan ID lokasi resource us-central1 untuk endpoint global, bukan global yang digunakan oleh API yang lebih baru.

Catatan: Anda harus mengubah host URL dan lokasi resource untuk menggunakan instance regional. Mis. us-east1-contactcenterinsights.googleapis.com dan projects/project-id/location/*us-east1*/conversation/conversation-id.

Contoh Perintah

Izin yang diperlukan untuk langkah ini

Untuk melakukan tugas ini, Anda harus memiliki izin berikut:

• contactcenterinsights.analyses.create

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

• PROJECT_ID: Google Cloud Project ID Anda.
• LOCATION_ID: lokasi regional.
• CONVERSATION_ID: ID percakapan yang ingin Anda analisis. Nilai ini ditampilkan dalam respons `createConversation`.

Metode HTTP dan URL:

POST https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses

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 menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses"

PowerShell (Windows)

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

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID"
}

Klien Python

Saat menggunakan klien python, host dan lokasi resource harus diperbarui untuk mengarah ke instance regional.

options = ClientOptions(api_endpoint="us-east1-contactcenterinsights.googleapis.com" )
request = contact_center_insights_v1.ListConversationsRequest(
    parent=f"projects/{project_id}/locations/us-east1",
)
client = contact_center_insights_v1.ContactCenterInsightsClient(client_options=options)

Cloud Logging

Lihat dokumentasi Cloud Logging untuk mengontrol region tempat log Anda disimpan.