Autorisierte Ansichten erstellen und verwalten

Sie können die folgenden administrativen Vorgänge für autorisierte Ansichten und autorisierte Ansichtsgruppen ausführen.

Erforderliche Berechtigungen und Rollen

Zum Erstellen und Verwalten von autorisierten Ansichtsgruppen und autorisierten Ansichten benötigen Sie die folgenden IAM-Berechtigungen.

Autorisierte Ansichtssätze:

Berechtigung Beschreibung
contactcenterinsights.authorizedViewSet.create Erstellen Sie einen Satz autorisierter Ansichten.
contactcenterinsights.authorizedViewSet.get Details zu einer Gruppe autorisierter Ansichten abrufen.
contactcenterinsights.authorizedViewSet.update Vorhandenes autorisiertes Ansicht-Set aktualisieren
contactcenterinsights.authorizedViewSet.delete Löschen Sie ein Set autorisierter Ansichten.
contactcenterinsights.authorizedViewSet.list Autorisierte Ansichtsgruppen in einem Projekt auflisten.

Autorisierte Ansichten:

Berechtigung Beschreibung
contactcenterinsights.authorizedView.create Erstellen Sie eine autorisierte Ansicht.
contactcenterinsights.authorizedView.get Details zu einer autorisierten Ansicht abrufen.
contactcenterinsights.authorizedView.update Vorhandene autorisierte Ansicht aktualisieren
contactcenterinsights.authorizedView.delete Löschen Sie eine autorisierte Ansicht.

Zum Gewähren des Zugriffs auf autorisierte Ansichten benötigen Sie die folgenden Berechtigungen:

Berechtigung Beschreibung
contactcenterinsights.authorizedView.setIamPolicy IAM-Richtlinie für eine autorisierte Ansicht festlegen
contactcenterinsights.authorizedView.getIamPolicy IAM-Richtlinie für eine autorisierte Ansicht abrufen

Vordefinierte Rollen

Die folgenden vordefinierten IAM-Rollen enthalten die erforderlichen Berechtigungen:

Rolle Beschreibung
roles/contactcenterinsights.editor Bietet Lese- und Schreibzugriff auf alle Customer Experience Insights-Ressourcen.
roles/contactcenterinsights.admin Bietet Lese- und Schreibzugriff auf alle Customer Experience Insights-Ressourcen.

Sets autorisierter Ansichten

Mit autorisierten Ansichtsgruppen können Sie Berechtigungen für mehrere autorisierte Ansichten gruppieren und vereinfachen.

Satz autorisierter Ansichten erstellen

REST

Zum Erstellen einer Gruppe autorisierter Ansichten benötigen Sie die Berechtigung contactcenterinsights.authorizedViewSet.create.

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 optionale, benutzerdefinierte Kennung für die zu erstellende autorisierte Ansicht. Dieser Wert muss 1–63 Zeichen lang sein, mit [a–z0–9] beginnen und enden und darf Bindestriche (-) zwischen den Zeichen enthalten.
  • DISPLAY_NAME: Ein aussagekräftiger Name für die autorisierte Ansichtsgruppe.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?authorized_view_set_id=AUTHORIZED_VIEW_SET_ID

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME"
}

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/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
  "displayName": "DISPLAY_NAME",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Autorisierte Ansichtsgruppe lesen

REST

Zum Lesen eines autorisierten Ansichtssatzes ist die Berechtigung contactcenterinsights.authorizedViewSet.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.
  • AUTHORIZED_VIEW_SET_ID: Die Kennung für die autorisierte Ansichtsgruppe.

HTTP-Methode und URL: 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_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/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
  "displayName": "DISPLAY_NAME",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Autorisierte Ansichtsgruppe aktualisieren

REST

