diff --git a/CHANGELOG.md b/CHANGELOG.md index 19273a0c..87e5001e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,18 @@ # Changelog +## [1.10.0](https://github.com/googleapis/python-dialogflow-cx/compare/v1.9.1...v1.10.0) (2022-03-10) + + +### Features + +* added page in TestConfig ([#268](https://github.com/googleapis/python-dialogflow-cx/issues/268)) ([61fd2dc](https://github.com/googleapis/python-dialogflow-cx/commit/61fd2dc3512e4bcfdfc51cf085cc12cbbf1e043b)) +* **v3beta1:** added page in TestConfig ([#270](https://github.com/googleapis/python-dialogflow-cx/issues/270)) ([a81f0c2](https://github.com/googleapis/python-dialogflow-cx/commit/a81f0c23d5dc835bd6abdccd546ef00f6c421a74)) + + +### Documentation + +* clarified wording around Cloud Storage usage ([61fd2dc](https://github.com/googleapis/python-dialogflow-cx/commit/61fd2dc3512e4bcfdfc51cf085cc12cbbf1e043b)) + ### [1.9.1](https://github.com/googleapis/python-dialogflow-cx/compare/v1.9.0...v1.9.1) (2022-03-05) diff --git a/google/cloud/dialogflowcx_v3/types/agent.py b/google/cloud/dialogflowcx_v3/types/agent.py index 0eb00d84..5d709fd6 100644 --- a/google/cloud/dialogflowcx_v3/types/agent.py +++ b/google/cloud/dialogflowcx_v3/types/agent.py @@ -269,6 +269,12 @@ class ExportAgentRequest(proto.Message): export the agent to. The format of this URI must be ``gs:///``. If left unspecified, the serialized agent is returned inline. + + Dialogflow performs a write operation for the Cloud Storage + object on the caller's behalf, so your request + authentication must have write permissions for the object. + For more information, see `Dialogflow access + control `__. environment (str): Optional. Environment name. If not set, draft environment is assumed. Format: @@ -329,6 +335,12 @@ class RestoreAgentRequest(proto.Message): restore agent from. The format of this URI must be ``gs:///``. + Dialogflow performs a read operation for the Cloud Storage + object on the caller's behalf, so your request + authentication must have read permissions for the object. + For more information, see `Dialogflow access + control `__. + This field is a member of `oneof`_ ``agent``. agent_content (bytes): Uncompressed raw byte content for agent. diff --git a/google/cloud/dialogflowcx_v3/types/flow.py b/google/cloud/dialogflowcx_v3/types/flow.py index ef0a8c87..e2efeb74 100644 --- a/google/cloud/dialogflowcx_v3/types/flow.py +++ b/google/cloud/dialogflowcx_v3/types/flow.py @@ -437,6 +437,12 @@ class ImportFlowRequest(proto.Message): import flow from. The format of this URI must be ``gs:///``. + Dialogflow performs a read operation for the Cloud Storage + object on the caller's behalf, so your request + authentication must have read permissions for the object. + For more information, see `Dialogflow access + control `__. + This field is a member of `oneof`_ ``flow``. flow_content (bytes): Uncompressed raw byte content for flow. @@ -485,6 +491,12 @@ class ExportFlowRequest(proto.Message): export the flow to. The format of this URI must be ``gs:///``. If left unspecified, the serialized flow is returned inline. + + Dialogflow performs a write operation for the Cloud Storage + object on the caller's behalf, so your request + authentication must have write permissions for the object. + For more information, see `Dialogflow access + control `__. include_referenced_flows (bool): Optional. Whether to export flows referenced by the specified flow. diff --git a/google/cloud/dialogflowcx_v3/types/test_case.py b/google/cloud/dialogflowcx_v3/types/test_case.py index 7f64db49..020edbfe 100644 --- a/google/cloud/dialogflowcx_v3/types/test_case.py +++ b/google/cloud/dialogflowcx_v3/types/test_case.py @@ -162,13 +162,29 @@ class TestConfig(proto.Message): Session parameters to be compared when calculating differences. flow (str): - Flow name. If not set, default start flow is assumed. - Format: + Flow name to start the test case with. Format: ``projects//locations//agents//flows/``. + + Only one of ``flow`` and ``page`` should be set to indicate + the starting point of the test case. If both are set, + ``page`` takes precedence over ``flow``. If neither is set, + the test case will start with start page on the default + start flow. + page (str): + The [page][google.cloud.dialogflow.cx.v3.Page] to start the + test case with. Format: + ``projects//locations//agents//flows//pages/``. + + Only one of ``flow`` and ``page`` should be set to indicate + the starting point of the test case. If both are set, + ``page`` takes precedence over ``flow``. If neither is set, + the test case will start with start page on the default + start flow. """ tracking_parameters = proto.RepeatedField(proto.STRING, number=1,) flow = proto.Field(proto.STRING, number=2,) + page = proto.Field(proto.STRING, number=3,) class ConversationTurn(proto.Message): @@ -800,6 +816,12 @@ class ImportTestCasesRequest(proto.Message): import test cases from. The format of this URI must be ``gs:///``. + Dialogflow performs a read operation for the Cloud Storage + object on the caller's behalf, so your request + authentication must have read permissions for the object. + For more information, see `Dialogflow access + control `__. + This field is a member of `oneof`_ ``source``. content (bytes): Uncompressed raw byte content for test cases. @@ -870,6 +892,12 @@ class ExportTestCasesRequest(proto.Message): ``gs:///``. If unspecified, the serialized test cases is returned inline. + Dialogflow performs a write operation for the Cloud Storage + object on the caller's behalf, so your request + authentication must have write permissions for the object. + For more information, see `Dialogflow access + control `__. + This field is a member of `oneof`_ ``destination``. data_format (google.cloud.dialogflowcx_v3.types.ExportTestCasesRequest.DataFormat): The data format of the exported test cases. If not diff --git a/google/cloud/dialogflowcx_v3beta1/types/test_case.py b/google/cloud/dialogflowcx_v3beta1/types/test_case.py index 5bb572a9..30b4071c 100644 --- a/google/cloud/dialogflowcx_v3beta1/types/test_case.py +++ b/google/cloud/dialogflowcx_v3beta1/types/test_case.py @@ -162,13 +162,29 @@ class TestConfig(proto.Message): Session parameters to be compared when calculating differences. flow (str): - Flow name. If not set, default start flow is assumed. - Format: + Flow name to start the test case with. Format: ``projects//locations//agents//flows/``. + + Only one of ``flow`` and ``page`` should be set to indicate + the starting point of the test case. If both are set, + ``page`` takes precedence over ``flow``. If neither is set, + the test case will start with start page on the default + start flow. + page (str): + The [page][google.cloud.dialogflow.cx.v3beta1.Page] to start + the test case with. Format: + ``projects//locations//agents//flows//pages/``. + + Only one of ``flow`` and ``page`` should be set to indicate + the starting point of the test case. If both are set, + ``page`` takes precedence over ``flow``. If neither is set, + the test case will start with start page on the default + start flow. """ tracking_parameters = proto.RepeatedField(proto.STRING, number=1,) flow = proto.Field(proto.STRING, number=2,) + page = proto.Field(proto.STRING, number=3,) class ConversationTurn(proto.Message): diff --git a/samples/snippets/requirements.txt b/samples/snippets/requirements.txt index df1f9f29..b7972dbe 100644 --- a/samples/snippets/requirements.txt +++ b/samples/snippets/requirements.txt @@ -1,2 +1,2 @@ -google-cloud-dialogflow-cx==1.9.0 +google-cloud-dialogflow-cx==1.9.1 Flask==2.0.3 diff --git a/setup.py b/setup.py index 8661eb3f..f47a1d73 100644 --- a/setup.py +++ b/setup.py @@ -19,7 +19,7 @@ import os import setuptools # type: ignore -version = "1.9.1" +version = "1.10.0" package_root = os.path.abspath(os.path.dirname(__file__))