Vous pouvez utiliser des vues autorisées pour récupérer des données de conversation, effectuer des analyses ou modifier des libellés de commentaires. Vous ne pouvez pas utiliser les vues autorisées pour modifier ou importer des données de conversation, entraîner des modèles thématiques ni créer des tableaux de données.
Sélectionnez une vue autorisée pour accéder au champ de données spécifique qu'elle fournit. Chaque vue peut définir un champ d'application différent. Vous ne verrez que les données autorisées dans la vue sélectionnée.
Sélectionnez Aucune vue pour utiliser les autorisations IAM (Identity and Access Management) qui vous ont été attribuées. Il s'agit de l'état par défaut.
Autorisations et rôles requis
Pour utiliser des vues autorisées, vous avez besoin des autorisations IAM suivantes :
Autorisations d'accès aux projets
Les responsables et les agents doivent disposer d'un accès en lecture au projet resourcemanager.projects.get pour interagir avec la console.
Utilisez roles/browser pour accorder aux responsables et aux agents un niveau d'accès de base. Pour en savoir plus, consultez la documentation sur le contrôle des accès au niveau du projet.
Autorisations pour les vues autorisées
Accordez les autorisations suivantes sur des vues autorisées spécifiques avec les méthodes SetIamPolicy. Pour en savoir plus, consultez les ressources de vues autorisées.
Les utilisateurs de vues autorisées n'ont besoin que de l'autorisation contactcenterinsights.authorizedViews.get et des autorisations authorized correspondantes pour les ressources auxquelles ils peuvent accéder.
Autorisations pour les conversations autorisées
| Autorisation | Description |
|---|---|
contactcenterinsights.authorizedConversations.get |
Utilisez une vue autorisée pour obtenir une conversation. |
contactcenterinsights.authorizedConversations.list |
Utilisez une vue autorisée pour lister les conversations. |
Autorisations pour les opérations autorisées
| Autorisation | Description |
|---|---|
contactcenterinsights.authorizedOperations.get |
Utilisez une vue autorisée pour obtenir une opération. |
contactcenterinsights.authorizedOperations.list |
Utilisez une vue autorisée pour lister les opérations. |
Rôles prédéfinis
Les rôles IAM prédéfinis suivants fournissent les autorisations nécessaires :
| Rôle | Description |
|---|---|
roles/contactcenterinsights.authorizeEditor |
Accorde un accès en lecture/écriture à toutes les ressources autorisées Customer Experience Insights. |
roles/contactcenterinsights.authorizedViewer |
Accorde un accès complet à toutes les ressources autorisées Customer Experience Insights. |
Rechercher vos vues autorisées
REST
Récupérez toutes les vues autorisées auxquelles vous avez accès.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud .
- LOCATION : emplacement de vos données Insights sur l'expérience client.
- AUTHORIZED_VIEW_SET_ID : identifiant défini par l'utilisateur pour l'ensemble de vues autorisées ou caractère générique "-".
- PAGE_SIZE : nombre maximal de vues à renvoyer dans la réponse. Si la valeur est zéro, le service sélectionne une taille par défaut. Un appel peut renvoyer moins d'objets que demandé. Un `next_page_token` non vide dans la réponse indique que d'autres données sont disponibles.
- PAGE_TOKEN : valeur renvoyée par la dernière réponse "SearchAuthorizedViewsResponse". Cette valeur indique qu'il s'agit d'une continuation d'un appel "SearchAuthorizedViews" précédent et que le système doit renvoyer la page de données suivante.
- FILTER : expression de filtre permettant de filtrer les vues autorisées listées dans la réponse. Vous pouvez filtrer les résultats en fonction des champs suivants : "authorized_view_id", "display_name", "conversation_filter", "create_time" et "update_time". Vous pouvez utiliser des expressions et/ou des valeurs arbitraires. Vous pouvez également utiliser des expressions régulières pour les champs de chaîne.
- Exemple :
display_name = "My View" - Exemple :
conversation_filter =~ ".*agent-1.*" - Exemple :
create_time > "2022-01-01T00:00:00Z" - Exemple :
display_name =~ ".*View.*" - Exemple :
create_time > "2022-01-01T00:00:00Z" AND create_time <= "2022-01-02T00:00:00Z" - ORDER_BY : expression "order by" permettant de trier les vues autorisées listées dans la réponse.
- Exemple :
create_time - Exemple :
update_time desc
Méthode HTTP et 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
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{
"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"
}
Conversation autorisée
Une conversation autorisée est une conversation à laquelle vous accédez à l'aide d'une vue autorisée.
Pour obtenir la liste complète des méthodes compatibles, consultez la documentation de référence sur les méthodes de conversation autorisées.
Obtenir une conversation autorisée
REST
L'autorisation contactcenterinsights.authorizedConversations.get est requise pour obtenir une conversation autorisée.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud .
- LOCATION_ID : emplacement de votre projet
- AUTHORIZED_VIEW_SET_ID : ID de l'ensemble de vues autorisées.
- AUTHORIZED_VIEW_ID : ID de la vue autorisée.
- CONVERSATION_ID : ID de la conversation.
Méthode HTTP et 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
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{
"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"
}
]
}
}
Lister les conversations autorisées
REST
L'autorisation contactcenterinsights.authorizedConversations.list est requise pour lister les conversations autorisées.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud .
- LOCATION_ID : emplacement de votre projet.
- AUTHORIZED_VIEW_SET_ID : ID de l'ensemble de vues autorisées.
- AUTHORIZED_VIEW_ID : ID de la vue autorisée.
- PAGE_SIZE : nombre de conversations à renvoyer par page.
Méthode HTTP et 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
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{
"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"
}
Opérations autorisées
Pour obtenir la liste complète des méthodes compatibles, consultez la documentation de référence sur les méthodes d'opérations autorisées.
Obtenir une opération autorisée
REST
L'obtention d'une opération autorisée nécessite l'autorisation contactcenterinsights.authorizedOperations.get.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud .
- LOCATION : emplacement de vos données Insights sur l'expérience client.
- OPERATION_ID : ID de la conversation que vous souhaitez analyser. Cette valeur a été renvoyée lorsque vous avez créé l'analyse.
Méthode HTTP et URL :
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{
"name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.contactcenterinsights.v1.QueryMetricsMetadata"
},
"done": true
}
Lister les opérations autorisées
REST
Pour lister les opérations autorisées, vous devez disposer de l'autorisation contactcenterinsights.authorizedOperations.list.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud .
- LOCATION : emplacement de vos données Insights sur l'expérience client.
- AUTHORIZED_VIEW_SET_ID : ID de l'ensemble de vues autorisées.
- AUTHORIZED_VIEW_ID : ID de la vue autorisée.
Méthode HTTP et URL :
GET https://contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/authorizedViewSets/AUTHORIZED_VIEW_SET_ID/authorizedViews/AUTHORIZED_VIEW_ID/operations/
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{
"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
}
]
}