Zum Aktualisieren einer Gruppe autorisierter Ansichten ist die Berechtigung contactcenterinsights.authorizedViewSet.update 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 Kennung für die autorisierte Ansichtsgruppe.
  • DISPLAY_NAME: Ein aussagekräftiger Name für die autorisierte Ansichtsgruppe.
  • UPDATE_MASK: Die zu aktualisierenden Felder. Dieser Wert ist eine durch Kommas getrennte Liste von Feldern.
    • display_name

HTTP-Methode und URL: 

PATCH https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID?update_mask=display_name

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME"
}

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/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
  "displayName": "DISPLAY_NAME",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Autorisiertes Ansicht-Set löschen

REST

Zum Löschen einer Gruppe autorisierter Ansichten ist die Berechtigung contactcenterinsights.authorizedViewSet.delete 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 Kennung für die autorisierte Ansichtsgruppe.

HTTP-Methode und URL: 

DELETE https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID

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

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

{}

Autorisierte Ansichtsgruppen auflisten

REST

Für das Auflisten von autorisierten Ansichtsgruppen ist die Berechtigung contactcenterinsights.authorizedViewSet.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.
  • PAGE_SIZE: Die maximale Anzahl der autorisierten Ansichtssätze, 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 `ListAuthorizedViewSetsResponse` zurückgegebene Wert. Dieser Wert gibt an, dass es sich um eine Fortsetzung eines vorherigen `ListAuthorizedViewSets`-Aufrufs handelt und dass das System die nächste Datenseite zurückgeben soll.
  • FILTER: Ein Ausdruck zum Filtern autorisierter Ansichtsgruppen. Beispiel:
    • create_time > "2022-01-01T00:00:00Z"
    • update_time < "2022-01-02T00:00:00Z"
    • display_name = "My Authorized View Set"
    • display_name =~ "My.*"
    • create_time > "2022-01-01T00:00:00Z" AND display_name = "My Authorized View Set"
    • create_time > "2022-01-01T00:00:00Z" OR display_name = "My Authorized View Set"
  • ORDER_BY: Ein Ausdruck, mit dem die in der Antwort aufgeführten autorisierten Ansichtssätze sortiert werden. Beispiel:
    • create_time
    • create_time desc
    • update_time
    • update_time desc
    • display_name
    • display_name desc

HTTP-Methode und URL:

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?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:

{
  "authorizedViewSets": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID",
      "displayName": "My Authorized View Set",
      "createTime": "2022-01-01T00:00:00.000000Z",
      "updateTime": "2022-01-01T00:00:00.000000Z"
    },
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID_2",
      "displayName": "Another Authorized View Set",
      "createTime": "2022-01-02T00:00:00.000000Z",
      "updateTime": "2022-01-02T00:00:00.000000Z"
    },
  ],
  "nextPageToken": "NEXT_PAGE_TOKEN"
}

Autorisierte Ansichten

In autorisierten Ansichten wird eine begrenzte Anzahl von Unterhaltungen und die Rolle eines Kundenservicemitarbeiters oder Managers für diese Unterhaltungen definiert.

Autorisierte Ansicht erstellen

REST

Zum Erstellen einer autorisierten Ansicht ist die Berechtigung contactcenterinsights.authorizedView.create 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 Kennung für die autorisierte Ansichtsgruppe, zu der diese autorisierte Ansicht gehört.
  • AUTHORIZED_VIEW_ID: Eine optionale benutzerdefinierte Kennung für die zu erstellende autorisierte Ansicht. Dieser Wert muss 1–63 Zeichen lang sein, mit [a–z0–9] beginnen und enden und darf Bindestriche (-) zwischen den Zeichen enthalten.
  • DISPLAY_NAME: Ein aussagekräftiger Name für die autorisierte Ansichtsgruppe.
  • CONVERSATION_FILTER: Der Filter, der auf die Daten angewendet werden soll. Sie können die folgenden Felder verwenden: `agent_id`.
    • agent_id = "agent_123"
    • agent_id = "agent_123" OR agent_id = "agent_456"
    • quality_metadata.agent_info.agent_id: "agent_456"
    • quality_metadata.agent_info.teams: "team_123"

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews?authorized_view_id=AUTHORIZED_VIEW_ID

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME",
  "conversation_filter": "CONVERSATION_FILTER"
}

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/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID",
  "displayName": "DISPLAY_NAME",
  "conversationFilter": "CONVERSATION_FILTER",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Autorisierte Ansicht lesen

