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: googleapis/googleapis-gen@1928631
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTkyODYzMWYzZWU5MTQ4OGZlMDdiM2Q4MTg4YTUyZDEwODYyNDUzYSJ9

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