samples: create conversation, create analysis, export data to BigQuery

samples/snippets/create_analysis.py

@@ -0,0 +1,33 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# [START contactcenterinsights_create_analysis]
+from google.cloud import contact_center_insights_v1
+
+
+def create_analysis(conversation_name: str) -> contact_center_insights_v1.Analysis:
+    # Construct an analysis.
+    analysis = contact_center_insights_v1.Analysis()
+
+    # Call the Insights client to create an analysis.
+    insights_client = contact_center_insights_v1.ContactCenterInsightsClient()
+    analysis_operation = insights_client.create_analysis(
+        parent=conversation_name, analysis=analysis
+    )
+    analysis = analysis_operation.result(timeout=600000)
+    print(f"Created {analysis.name}")
+    return analysis
+
+
+# [END contactcenterinsights_create_analysis]

samples/snippets/create_conversation.py

@@ -0,0 +1,45 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# [START contactcenterinsights_create_conversation]
+from google.cloud import contact_center_insights_v1
+
+
+def create_conversation(
+    project_id: str,
+    transcript_uri: str = "gs://cloud-samples-data/ccai/chat_sample.json",
+    audio_uri: str = "gs://cloud-samples-data/ccai/voice_6912.txt",
+) -> contact_center_insights_v1.Conversation:
+    # Construct a parent resource.
+    parent = contact_center_insights_v1.ContactCenterInsightsClient.common_location_path(
+        project_id, "us-central1"
+    )
+
+    # Construct a conversation.
+    conversation = contact_center_insights_v1.Conversation()
+    conversation.data_source.gcs_source.transcript_uri = transcript_uri
+    conversation.data_source.gcs_source.audio_uri = audio_uri
+    conversation.medium = contact_center_insights_v1.Conversation.Medium.CHAT
+
+    # Call the Insights client to create a conversation.
+    insights_client = contact_center_insights_v1.ContactCenterInsightsClient()
+    conversation = insights_client.create_conversation(
+        parent=parent, conversation=conversation
+    )
+
+    print(f"Created {conversation.name}")
+    return conversation
+
+
+# [END contactcenterinsights_create_conversation]

samples/snippets/create_conversation_with_ttl.py

@@ -0,0 +1,51 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# [START contactcenterinsights_create_conversation_with_ttl]
+from google.cloud import contact_center_insights_v1
+from google.protobuf import duration_pb2
+
+
+def create_conversation_with_ttl(
+    project_id: str,
+    transcript_uri: str = "gs://cloud-samples-data/ccai/chat_sample.json",
+    audio_uri: str = "gs://cloud-samples-data/ccai/voice_6912.txt",
+) -> contact_center_insights_v1.Conversation:
+    # Construct a parent resource.
+    parent = contact_center_insights_v1.ContactCenterInsightsClient.common_location_path(
+        project_id, "us-central1"
+    )
+
+    # Construct a conversation.
+    conversation = contact_center_insights_v1.Conversation()
+    conversation.data_source.gcs_source.transcript_uri = transcript_uri
+    conversation.data_source.gcs_source.audio_uri = audio_uri
+    conversation.medium = contact_center_insights_v1.Conversation.Medium.CHAT
+
+    # Construct a TTL.
+    ttl = duration_pb2.Duration()
+    ttl.seconds = 600
+    conversation.ttl = ttl
+
+    # Call the Insights client to create a conversation.
+    insights_client = contact_center_insights_v1.ContactCenterInsightsClient()
+    conversation = insights_client.create_conversation(
+        parent=parent, conversation=conversation
+    )
+
+    print(f"Created {conversation.name}")
+    return conversation
+
+
+# [END contactcenterinsights_create_conversation_with_ttl]

samples/snippets/export_data_to_bigquery.py

@@ -0,0 +1,52 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# [START contactcenterinsights_export_data_to_bigquery]
+from google.api_core.exceptions import GoogleAPICallError
+from google.cloud import contact_center_insights_v1
+
+
+def export_data_to_bigquery(
+    project_id: str,
+    bigquery_project_id: str,
+    bigquery_dataset_id: str,
+    bigquery_table_id: str,
+) -> None:
+    # Construct an export request.
+    request = contact_center_insights_v1.ExportInsightsDataRequest()
+    request.parent = contact_center_insights_v1.ContactCenterInsightsClient.common_location_path(
+        project_id, "us-central1"
+    )
+    request.big_query_destination.project_id = bigquery_project_id
+    request.big_query_destination.dataset = bigquery_dataset_id
+    request.big_query_destination.table = bigquery_table_id
+    request.filter = 'agent_id="007"'
+
+    # Call the Insights client to export data to BigQuery.
+    insights_client = contact_center_insights_v1.ContactCenterInsightsClient()
+    export_operation = insights_client.export_insights_data(request=request)
+
+    try:
+        export_operation.result(timeout=600000)
+    except GoogleAPICallError as e:
+        if "Long-running operation had neither response nor error set" in str(e):
+            # Ignore because the export operation doesn't return a response when it finishes successfully.
+            pass
+        else:
+            raise
+
+    print("Exported data to BigQuery")
+
+
+# [END contactcenterinsights_export_data_to_bigquery]