Autorisierte Ansichten verwenden

Sie können autorisierte Ansichten verwenden, um Konversationsdaten abzurufen, Analysen durchzuführen oder Feedback-Labels zu bearbeiten. Autorisierte Ansichten können nicht verwendet werden, um Konversationsdaten zu bearbeiten oder zu importieren, Themenmodelle zu trainieren oder Kurzübersichten zu erstellen.

Wählen Sie eine autorisierte Ansicht aus, um auf den entsprechenden Datenbereich zuzugreifen. Für jede Ansicht kann ein anderer Bereich definiert werden. Es werden nur Daten angezeigt, die in der ausgewählten Ansicht zulässig sind.

Wählen Sie Keine Ansicht aus, um die zugewiesenen IAM-Berechtigungen (Identity and Access Management) zu verwenden. Dies ist der Standardstatus.

Erforderliche Berechtigungen und Rollen

Zum Verwenden autorisierter Ansichten benötigen Sie die folgenden IAM-Berechtigungen:

Berechtigungen für den Projektzugriff

Manager und Kundenservicemitarbeiter benötigen Lesezugriff auf das Projekt resourcemanager.projects.get, um mit der Konsole interagieren zu können.

Verwenden Sie roles/browser, um Managern und Kundenservicemitarbeitern eine grundlegende Zugriffsebene zu gewähren. Weitere Informationen finden Sie in der Dokumentation zur Zugriffssteuerung auf Projektebene.

Berechtigungen für autorisierte Ansichten

Gewähren Sie die folgenden Berechtigungen für bestimmte autorisierte Ansichten mit den SetIamPolicy-Methoden. Weitere Informationen finden Sie unter Autorisierte Ansichtsressourcen.

Autorisierte Ansichtsnutzer benötigen nur die Berechtigung contactcenterinsights.authorizedViews.get und die entsprechenden authorized-Berechtigungen für die Ressourcen, auf die sie zugreifen können.

Berechtigungen für autorisierte Unterhaltungen

Berechtigung Beschreibung
contactcenterinsights.authorizedConversations.get Mit einer autorisierten Ansicht eine Unterhaltung abrufen
contactcenterinsights.authorizedConversations.list Verwenden Sie eine autorisierte Ansicht, um Unterhaltungen aufzulisten.

Berechtigungen für autorisierte Vorgänge

Berechtigung Beschreibung
contactcenterinsights.authorizedOperations.get Verwenden Sie eine autorisierte Ansicht, um einen Vorgang abzurufen.
contactcenterinsights.authorizedOperations.list Verwenden Sie eine autorisierte Ansicht, um Vorgänge aufzulisten.

Vordefinierte Rollen

Die folgenden vordefinierten IAM-Rollen enthalten die erforderlichen Berechtigungen:

Rolle Beschreibung
roles/contactcenterinsights.authorizeEditor Bietet Lese-/Schreibzugriff auf alle autorisierten Customer Experience Insights-Ressourcen.
roles/contactcenterinsights.authorizedViewer Gewährt vollständigen Zugriff auf alle autorisierten Ressourcen von Customer Experience Insights.

In autorisierten Ansichten suchen

REST

