‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שימוש בתצוגות מורשות

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

בוחרים תצוגה מפורטת מורשית כדי לגשת להיקף הנתונים הספציפי שהיא מספקת. כל תצוגה יכולה להגדיר היקף שונה. יוצגו רק נתונים שהגישה אליהם מותרת בתצוגה שנבחרה.

בוחרים באפשרות ללא תצוגה כדי להשתמש בהרשאות ניהול הזהויות והרשאות הגישה (IAM) שהוקצו לכם. זהו מצב ברירת המחדל.

הרשאות ותפקידים נדרשים

כדי להשתמש בתצוגות מורשות, אתם צריכים את הרשאות ה-IAM הבאות:

הרשאות לגישה לפרויקט

כדי שמנהלים וסוכנים יוכלו ליצור אינטראקציה עם המסוף, הם צריכים הרשאת צפייה בפרויקט resourcemanager.projects.get.

אפשר להשתמש בroles/browser כדי לתת למנהלים ולנציגים רמת גישה בסיסית. פרטים נוספים זמינים במאמרי העזרה בנושא בקרת גישה ברמת הפרויקט.

הרשאות צפייה מורשות

מעניקים את ההרשאות הבאות לתצוגות ספציפיות מורשות באמצעות שיטות SetIamPolicy. פרטים נוספים זמינים במאמר בנושא משאבים של תצוגה מורשית.

משתמשים מורשים בתצוגה מפורטת צריכים רק את ההרשאה contactcenterinsights.authorizedViews.get ואת ההרשאות התואמות authorized למשאבים שאליהם יש להם גישה.

הרשאות לשיחות מורשות

הרשאה	תיאור
`contactcenterinsights.authorizedConversations.get`	משתמשים בתצוגה מורשית כדי לקבל שיחה.
`contactcenterinsights.authorizedConversations.list`	משתמשים בתצוגה מורשית כדי להציג רשימה של שיחות.

הרשאות לפעולות מורשות

הרשאה	תיאור
`contactcenterinsights.authorizedOperations.get`	שימוש בתצוגה מורשית כדי לקבל פעולה.
`contactcenterinsights.authorizedOperations.list`	משתמשים בתצוגה מורשית כדי לרשום פעולות.

תפקידים מוגדרים מראש

תפקידי ה-IAM המוגדרים מראש הבאים מספקים את ההרשאות הנדרשות:

תפקיד	תיאור
`roles/contactcenterinsights.authorizeEditor`	מעניקה גישת קריאה/כתיבה לכל המשאבים המורשים של Customer Experience Insights.
`roles/contactcenterinsights.authorizedViewer`	גישה מלאה לכל המשאבים המורשים של Customer Experience Insights.

חיפוש תצוגות מורשות

REST

אחזור של כל התצוגות המפורטות שיש לכם גישה אליהן.

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION: המיקום של נתוני Customer Experience Insights.
‫AUTHORIZED_VIEW_SET_ID: מזהה שמוגדר על ידי המשתמש עבור קבוצת התצוגות המורשות או התו הכללי '-'.
‫PAGE_SIZE: המספר המקסימלי של התצוגות שיוחזרו בתגובה. אם הערך הוא אפס, השירות יבחר גודל ברירת מחדל. יכול להיות ששיחה תחזיר פחות אובייקטים מהמספר המבוקש. אם התשובה מכילה את הערך `next_page_token` שאינו ריק, סימן שיש עוד נתונים זמינים.
‫PAGE_TOKEN: הערך שמוחזר על ידי האחרון מבין `SearchAuthorizedViewsResponse`. הערך הזה מציין שמדובר בהמשך של קריאה קודמת של `SearchAuthorizedViews` ושהמערכת צריכה להחזיר את הדף הבא של הנתונים.
‫FILTER: ביטוי הסינון לסינון התצוגות המורשות שמופיעות בתגובה. אפשר לסנן לפי השדות הבאים: ‎`authorized_view_id`,‏ ‎`display_name`,‏ ‎`conversation_filter`,‏ ‎`create_time` ו-‎ `update_time`. אפשר להשתמש בביטויים שרירותיים או בביטויים. אפשר גם להשתמש בביטויים רגולריים בשדות מחרוזת.

