feat: added page in TestConfig (#268)

- [ ] Regenerate this pull request now. docs: clarified wording around Cloud Storage usage PiperOrigin-RevId: 433282831 Source-Link: googleapis/googleapis@0e87dc7 Source-Link: https://github.com/googleapis/googleapis-gen/commit/1928631f3ee91488fe07b3d8188a52d10862453a Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTkyODYzMWYzZWU5MTQ4OGZlMDdiM2Q4MTg4YTUyZDEwODYyNDUzYSJ9

Author: gcf-owl-bot[bot]

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://<bucket-name>/<object-name>``. 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 <https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage>`__.
  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://<bucket-name>/<object-name>``.
 
+ 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 <https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage>`__.
+
  This field is a member of `oneof`_ ``agent``.
  agent_content (bytes):
  Uncompressed raw byte content for agent.

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://<bucket-name>/<object-name>``.
 
+ 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 <https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage>`__.
+
  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://<bucket-name>/<object-name>``. 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 <https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage>`__.
  include_referenced_flows (bool):
  Optional. Whether to export flows referenced
  by the specified flow.

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/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>``.
+
+ 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/<Project ID>/locations/<Location ID>/agents/<Agent ID>/flows/<Flow ID>/pages/<Page ID>``.
+
+ 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://<bucket-name>/<object-name>``.
 
+ 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 <https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage>`__.
+
  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://<bucket-name>/<object-name>``. 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 <https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage>`__.
+
  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