REST

Zum Lesen einer autorisierten Ansicht ist die Berechtigung contactcenterinsights.authorizedView.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.
  • AUTHORIZED_VIEW_SET_ID: Die Kennung für die autorisierte Ansichtsgruppe.
  • AUTHORIZED_VIEW_ID: Die Kennung für die autorisierte Ansicht.

HTTP-Methode und URL: 

GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_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/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID",
  "displayName": "DISPLAY_NAME",
  "conversationFilter": "CONVERSATION_FILTER",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Autorisierte Ansicht aktualisieren

REST

Zum Aktualisieren einer autorisierten Ansicht ist die Berechtigung contactcenterinsights.authorizedView.update 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 Kennung für die autorisierte Ansichtsgruppe, zu der diese autorisierte Ansicht gehört.
  • AUTHORIZED_VIEW_ID: Die Kennung der autorisierten Ansicht, die aktualisiert werden soll.
  • DISPLAY_NAME: Ein aussagekräftiger Name für die autorisierte Ansichtsgruppe.
  • CONVERSATION_FILTER: Der Filter, der auf die Daten angewendet werden soll. Sie können die folgenden Felder verwenden: `agent_id`.
    • agent_id = "agent_123"
    • agent_id = "agent_123" OR agent_id = "agent_456"
    • quality_metadata.agent_info.agent_id: "agent_456"
    • quality_metadata.agent_info.teams: "team_123"
  • UPDATE_MASK: Die zu aktualisierenden Felder. Dieser Wert ist eine durch Kommas getrennte Liste von Feldern.
    • display_name
    • conversation_filter

HTTP-Methode und URL: 

PATCH https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID?update_mask=display_name,conversation_filter

JSON-Text anfordern:

{
  "displayName": "DISPLAY_NAME",
  "conversation_filter": "CONVERSATION_FILTER"
}

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/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID",
  "displayName": "DISPLAY_NAME",
  "conversationFilter": "CONVERSATION_FILTER",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Autorisierte Ansicht löschen

REST

Zum Löschen einer autorisierten Ansicht ist die Berechtigung contactcenterinsights.authorizedView.delete 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 Kennung für die autorisierte Ansichtsgruppe.
  • AUTHORIZED_VIEW_ID: Die Kennung für die autorisierte Ansicht.

HTTP-Methode und URL: 

DELETE https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID

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

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

{}

Autorisierte Ansichten auflisten

REST

Für das Auflisten von autorisierten Ansichtsgruppen ist die Berechtigung contactcenterinsights.authorizedViews.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: Eine benutzerdefinierte Kennung für die autorisierte Ansichtsgruppe.
  • 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 `ListAuthorizedViewsResponse` zurückgegebene Wert. Gibt an, dass es sich um eine Fortsetzung eines vorherigen `ListAuthorizedViews`-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?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"
}

IAM-Richtlinie für eine autorisierte Ansicht festlegen

REST

Zum Festlegen der IAM-Richtlinie für eine autorisierte Ansicht ist die Berechtigung contactcenterinsights.authorizedView.setIamPolicy 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 Kennung für die autorisierte Ansichtsgruppe.
  • AUTHORIZED_VIEW_ID: Die Kennung für die autorisierte Ansicht.
  • PRINCIPAL: Das Hauptkonto (Nutzer), dem Sie Zugriff gewähren möchten.
  • ROLE: Die Rolle, die dem Nutzer zugewiesen werden soll.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID:setIamPolicy

