Skip to content
This repository was archived by the owner on Sep 16, 2023. It is now read-only.

Commit 0c506ce

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
docs: added explanation for uri fields in resources (#451)
- [ ] Regenerate this pull request now. docs: improved docs format PiperOrigin-RevId: 435479428 Source-Link: googleapis/googleapis@4dd75c2 Source-Link: https://github.com/googleapis/googleapis-gen/commit/0f3e9df388b2f84a3d6812826d20a950447c6ebb Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMGYzZTlkZjM4OGIyZjg0YTNkNjgxMjgyNmQyMGE5NTA0NDdjNmViYiJ9
1 parent d19cb06 commit 0c506ce

25 files changed

+829
-532
lines changed

‎proto-google-cloud-dialogflow-cx-v3beta1/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExportAgentRequest.java‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,11 @@ public com.google.protobuf.ByteString getNameBytes() {
192192
* export the agent to. The format of this URI must be
193193
* `gs://<bucket-name>/<object-name>`.
194194
* If left unspecified, the serialized agent is returned inline.
195+
* Dialogflow performs a write operation for the Cloud Storage object
196+
* on the caller's behalf, so your request authentication must
197+
* have write permissions for the object. For more information, see
198+
* [Dialogflow access
199+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
195200
* </pre>
196201
*
197202
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -218,6 +223,11 @@ public java.lang.String getAgentUri() {
218223
* export the agent to. The format of this URI must be
219224
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
220225
* If left unspecified, the serialized agent is returned inline.
226+
* Dialogflow performs a write operation for the Cloud Storage object
227+
* on the caller's behalf, so your request authentication must
228+
* have write permissions for the object. For more information, see
229+
* [Dialogflow access
230+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
221231
* </pre>
222232
*
223233
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -775,6 +785,11 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
775785
* export the agent to. The format of this URI must be
776786
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
777787
* If left unspecified, the serialized agent is returned inline.
788+
* Dialogflow performs a write operation for the Cloud Storage object
789+
* on the caller's behalf, so your request authentication must
790+
* have write permissions for the object. For more information, see
791+
* [Dialogflow access
792+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
778793
* </pre>
779794
*
780795
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -800,6 +815,11 @@ public java.lang.String getAgentUri() {
800815
* export the agent to. The format of this URI must be
801816
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
802817
* If left unspecified, the serialized agent is returned inline.
818+
* Dialogflow performs a write operation for the Cloud Storage object
819+
* on the caller's behalf, so your request authentication must
820+
* have write permissions for the object. For more information, see
821+
* [Dialogflow access
822+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
803823
* </pre>
804824
*
805825
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -825,6 +845,11 @@ public com.google.protobuf.ByteString getAgentUriBytes() {
825845
* export the agent to. The format of this URI must be
826846
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
827847
* If left unspecified, the serialized agent is returned inline.
848+
* Dialogflow performs a write operation for the Cloud Storage object
849+
* on the caller's behalf, so your request authentication must
850+
* have write permissions for the object. For more information, see
851+
* [Dialogflow access
852+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
828853
* </pre>
829854
*
830855
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -849,6 +874,11 @@ public Builder setAgentUri(java.lang.String value) {
849874
* export the agent to. The format of this URI must be
850875
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
851876
* If left unspecified, the serialized agent is returned inline.
877+
* Dialogflow performs a write operation for the Cloud Storage object
878+
* on the caller's behalf, so your request authentication must
879+
* have write permissions for the object. For more information, see
880+
* [Dialogflow access
881+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
852882
* </pre>
853883
*
854884
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -869,6 +899,11 @@ public Builder clearAgentUri() {
869899
* export the agent to. The format of this URI must be
870900
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
871901
* If left unspecified, the serialized agent is returned inline.
902+
* Dialogflow performs a write operation for the Cloud Storage object
903+
* on the caller's behalf, so your request authentication must
904+
* have write permissions for the object. For more information, see
905+
* [Dialogflow access
906+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
872907
* </pre>
873908
*
874909
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>

‎proto-google-cloud-dialogflow-cx-v3beta1/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExportAgentRequestOrBuilder.java‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,11 @@ public interface ExportAgentRequestOrBuilder
6262
* export the agent to. The format of this URI must be
6363
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
6464
* If left unspecified, the serialized agent is returned inline.
65+
* Dialogflow performs a write operation for the Cloud Storage object
66+
* on the caller's behalf, so your request authentication must
67+
* have write permissions for the object. For more information, see
68+
* [Dialogflow access
69+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
6570
* </pre>
6671
*
6772
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -77,6 +82,11 @@ public interface ExportAgentRequestOrBuilder
7782
* export the agent to. The format of this URI must be
7883
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
7984
* If left unspecified, the serialized agent is returned inline.
85+
* Dialogflow performs a write operation for the Cloud Storage object
86+
* on the caller's behalf, so your request authentication must
87+
* have write permissions for the object. For more information, see
88+
* [Dialogflow access
89+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
8090
* </pre>
8191
*
8292
* <code>string agent_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>

‎proto-google-cloud-dialogflow-cx-v3beta1/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExportFlowRequest.java‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -191,6 +191,11 @@ public com.google.protobuf.ByteString getNameBytes() {
191191
* export the flow to. The format of this URI must be
192192
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
193193
* If left unspecified, the serialized flow is returned inline.
194+
* Dialogflow performs a write operation for the Cloud Storage object
195+
* on the caller's behalf, so your request authentication must
196+
* have write permissions for the object. For more information, see
197+
* [Dialogflow access
198+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
194199
* </pre>
195200
*
196201
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -217,6 +222,11 @@ public java.lang.String getFlowUri() {
217222
* export the flow to. The format of this URI must be
218223
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
219224
* If left unspecified, the serialized flow is returned inline.
225+
* Dialogflow performs a write operation for the Cloud Storage object
226+
* on the caller's behalf, so your request authentication must
227+
* have write permissions for the object. For more information, see
228+
* [Dialogflow access
229+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
220230
* </pre>
221231
*
222232
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -739,6 +749,11 @@ public Builder setNameBytes(com.google.protobuf.ByteString value) {
739749
* export the flow to. The format of this URI must be
740750
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
741751
* If left unspecified, the serialized flow is returned inline.
752+
* Dialogflow performs a write operation for the Cloud Storage object
753+
* on the caller's behalf, so your request authentication must
754+
* have write permissions for the object. For more information, see
755+
* [Dialogflow access
756+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
742757
* </pre>
743758
*
744759
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -764,6 +779,11 @@ public java.lang.String getFlowUri() {
764779
* export the flow to. The format of this URI must be
765780
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
766781
* If left unspecified, the serialized flow is returned inline.
782+
* Dialogflow performs a write operation for the Cloud Storage object
783+
* on the caller's behalf, so your request authentication must
784+
* have write permissions for the object. For more information, see
785+
* [Dialogflow access
786+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
767787
* </pre>
768788
*
769789
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -789,6 +809,11 @@ public com.google.protobuf.ByteString getFlowUriBytes() {
789809
* export the flow to. The format of this URI must be
790810
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
791811
* If left unspecified, the serialized flow is returned inline.
812+
* Dialogflow performs a write operation for the Cloud Storage object
813+
* on the caller's behalf, so your request authentication must
814+
* have write permissions for the object. For more information, see
815+
* [Dialogflow access
816+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
792817
* </pre>
793818
*
794819
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -813,6 +838,11 @@ public Builder setFlowUri(java.lang.String value) {
813838
* export the flow to. The format of this URI must be
814839
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
815840
* If left unspecified, the serialized flow is returned inline.
841+
* Dialogflow performs a write operation for the Cloud Storage object
842+
* on the caller's behalf, so your request authentication must
843+
* have write permissions for the object. For more information, see
844+
* [Dialogflow access
845+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
816846
* </pre>
817847
*
818848
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -833,6 +863,11 @@ public Builder clearFlowUri() {
833863
* export the flow to. The format of this URI must be
834864
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
835865
* If left unspecified, the serialized flow is returned inline.
866+
* Dialogflow performs a write operation for the Cloud Storage object
867+
* on the caller's behalf, so your request authentication must
868+
* have write permissions for the object. For more information, see
869+
* [Dialogflow access
870+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
836871
* </pre>
837872
*
838873
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>

‎proto-google-cloud-dialogflow-cx-v3beta1/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExportFlowRequestOrBuilder.java‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,6 +64,11 @@ public interface ExportFlowRequestOrBuilder
6464
* export the flow to. The format of this URI must be
6565
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
6666
* If left unspecified, the serialized flow is returned inline.
67+
* Dialogflow performs a write operation for the Cloud Storage object
68+
* on the caller's behalf, so your request authentication must
69+
* have write permissions for the object. For more information, see
70+
* [Dialogflow access
71+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
6772
* </pre>
6873
*
6974
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>
@@ -79,6 +84,11 @@ public interface ExportFlowRequestOrBuilder
7984
* export the flow to. The format of this URI must be
8085
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
8186
* If left unspecified, the serialized flow is returned inline.
87+
* Dialogflow performs a write operation for the Cloud Storage object
88+
* on the caller's behalf, so your request authentication must
89+
* have write permissions for the object. For more information, see
90+
* [Dialogflow access
91+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
8292
* </pre>
8393
*
8494
* <code>string flow_uri = 2 [(.google.api.field_behavior) = OPTIONAL];</code>

‎proto-google-cloud-dialogflow-cx-v3beta1/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExportTestCasesRequest.java‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -401,6 +401,11 @@ public com.google.protobuf.ByteString getParentBytes() {
401401
* export the test cases to. The format of this URI must be
402402
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
403403
* cases is returned inline.
404+
* Dialogflow performs a write operation for the Cloud Storage object
405+
* on the caller's behalf, so your request authentication must
406+
* have write permissions for the object. For more information, see
407+
* [Dialogflow access
408+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
404409
* </pre>
405410
*
406411
* <code>string gcs_uri = 2;</code>
@@ -418,6 +423,11 @@ public boolean hasGcsUri() {
418423
* export the test cases to. The format of this URI must be
419424
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
420425
* cases is returned inline.
426+
* Dialogflow performs a write operation for the Cloud Storage object
427+
* on the caller's behalf, so your request authentication must
428+
* have write permissions for the object. For more information, see
429+
* [Dialogflow access
430+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
421431
* </pre>
422432
*
423433
* <code>string gcs_uri = 2;</code>
@@ -448,6 +458,11 @@ public java.lang.String getGcsUri() {
448458
* export the test cases to. The format of this URI must be
449459
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
450460
* cases is returned inline.
461+
* Dialogflow performs a write operation for the Cloud Storage object
462+
* on the caller's behalf, so your request authentication must
463+
* have write permissions for the object. For more information, see
464+
* [Dialogflow access
465+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
451466
* </pre>
452467
*
453468
* <code>string gcs_uri = 2;</code>
@@ -1118,6 +1133,11 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
11181133
* export the test cases to. The format of this URI must be
11191134
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
11201135
* cases is returned inline.
1136+
* Dialogflow performs a write operation for the Cloud Storage object
1137+
* on the caller's behalf, so your request authentication must
1138+
* have write permissions for the object. For more information, see
1139+
* [Dialogflow access
1140+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
11211141
* </pre>
11221142
*
11231143
* <code>string gcs_uri = 2;</code>
@@ -1136,6 +1156,11 @@ public boolean hasGcsUri() {
11361156
* export the test cases to. The format of this URI must be
11371157
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
11381158
* cases is returned inline.
1159+
* Dialogflow performs a write operation for the Cloud Storage object
1160+
* on the caller's behalf, so your request authentication must
1161+
* have write permissions for the object. For more information, see
1162+
* [Dialogflow access
1163+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
11391164
* </pre>
11401165
*
11411166
* <code>string gcs_uri = 2;</code>
@@ -1167,6 +1192,11 @@ public java.lang.String getGcsUri() {
11671192
* export the test cases to. The format of this URI must be
11681193
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
11691194
* cases is returned inline.
1195+
* Dialogflow performs a write operation for the Cloud Storage object
1196+
* on the caller's behalf, so your request authentication must
1197+
* have write permissions for the object. For more information, see
1198+
* [Dialogflow access
1199+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
11701200
* </pre>
11711201
*
11721202
* <code>string gcs_uri = 2;</code>
@@ -1198,6 +1228,11 @@ public com.google.protobuf.ByteString getGcsUriBytes() {
11981228
* export the test cases to. The format of this URI must be
11991229
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
12001230
* cases is returned inline.
1231+
* Dialogflow performs a write operation for the Cloud Storage object
1232+
* on the caller's behalf, so your request authentication must
1233+
* have write permissions for the object. For more information, see
1234+
* [Dialogflow access
1235+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
12011236
* </pre>
12021237
*
12031238
* <code>string gcs_uri = 2;</code>
@@ -1222,6 +1257,11 @@ public Builder setGcsUri(java.lang.String value) {
12221257
* export the test cases to. The format of this URI must be
12231258
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
12241259
* cases is returned inline.
1260+
* Dialogflow performs a write operation for the Cloud Storage object
1261+
* on the caller's behalf, so your request authentication must
1262+
* have write permissions for the object. For more information, see
1263+
* [Dialogflow access
1264+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
12251265
* </pre>
12261266
*
12271267
* <code>string gcs_uri = 2;</code>
@@ -1244,6 +1284,11 @@ public Builder clearGcsUri() {
12441284
* export the test cases to. The format of this URI must be
12451285
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
12461286
* cases is returned inline.
1287+
* Dialogflow performs a write operation for the Cloud Storage object
1288+
* on the caller's behalf, so your request authentication must
1289+
* have write permissions for the object. For more information, see
1290+
* [Dialogflow access
1291+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
12471292
* </pre>
12481293
*
12491294
* <code>string gcs_uri = 2;</code>

‎proto-google-cloud-dialogflow-cx-v3beta1/src/main/java/com/google/cloud/dialogflow/cx/v3beta1/ExportTestCasesRequestOrBuilder.java‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -62,6 +62,11 @@ public interface ExportTestCasesRequestOrBuilder
6262
* export the test cases to. The format of this URI must be
6363
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
6464
* cases is returned inline.
65+
* Dialogflow performs a write operation for the Cloud Storage object
66+
* on the caller's behalf, so your request authentication must
67+
* have write permissions for the object. For more information, see
68+
* [Dialogflow access
69+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
6570
* </pre>
6671
*
6772
* <code>string gcs_uri = 2;</code>
@@ -77,6 +82,11 @@ public interface ExportTestCasesRequestOrBuilder
7782
* export the test cases to. The format of this URI must be
7883
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
7984
* cases is returned inline.
85+
* Dialogflow performs a write operation for the Cloud Storage object
86+
* on the caller's behalf, so your request authentication must
87+
* have write permissions for the object. For more information, see
88+
* [Dialogflow access
89+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
8090
* </pre>
8191
*
8292
* <code>string gcs_uri = 2;</code>
@@ -92,6 +102,11 @@ public interface ExportTestCasesRequestOrBuilder
92102
* export the test cases to. The format of this URI must be
93103
* `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`. If unspecified, the serialized test
94104
* cases is returned inline.
105+
* Dialogflow performs a write operation for the Cloud Storage object
106+
* on the caller's behalf, so your request authentication must
107+
* have write permissions for the object. For more information, see
108+
* [Dialogflow access
109+
* control](https://cloud.google.com/dialogflow/cx/docs/concept/access-control#storage).
95110
* </pre>
96111
*
97112
* <code>string gcs_uri = 2;</code>

0 commit comments

Comments
 (0)