Alle autorisierten Ansichten abrufen, auf die Sie Zugriff haben.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION: Der Speicherort Ihrer Customer Experience Insights-Daten.
  • AUTHORIZED_VIEW_SET_ID: Eine benutzerdefinierte Kennung für die autorisierte Ansichtsgruppe oder das Platzhalterzeichen „-“.
  • PAGE_SIZE: Die maximale Anzahl der Ansichten, die in der Antwort zurückgegeben werden sollen. Wenn der Wert null ist, wählt der Dienst eine Standardgröße aus. Bei einem Aufruf werden möglicherweise weniger Objekte als angefordert zurückgegeben. Ein nicht leeres `next_page_token` in der Antwort gibt an, dass weitere Daten verfügbar sind.
  • PAGE_TOKEN: Der von der letzten `SearchAuthorizedViewsResponse` zurückgegebene Wert. Dieser Wert gibt an, dass es sich um eine Fortsetzung eines vorherigen `SearchAuthorizedViews`-Aufrufs handelt und dass das System die nächste Datenseite zurückgeben soll.
  • FILTER: Der Filterausdruck zum Filtern der autorisierten Ansichten, die in der Antwort aufgeführt sind. Sie können nach den folgenden Feldern filtern: `authorized_view_id`, `display_name`, `conversation_filter`, `create_time` und `update_time`. Sie können beliebige und/oder-Ausdrücke verwenden. Sie können auch reguläre Ausdrücke für Stringfelder verwenden.
    • Beispiel: display_name = "My View"
    • Beispiel: conversation_filter =~ ".*agent-1.*"
    • Beispiel: create_time > "2022-01-01T00:00:00Z"
    • Beispiel: display_name =~ ".*View.*"
    • Beispiel: create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z"
  • ORDER_BY: Der „Order by“-Ausdruck, mit dem autorisierte Ansichten in der Antwort sortiert werden.
    • Beispiel: create_time
    • Beispiel: update_time desc

HTTP-Methode und 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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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"
}

Autorisierte Unterhaltung

Eine autorisierte Unterhaltung ist eine Unterhaltung, auf die über eine autorisierte Ansicht zugegriffen wird.

Eine vollständige Liste der unterstützten Methoden finden Sie in der Referenzdokumentation zu autorisierten Konversationsmethoden.

Autorisierte Unterhaltung abrufen

REST

Zum Abrufen einer autorisierten Unterhaltung ist die Berechtigung contactcenterinsights.authorizedConversations.get erforderlich.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION_ID: Der Standort Ihres Projekts
  • AUTHORIZED_VIEW_SET_ID: Die ID des autorisierten View-Sets.
  • AUTHORIZED_VIEW_ID: Die ID der autorisierten Ansicht.
  • CONVERSATION_ID: Die ID der Unterhaltung.

HTTP-Methode und 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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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"
      }
    ]
  }
}

Autorisierte Unterhaltungen auflisten

REST

Für das Auflisten autorisierter Unterhaltungen ist die Berechtigung contactcenterinsights.authorizedConversations.list erforderlich.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION_ID: Der Standort Ihres Projekts.
  • AUTHORIZED_VIEW_SET_ID: Die ID des autorisierten View-Sets.
  • AUTHORIZED_VIEW_ID: Die ID der autorisierten Ansicht.
  • PAGE_SIZE: Die Anzahl der Unterhaltungen, die pro Seite zurückgegeben werden sollen.

HTTP-Methode und 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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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"
}

Autorisierte Vorgänge

Eine vollständige Liste der unterstützten Methoden finden Sie in der Referenzdokumentation zu Methoden für autorisierte Vorgänge.

Autorisierten Vorgang abrufen

REST

Für einen autorisierten Vorgang ist die Berechtigung contactcenterinsights.authorizedOperations.get erforderlich.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION: Der Speicherort Ihrer Customer Experience Insights-Daten.
  • OPERATION_ID: Die ID der Unterhaltung, die Sie analysieren möchten. Dieser Wert wurde zurückgegeben, als Sie die Analyse erstellt haben.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

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

Autorisierte Vorgänge auflisten

REST

Zum Auflisten autorisierter Vorgänge ist die Berechtigung contactcenterinsights.authorizedOperations.list erforderlich.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • PROJECT_ID: Ihre Google Cloud Projekt-ID
  • LOCATION: Der Speicherort Ihrer Customer Experience Insights-Daten.
  • AUTHORIZED_VIEW_SET_ID: Die ID des autorisierten View-Sets.
  • AUTHORIZED_VIEW_ID: Die ID der autorisierten Ansicht.

HTTP-Methode und URL: 

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

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "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
    }
  ]
}

Nächste Schritte