JSON-Text anfordern:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/ROLE",
        "members": [
          "PRINCIPAL"
        ]
      }
    ]
  }
}

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

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

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/ROLE",
      "members": [
        "PRINCIPAL"
      ]
    }
  ]
}

IAM-Richtlinie für eine autorisierte Ansicht lesen

REST

Zum Lesen der IAM-Richtlinie für eine autorisierte Ansicht ist die Berechtigung contactcenterinsights.authorizedView.getIamPolicy 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 Kennung für die autorisierte Ansichtsgruppe.
  • AUTHORIZED_VIEW_ID: Die Kennung für die autorisierte Ansicht.

HTTP-Methode und URL: 

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

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

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

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/ROLE",
      "members": [
        "PRINCIPAL"
      ]
    }
  ]
}

Beispiel für die Einrichtung einer Organisation

In diesem Beispiel wird gezeigt, wie Sie autorisierte Ansichten für eine vereinfachte Organisation einrichten. In diesem Beispiel wird die REST API verwendet, um Ressourcen in einem fiktiven Projekt namens acme-corp zu erstellen und zu verwalten.

Acme hat die folgende Struktur:

  • Alice:Alice ist die Administratorin des Projekts.
    • Bob:Bob ist der Manager.
    • Carol:Carol ist ein Agent.
    • Dave:Dave ist ein Kundenservicemitarbeiter.

Jeder Nutzer hat eine Hauptkonto-ID, die mit seiner E-Mail-Adresse verknüpft ist.

  • Die von Alice ist user:admin.alice@acme.com.
  • Die von Bob ist user:manager.bob@acme.com.
  • Die von Carol ist user:agent.carol@acme.com.
  • Daves ist user:agent.dave@acme.com.

Jeder Agent hat eine agent_id, die dem Feld Conversation.agent_id für seine Unterhaltungen entspricht.

  • Die von Carol ist agent-carol.
  • Daves ist agent-dave.

Voraussetzungen

Jeder Nutzer benötigt die folgenden Zugriffsebenen:

  • Administratorzugriff:Als Administrator hat Alice vollen Zugriff auf alle Daten und Ressourcen.
  • Managerzugriff:Als Manager kann Bob Unterhaltungen und Analysen für seine jeweiligen Teams erstellen, bearbeiten und ansehen.
  • Agentenzugriff:Als Kundenservicemitarbeiter können Carol und Dave nur Unterhaltungen und Analysen sehen, an denen sie beteiligt waren.

Schritt 1: Projektzugriff gewähren

Fügen Sie alle Nutzer dem Projekt hinzu und gewähren Sie ihnen roles/browser. Mit dieser Rolle können sie das Projekt und seine Ressourcen ansehen.

Nutzern die Rolle „Projektbetrachter“ zuweisen

Der folgende Code veranschaulicht, wie Sie jedem Mitglied von Acme die Browserrolle zuweisen können.

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:admin.alice@acme.com" \
    --role="roles/browser"

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:manager.bob@acme.com" \
    --role="roles/browser"

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:agent.carol@acme.com" \
    --role="roles/browser"

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:agent.dave@acme.com" \
    --role="roles/browser"

Weitere Informationen finden Sie unter Einzelne Rolle zuweisen.

Sie können auch Google Groups verwenden, um den Zugriff auf Ihr Projekt zu verwalten. Anstatt einzelnen Nutzern Berechtigungen zu erteilen, können Sie einer Gruppe roles/browser gewähren. Sie könnten beispielsweise eine Gruppe mit dem Namen project-browsers@acme.com erstellen und Bob dieser Gruppe hinzufügen. Anschließend können Sie dieser Gruppe die Rolle roles/browser zuweisen. Weitere Informationen finden Sie unter Google Groups.

Schritt 2: Administrator Berechtigungen auf Projektebene erteilen