לדוגמה: display_name = "My View"
לדוגמה: conversation_filter =~ ".*agent-1.*"
לדוגמה: create_time > "2022-01-01T00:00:00Z"
לדוגמה: display_name =~ ".*View.*"
לדוגמה: create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z"

‫ORDER_BY: ביטוי למיון התוצאות כדי למיין את התצוגות המורשות שמופיעות בתגובה.

לדוגמה: create_time
לדוגמה: update_time desc

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

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY

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

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

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY"

‎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 GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews:search?page_size=PAGE_SIZE&page_token=PAGE_TOKEN&filter=FILTER&order_by=ORDER_BY" | Select-Object -Expand Content

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

{
  "authorizedViews": [
    {
      "name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-1",
      "displayName": "My First View",
      "conversationFilter": "agent_id = \"agent-1\"",
      "createTime": "2022-01-01T00:00:00.000000Z",
      "updateTime": "2022-01-01T00:00:00.000000Z"
    },
    {
      "name": "projects/my-project/locations/us-central1/authorizedViewSets/my-view-set/authorizedViews/my-view-2",
      "displayName": "My Second View",
      "conversationFilter": "agent_id = \"agent-2\"",
      "createTime": "2022-01-01T00:00:00.000000Z",
      "updateTime": "2022-01-01T00:00:00.000000Z"
    }
  ],
  "nextPageToken": "next-page-token"
}

שיחה מורשית

שיחה מורשית היא שיחה שאפשר לגשת אליה באמצעות תצוגה מורשית.

רשימה מלאה של השיטות הנתמכות זמינה במאמרי העזרה בנושא שיטות לשיחות מאומתות.

קבלת שיחה מאומתת

REST

כדי לקבל שיחה מאושרת, צריך את ההרשאה contactcenterinsights.authorizedConversations.get.

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION_ID: המיקום של הפרויקט
‫AUTHORIZED_VIEW_SET_ID: המזהה של קבוצת התצוגות המורשית.
‫AUTHORIZED_VIEW_ID: המזהה של התצוגה המורשית.
‫CONVERSATION_ID: מזהה השיחה.

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

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID

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

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID"

‎PowerShell (Windows)

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

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

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

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/CONVERSATION_ID",
  "createTime": "2025-03-03T11:23:17.823813113Z",
  "updateTime": "2025-03-03T11:23:17.987216Z",
  "agentId": "AGENT_ID",
  "callMetadata": {
    "customerChannel": 1,
    "agentChannel": 2
  },
  "medium": "CHAT",
  "duration": "0s",
  "turnCount": 2,
  "languageCode": "en",
  "startTime": "2025-03-03T11:23:16.903361174Z",
  "qualityMetadata": {
    "agentInfo": [
      {
        "agentId": "AGENT_ID",
        "agentType": "HUMAN_AGENT"
      }
    ]
  }
}

רשימת שיחות מורשות

REST

כדי להציג רשימה של שיחות מורשות צריך את ההרשאה contactcenterinsights.authorizedConversations.list.

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION_ID: המיקום של הפרויקט.
‫AUTHORIZED_VIEW_SET_ID: המזהה של קבוצת התצוגות המורשית.
‫AUTHORIZED_VIEW_ID: המזהה של התצוגה המורשית.
‫PAGE_SIZE: מספר השיחות שיוחזרו בכל דף.

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

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE

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

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE"

