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

Commit b1affa6

Browse files
feat: added support for custom content types docs: reformat comments (#375)
* feat: added support for custom content types docs: reformat comments PiperOrigin-RevId: 414026488 Source-Link: googleapis/googleapis@26ab5dd Source-Link: https://github.com/googleapis/googleapis-gen/commit/d4c1a646b4056e598eba01213af350bd8f6a6952 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZDRjMWE2NDZiNDA1NmU1OThlYmEwMTIxM2FmMzUwYmQ4ZjZhNjk1MiJ9 * 🦉 Updates from OwlBot See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 5726848 commit b1affa6

File tree

52 files changed

+3383
-2127
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

52 files changed

+3383
-2127
lines changed

google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/VersionsClient.java

Lines changed: 24 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -179,8 +179,8 @@ public final OperationsClient getOperationsClient() {
179179
* }</pre>
180180
*
181181
* @param parent Required. The [Flow][google.cloud.dialogflow.cx.v3.Flow] to list all versions
182-
* for. Format:
183-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;`.
182+
* for. Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
183+
* ID&gt;/flows/&lt;Flow ID&gt;`.
184184
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
185185
*/
186186
public final ListVersionsPagedResponse listVersions(FlowName parent) {
@@ -207,8 +207,8 @@ public final ListVersionsPagedResponse listVersions(FlowName parent) {
207207
* }</pre>
208208
*
209209
* @param parent Required. The [Flow][google.cloud.dialogflow.cx.v3.Flow] to list all versions
210-
* for. Format:
211-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;`.
210+
* for. Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
211+
* ID&gt;/flows/&lt;Flow ID&gt;`.
212212
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
213213
*/
214214
public final ListVersionsPagedResponse listVersions(String parent) {
@@ -318,7 +318,8 @@ public final UnaryCallable<ListVersionsRequest, ListVersionsResponse> listVersio
318318
* }</pre>
319319
*
320320
* @param name Required. The name of the [Version][google.cloud.dialogflow.cx.v3.Version]. Format:
321-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
321+
* `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
322+
* ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
322323
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
323324
*/
324325
public final Version getVersion(VersionName name) {
@@ -342,7 +343,8 @@ public final Version getVersion(VersionName name) {
342343
* }</pre>
343344
*
344345
* @param name Required. The name of the [Version][google.cloud.dialogflow.cx.v3.Version]. Format:
345-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
346+
* `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
347+
* ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
346348
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
347349
*/
348350
public final Version getVersion(String name) {
@@ -423,8 +425,8 @@ public final UnaryCallable<GetVersionRequest, Version> getVersionCallable() {
423425
* }</pre>
424426
*
425427
* @param parent Required. The [Flow][google.cloud.dialogflow.cx.v3.Flow] to create an
426-
* [Version][google.cloud.dialogflow.cx.v3.Version] for. Format:
427-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;`.
428+
* [Version][google.cloud.dialogflow.cx.v3.Version] for. Format: `projects/&lt;Project
429+
* ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent ID&gt;/flows/&lt;Flow ID&gt;`.
428430
* @param version Required. The version to create.
429431
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
430432
*/
@@ -462,8 +464,8 @@ public final OperationFuture<Version, CreateVersionOperationMetadata> createVers
462464
* }</pre>
463465
*
464466
* @param parent Required. The [Flow][google.cloud.dialogflow.cx.v3.Flow] to create an
465-
* [Version][google.cloud.dialogflow.cx.v3.Version] for. Format:
466-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;`.
467+
* [Version][google.cloud.dialogflow.cx.v3.Version] for. Format: `projects/&lt;Project
468+
* ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent ID&gt;/flows/&lt;Flow ID&gt;`.
467469
* @param version Required. The version to create.
468470
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
469471
*/
@@ -661,8 +663,8 @@ public final UnaryCallable<UpdateVersionRequest, Version> updateVersionCallable(
661663
* }</pre>
662664
*
663665
* @param name Required. The name of the [Version][google.cloud.dialogflow.cx.v3.Version] to
664-
* delete. Format:
665-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
666+
* delete. Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
667+
* ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
666668
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
667669
*/
668670
public final void deleteVersion(VersionName name) {
@@ -686,8 +688,8 @@ public final void deleteVersion(VersionName name) {
686688
* }</pre>
687689
*
688690
* @param name Required. The name of the [Version][google.cloud.dialogflow.cx.v3.Version] to
689-
* delete. Format:
690-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
691+
* delete. Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/&lt;Agent
692+
* ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
691693
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
692694
*/
693695
public final void deleteVersion(String name) {
@@ -768,8 +770,8 @@ public final UnaryCallable<DeleteVersionRequest, Empty> deleteVersionCallable()
768770
* }</pre>
769771
*
770772
* @param name Required. The [Version][google.cloud.dialogflow.cx.v3.Version] to be loaded to
771-
* draft flow. Format:
772-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
773+
* draft flow. Format: `projects/&lt;Project ID&gt;/locations/&lt;Location
774+
* ID&gt;/agents/&lt;Agent ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
773775
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
774776
*/
775777
public final OperationFuture<Empty, Struct> loadVersionAsync(VersionName name) {
@@ -802,8 +804,8 @@ public final OperationFuture<Empty, Struct> loadVersionAsync(VersionName name) {
802804
* }</pre>
803805
*
804806
* @param name Required. The [Version][google.cloud.dialogflow.cx.v3.Version] to be loaded to
805-
* draft flow. Format:
806-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
807+
* draft flow. Format: `projects/&lt;Project ID&gt;/locations/&lt;Location
808+
* ID&gt;/agents/&lt;Agent ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
807809
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
808810
*/
809811
public final OperationFuture<Empty, Struct> loadVersionAsync(String name) {
@@ -931,8 +933,8 @@ public final UnaryCallable<LoadVersionRequest, Operation> loadVersionCallable()
931933
*
932934
* @param baseVersion Required. Name of the base flow version to compare with the target version.
933935
* Use version ID `0` to indicate the draft version of the specified flow.
934-
* <p>Format:
935-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
936+
* <p>Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/ &lt;Agent
937+
* ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
936938
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
937939
*/
938940
public final CompareVersionsResponse compareVersions(VersionName baseVersion) {
@@ -959,8 +961,8 @@ public final CompareVersionsResponse compareVersions(VersionName baseVersion) {
959961
*
960962
* @param baseVersion Required. Name of the base flow version to compare with the target version.
961963
* Use version ID `0` to indicate the draft version of the specified flow.
962-
* <p>Format:
963-
* `projects/&lt;ProjectID&gt;/locations/&lt;LocationID&gt;/agents/&lt;AgentID&gt;/flows/&lt;FlowID&gt;/versions/&lt;VersionID&gt;`.
964+
* <p>Format: `projects/&lt;Project ID&gt;/locations/&lt;Location ID&gt;/agents/ &lt;Agent
965+
* ID&gt;/flows/&lt;Flow ID&gt;/versions/&lt;Version ID&gt;`.
964966
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
965967
*/
966968
public final CompareVersionsResponse compareVersions(String baseVersion) {

grpc-google-cloud-dialogflow-cx-v3/src/main/java/com/google/cloud/dialogflow/cx/v3/VersionsGrpc.java

Lines changed: 12 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -397,8 +397,7 @@ public abstract static class VersionsImplBase implements io.grpc.BindableService
397397
*
398398
*
399399
* <pre>
400-
* Returns the list of all versions in the specified
401-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
400+
* Returns the list of all versions in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
402401
* </pre>
403402
*/
404403
public void listVersions(
@@ -426,13 +425,11 @@ public void getVersion(
426425
*
427426
*
428427
* <pre>
429-
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified
430-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
428+
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
431429
* This method is a [long-running
432430
* operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
433431
* The returned `Operation` type has the following method-specific fields:
434-
* - `metadata`:
435-
* [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
432+
* - `metadata`: [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
436433
* - `response`: [Version][google.cloud.dialogflow.cx.v3.Version]
437434
* </pre>
438435
*/
@@ -579,8 +576,7 @@ protected VersionsStub build(io.grpc.Channel channel, io.grpc.CallOptions callOp
579576
*
580577
*
581578
* <pre>
582-
* Returns the list of all versions in the specified
583-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
579+
* Returns the list of all versions in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
584580
* </pre>
585581
*/
586582
public void listVersions(
@@ -611,13 +607,11 @@ public void getVersion(
611607
*
612608
*
613609
* <pre>
614-
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified
615-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
610+
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
616611
* This method is a [long-running
617612
* operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
618613
* The returned `Operation` type has the following method-specific fields:
619-
* - `metadata`:
620-
* [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
614+
* - `metadata`: [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
621615
* - `response`: [Version][google.cloud.dialogflow.cx.v3.Version]
622616
* </pre>
623617
*/
@@ -725,8 +719,7 @@ protected VersionsBlockingStub build(io.grpc.Channel channel, io.grpc.CallOption
725719
*
726720
*
727721
* <pre>
728-
* Returns the list of all versions in the specified
729-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
722+
* Returns the list of all versions in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
730723
* </pre>
731724
*/
732725
public com.google.cloud.dialogflow.cx.v3.ListVersionsResponse listVersions(
@@ -752,13 +745,11 @@ public com.google.cloud.dialogflow.cx.v3.Version getVersion(
752745
*
753746
*
754747
* <pre>
755-
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified
756-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
748+
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
757749
* This method is a [long-running
758750
* operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
759751
* The returned `Operation` type has the following method-specific fields:
760-
* - `metadata`:
761-
* [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
752+
* - `metadata`: [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
762753
* - `response`: [Version][google.cloud.dialogflow.cx.v3.Version]
763754
* </pre>
764755
*/
@@ -850,8 +841,7 @@ protected VersionsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions
850841
*
851842
*
852843
* <pre>
853-
* Returns the list of all versions in the specified
854-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
844+
* Returns the list of all versions in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
855845
* </pre>
856846
*/
857847
public com.google.common.util.concurrent.ListenableFuture<
@@ -879,13 +869,11 @@ protected VersionsFutureStub build(io.grpc.Channel channel, io.grpc.CallOptions
879869
*
880870
*
881871
* <pre>
882-
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified
883-
* [Flow][google.cloud.dialogflow.cx.v3.Flow].
872+
* Creates a [Version][google.cloud.dialogflow.cx.v3.Version] in the specified [Flow][google.cloud.dialogflow.cx.v3.Flow].
884873
* This method is a [long-running
885874
* operation](https://cloud.google.com/dialogflow/cx/docs/how/long-running-operation).
886875
* The returned `Operation` type has the following method-specific fields:
887-
* - `metadata`:
888-
* [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
876+
* - `metadata`: [CreateVersionOperationMetadata][google.cloud.dialogflow.cx.v3.CreateVersionOperationMetadata]
889877
* - `response`: [Version][google.cloud.dialogflow.cx.v3.Version]
890878
* </pre>
891879
*/

0 commit comments

Comments
 (0)