Gewähren Sie Ihrem Administrator roles/contactcenterinsights.admin auf Projektebene. Alice ist beispielsweise Administratorin bei Acme und erhält mit dieser Rolle vollständigen Zugriff auf alle Ressourcen.

Administratorrolle zuweisen

Der folgende Code zeigt, wie Sie Alice die Rolle „Administrator“ zuweisen können:

gcloud projects add-iam-policy-binding acme-corp \
    --member="user:admin.alice@acme.com" \
    --role="roles/contactcenterinsights.admin"

Schritt 3: Autorisierte Ansichtsgruppen erstellen

Erstellen Sie zwei autorisierte Ansichtsgruppen, um die autorisierten Ansichten für Manager und Kundenservicemitarbeiter zu gruppieren.

Autorisierte Ansicht für Bearbeiter erstellen

REST

In diesem Beispiel wird ein Satz autorisierter Ansichten mit dem Namen editor-view-set erstellt, um Ansichten mit Administratorberechtigungen zu gruppieren.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?authorized_view_set_id=editor-view-set

JSON-Text anfordern:

{
  "displayName": "Editor View Set"
}

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/authorizedViewSets/editor-view-set",
  "displayName": "Editor View Set",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Eine vom Betrachter autorisierte Ansicht erstellen

REST

In diesem Beispiel wird ein autorisierter Ansichtssatz mit dem Namen viewer-view-set erstellt, um Ansichten mit Agentenberechtigungen zu gruppieren.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets?authorized_view_set_id=viewer-view-set

JSON-Text anfordern:

{
  "displayName": "Viewer View Set"
}

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/authorizedViewSets/viewer-view-set",
  "displayName": "Viewer View Set",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z"
}

Schritt 4: Berechtigungen auf Projektebene für autorisierte Ansichtsgruppen erteilen

Autorisierte Ansichten sind Ressourcen mit integrierten Identitäten und erfordern Berechtigungen für den Zugriff auf {product_name}-Daten. Damit autorisierte Ansichten auf Unterhaltungen und Vorgänge zugreifen können, weisen Sie ihnen die folgenden Rollen zu:

  • roles/contactcenterinsights.editor für alle autorisierten Ansichten in der editor-view-set
  • roles/contactcenterinsights.viewer für alle autorisierten Ansichten in der viewer-view-set

Weitere Informationen finden Sie unter Rolle zuweisen oder widerrufen.

Weisen Sie editor-view-set die Rolle „Bearbeiter“ zu.

In diesem Beispiel wird roles/contactcenterinsights.editor für editor-view-set gewährt.

gcloud

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="principalSet://contactcenterinsights.googleapis.com/projects/PROJECT_NUMBER/type/AuthorizedView/ancestor.name/authorizedViewSets/editor-view-set" \
    --role="roles/contactcenterinsights.editor"

Weisen Sie viewer-view-set die Rolle „Betrachter“ zu:

In diesem Beispiel wird die Rolle roles/contactcenterinsights.viewer der autorisierten Ansichtsgruppe viewer-view-set zugewiesen.

gcloud

gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="principalSet://contactcenterinsights.googleapis.com/projects/PROJECT_NUMBER/type/AuthorizedView/ancestor.name/authorizedViewSets/viewer-view-set" \
    --role="roles/contactcenterinsights.viewer"

Schritt 5: Autorisierte Ansichten erstellen

Erstellen Sie für jeden Manager und Agenten eine autorisierte Ansicht und wenden Sie die entsprechenden Filter an.

Autorisierte Ansicht für Manager erstellen

REST

In diesem Beispiel wird eine autorisierte Ansicht mit der ID bobs-editor-view erstellt, in der Unterhaltungen zu agent_id = carol OR agent_id = dave gefiltert werden.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViews?authorized_view_id=bobsEditorView

JSON-Text anfordern:

{
  "displayName": "Bob's Editor View",
  "value": {
    "filter": "agent_id = \"agent-carol\" OR agent_id = \"agent-dave\""
  }
}

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/authorizedViews/bobs-editor-view",
  "displayName": "Bob's Editor View",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z",
  "conversationFilter":"agent_id = \"agent-carol\" OR agent_id = \"agent-dave\""
}

Rolle „Autorisierter Bearbeiter“ einem Manager zuweisen

REST

In diesem Beispiel wird roles/contactcenterinsights.authorizedEditor dem Acme-Manager Bob für bobs-editor-view gewährt.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/editor-view-set/authorizedViews/bobs-editor-view:setIamPolicy

JSON-Text anfordern:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/contactcenterinsights.editor",
        "members": [
          "user:manager.bob@acme.com"
        ]
      }
    ]
  }
}

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

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

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/contactcenterinsights.editor",
      "members": [
        "user:manager.bob@acme.com"
      ]
    }
  ]
}

Autorisierte Ansicht für einen Vertreter erstellen

REST

In diesem Beispiel wird eine autorisierte Ansicht für die Acme-Kundenservicemitarbeiterin Carol erstellt. Diese autorisierte Ansicht hat die ID carols-viewer-view und filtert Unterhaltungen nach agent_id = agent-carol.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViews?authorized_view_id=carols-viewer-view

JSON-Text anfordern:

{
  "displayName": "Carol's Viewer View",
  "value": {
    "filter": "agent_id = \"agent-carol\""
  }
}

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/authorizedViews/carols-viewer-view",
  "displayName": "Carol's Viewer View",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z",
  "conversationFilter": "agent_id = \"agent-carol\""
}

Einem Agent die Rolle „Autorisierter Betrachter“ zuweisen

REST

In diesem Beispiel wird Carol auf carols-viewer-view die Berechtigung roles/contactcenterinsights.authorizedViewer gewährt.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/viewer-view-set/authorizedViews/carols-viewer-view:setIamPolicy

JSON-Text anfordern:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/contactcenterinsights.viewer",
        "members": [
          "user:agent.carol@acme.com"
        ]
      }
    ]
  }
}

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

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

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/contactcenterinsights.viewer",
      "members": [
        "user:agent.carol@acme.com"
      ]
    }
  ]
}

Weitere autorisierte Ansicht für einen Kundenservicemitarbeiter erstellen

REST

In diesem Beispiel wird eine autorisierte Ansicht für den Acme-Kundenservicemitarbeiter Dave erstellt. Diese autorisierte Ansicht hat die ID daves-viewer-view und filtert Unterhaltungen nach agent_id = agent-dave.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViews?authorized_view_id=daves-viewer-view

JSON-Text anfordern:

{
  "displayName": "Dave's Viewer View",
  "value": {
    "filter": "agent_id = \"agent-dave\""
  }
}

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/authorizedViews/daves-viewer-view",
  "displayName": "Dave's Viewer View",
  "createTime": "2022-01-01T00:00:00.000000Z",
  "updateTime": "2022-01-01T00:00:00.000000Z",
  "conversationFilter": "agent_id = \"agent-dave\""
}

Einem anderen Kundenservicemitarbeiter die Rolle „Authorized Viewer“ zuweisen

REST

In diesem Beispiel wird Dave auf daves-viewer-view die Berechtigung roles/contactcenterinsights.authorizedViewer gewährt.

HTTP-Methode und URL: 

POST https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/authorizedViewSets/viewer-view-set/authorizedViews/daves-viewer-view:setIamPolicy

JSON-Text anfordern:

{
  "policy": {
    "bindings": [
      {
        "role": "roles/contactcenterinsights.viewer",
        "members": [
          "user:agent.dave@acme.com"
        ]
      }
    ]
  }
}

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

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

{
  "version": 1,
  "etag": "BwW...",
  "bindings": [
    {
      "role": "roles/contactcenterinsights.viewer",
      "members": [
        "user:agent.dave@acme.com"
      ]
    }
  ]
}

Nächste Schritte