‎PowerShell (Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations?pageSize=PAGE_SIZE" | Select-Object -Expand Content

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

{
  "conversations": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/4315d72e3d-c75-94d-2d5-1ae05b4222352",
      "createTime": "2025-03-03T11:23:17.823813113Z",
      "updateTime": "2025-03-03T11:23:17.987216Z",
      "agentId": "AGENT_ID",
      "callMetadata": {
        "customerChannel": 1,
        "agentChannel": 2
      },
      "medium": "CHAT",
      "duration": "0s",
      "turnCount": 2,
      "languageCode": "en",
      "startTime": "2025-03-03T11:23:16.903361174Z",
      "qualityMetadata": {
        "agentInfo": [
          {
            "agentId": "AGENT_ID",
            "agentType": "AUTOMATED_AGENT"
          }
        ]
      }
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/conversations/8d3b61-bd4-f2c-364-b5a794f76",
      "createTime": "2025-03-03T11:19:58.605217527Z",
      "updateTime": "2025-03-03T11:19:58.901962Z",
      "agentId": "AGENT_ID",
      "callMetadata": {
        "customerChannel": 1,
        "agentChannel": 2
      },
      "medium": "CHAT",
      "duration": "0s",
      "turnCount": 2,
      "runtimeAnnotations": [
        {
          "createTime": "2025-03-03T11:19:56.164686195Z",
          "startBoundary": {
            "transcriptIndex": 1
          },
          "endBoundary": {
            "transcriptIndex": 2
          },
          "answerFeedback": {},
         
        }
      ],
      "languageCode": "en",
      "startTime": "2025-03-03T11:19:56.164686195Z",
      "qualityMetadata": {
        "agentInfo": [
          {
            "agentId": "AGENT_ID",
            "agentType": "HUMAN_AGENT"
          }
        ]
      }
    }
  ],
  "nextPageToken": "NEXT_PAGE_TOKEN"
}

פעולות מורשות

רשימה מלאה של השיטות הנתמכות מופיעה במאמרי העזרה בנושא שיטות של פעולות מורשות.

קבלת פעולה מורשית

REST

כדי לבצע פעולה מורשית, צריך את ההרשאה contactcenterinsights.authorizedOperations.get.

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION: המיקום של נתוני Customer Experience Insights.
‫OPERATION_ID: המזהה של השיחה שרוצים לנתח. הערך הזה הוחזר כשיוצרים את הניתוח.

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

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID

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

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID"

‎PowerShell (Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
  },
  "done": true
}

הצגת רשימה של פעולות מורשות

REST

כדי להציג רשימה של פעולות מורשות צריך את ההרשאה contactcenterinsights.authorizedOperations.list.

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

‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
‫LOCATION: המיקום של נתוני Customer Experience Insights.
‫AUTHORIZED_VIEW_SET_ID: המזהה של קבוצת התצוגות המורשית.
‫AUTHORIZED_VIEW_ID: המזהה של התצוגה המורשית.

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

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/

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

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

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

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/"

‎PowerShell (Windows)

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

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

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/" | Select-Object -Expand Content

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

{
  "operations": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
      },
      "done": true
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/OPERATION_ID_2",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
      },
      "done": true
    }
  ]
}

מה השלב הבא?

שיטות מומלצות לשימוש בתצוגות מורשות

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

הרשאות ותפקידים נדרשים

הרשאות לגישה לפרויקט

הרשאות צפייה מורשות

הרשאות לשיחות מורשות

הרשאות לפעולות מורשות

תפקידים מוגדרים מראש

חיפוש תצוגות מורשות

REST

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

‎PowerShell (Windows)

שיחה מורשית

קבלת שיחה מאומתת

REST

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

‎PowerShell (Windows)

רשימת שיחות מורשות

REST

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

‎PowerShell (Windows)

פעולות מורשות

קבלת פעולה מורשית

REST

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

‎PowerShell (Windows)

הצגת רשימה של פעולות מורשות

REST

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

‎PowerShell (Windows)

מה השלב הבא?

שימוש בתצוגות מורשות