התאמה לאזור

ציון אזור שימושי במיוחד בתרחישי השימוש הבאים:

• למערכת שלכם יש דרישות רגולטוריות או דרישות מדיניות שקובעות איפה הנתונים שלכם צריכים להיות מאוחסנים.
• יכול להיות שזמני האחזור ברשת ישתפרו אם הנתונים יהיו באותו אזור שבו נמצאים הלקוחות שלכם. לדוגמה, אם לקוחות בבלגיה משתמשים ב-europe-west1, הם יכולים לצפות לזמן אחזור טוב יותר.

אזורים שבהם השירות זמין

קיבוץ לפי מדינה	מיקום גיאוגרפי	נקודת קצה (endpoint)	מיקום המשאב
עולמי	הצגה גלובלית, נתונים במנוחה בארה"ב	contactcenterinsights.googleapis.com	us-central1
אמריקה	דרום קרוליינה	us-east1-contactcenterinsights.googleapis.com	us-east1
אמריקה	אורגון	us-west1-contactcenterinsights.googleapis.com	us-west1
אמריקה	מונטריאול	northamerica-northeast1-contactcenterinsights.googleapis.com	northamerica-northeast1
אמריקה	ארה"ב (מספר אזורים)	us-contactcenterinsights.googleapis.com	us
אירופה	בלגיה	europe-west1-contactcenterinsights.googleapis.com	europe-west1
אירופה	לונדון	europe-west2-contactcenterinsights.googleapis.com	europe-west2
אירופה	פרנקפורט	europe-west3-contactcenterinsights.googleapis.com	europe-west3
אירופה	מספר אזורים	eu-contactcenterinsights.googleapis.com	eu
אירופה	הולנד	europe-west4-contactcenterinsights.googleapis.com	europe-west4
אירופה	ציריך	europe-west6-contactcenterinsights.googleapis.com	europe-west6
אירופה	האיחוד האירופי (מספר אזורים)	eu-contactcenterinsights.googleapis.com	eu
אסיה ואזור האוקיינוס השקט	טוקיו	asia-northeast1-contactcenterinsights.googleapis.com	asia-northeast1
אסיה ואזור האוקיינוס השקט	סיאול	asia-northeast3-contactcenterinsights.googleapis.com	asia-northeast3
אסיה ואזור האוקיינוס השקט	מומבאי	asia-south1-contactcenterinsights.googleapis.com	asia-south1
אסיה ואזור האוקיינוס השקט	סינגפור	asia-southeast1-contactcenterinsights.googleapis.com	asia-southeast1
אסיה ואזור האוקיינוס השקט	ג'קארטה	asia-southeast2-contactcenterinsights.googleapis.com	asia-southeast2
אסיה ואזור האוקיינוס השקט	סידני	australia-southeast1-contactcenterinsights.googleapis.com	australia-southeast1

הערה: יכול להיות שיהיה זמן אחזור ארוך יותר בשיחות לאזור global אם מתקשרים מחוץ לארה"ב. אם אפשר, בוחרים אזור ספציפי יותר שקרוב יותר לשירותים ולמשתמשי הקצה. מידע נוסף מופיע במאמרים בנושא אזורים ב-Google Cloud ומיקום גיאוגרפי ואזורים ב-Google Cloud.

הערה: מסיבות היסטוריות, ב-Customer Experience Insights נעשה שימוש במזהה מיקום המשאב us-central1 עבור נקודת הקצה הגלובלית, במקום global שמשמש בממשקי API חדשים יותר.

הערה: כדי להשתמש במופע האזורי, צריך לשנות גם את המארח של כתובת ה-URL וגם את מיקום המשאב. למשל, ‫us-east1-contactcenterinsights.googleapis.com וגם projects/project-id/location/*us-east1*/conversation/conversation-id.

פקודות לדוגמה

ההרשאות שנדרשות למשימה הזו

כדי לבצע את המשימה הזו נדרשות ההרשאות הבאות:

• contactcenterinsights.analyses.create

REST

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫LOCATION_ID: מיקום אזורי.
• ‫CONVERSATION_ID: המזהה של השיחה שרוצים לנתח. הערך הזה הוחזר בתגובה ל-createConversation.

ה-method של ה-HTTP וכתובת ה-URL:

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

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

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)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$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

אתם אמורים לקבל תגובת JSON שדומה לזו:

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

לקוח Python

כשמשתמשים בלקוח Python, צריך לעדכן את המיקום של המארח ושל המשאב כך שיצביעו על המופע האזורי.

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

כדי לקבוע את האזור שבו היומנים מאוחסנים, אפשר לעיין במסמכי העזרה של Cloud Logging.