docs: Improvements to various message and field descriptions (#1010)

PiperOrigin-RevId: 391604499 Source-Author: Google APIs <noreply@google.com> Source-Date: Wed Aug 18 14:00:41 2021 -0700 Source-Repo: googleapis/googleapis Source-Sha: 853cfd33b66580be0b61f3bb0cfea4abd351b565 Source-Link: googleapis/googleapis@853cfd3
googleapis · Aug 25, 2021 · a857946 · a857946
1 parent 25fe359
commit a857946
Show file tree

Hide file tree

Showing 13 changed files with 401 additions and 270 deletions.
diff --git a/...er/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceClient.java b/...er/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceClient.java
@@ -868,7 +868,7 @@ public final UnaryCallable<GetTransferConfigRequest, TransferConfig> getTransfer
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns information about all data transfers in the project.
+   * Returns information about all transfer configs owned by a project in the specified location.
    *
    * <p>Sample code:
    *
@@ -896,7 +896,7 @@ public final ListTransferConfigsPagedResponse listTransferConfigs(LocationName p
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns information about all data transfers in the project.
+   * Returns information about all transfer configs owned by a project in the specified location.
    *
    * <p>Sample code:
    *
@@ -924,7 +924,7 @@ public final ListTransferConfigsPagedResponse listTransferConfigs(ProjectName pa
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns information about all data transfers in the project.
+   * Returns information about all transfer configs owned by a project in the specified location.
    *
    * <p>Sample code:
    *
@@ -952,7 +952,7 @@ public final ListTransferConfigsPagedResponse listTransferConfigs(String parent)
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns information about all data transfers in the project.
+   * Returns information about all transfer configs owned by a project in the specified location.
    *
    * <p>Sample code:
    *
@@ -984,7 +984,7 @@ public final ListTransferConfigsPagedResponse listTransferConfigs(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns information about all data transfers in the project.
+   * Returns information about all transfer configs owned by a project in the specified location.
    *
    * <p>Sample code:
    *
@@ -1015,7 +1015,7 @@ public final ListTransferConfigsPagedResponse listTransferConfigs(
 
   // AUTO-GENERATED DOCUMENTATION AND METHOD.
   /**
-   * Returns information about all data transfers in the project.
+   * Returns information about all transfer configs owned by a project in the specified location.
    *
    * <p>Sample code:
    *

diff --git a/...r-v1/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceGrpc.java b/...r-v1/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataTransferServiceGrpc.java
@@ -871,7 +871,8 @@ public void getTransferConfig(
      *
      *
      * <pre>
-     * Returns information about all data transfers in the project.
+     * Returns information about all transfer configs owned by a project in the
+     * specified location.
      * </pre>
      */
     public void listTransferConfigs(
@@ -1240,7 +1241,8 @@ public void getTransferConfig(
      *
      *
      * <pre>
-     * Returns information about all data transfers in the project.
+     * Returns information about all transfer configs owned by a project in the
+     * specified location.
      * </pre>
      */
     public void listTransferConfigs(
@@ -1500,7 +1502,8 @@ public com.google.cloud.bigquery.datatransfer.v1.TransferConfig getTransferConfi
      *
      *
      * <pre>
-     * Returns information about all data transfers in the project.
+     * Returns information about all transfer configs owned by a project in the
+     * specified location.
      * </pre>
      */
     public com.google.cloud.bigquery.datatransfer.v1.ListTransferConfigsResponse
@@ -1735,7 +1738,8 @@ protected DataTransferServiceFutureStub build(
      *
      *
      * <pre>
-     * Returns information about all data transfers in the project.
+     * Returns information about all transfer configs owned by a project in the
+     * specified location.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<

diff --git a/...rydatatransfer-v1/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataSource.java b/...rydatatransfer-v1/src/main/java/com/google/cloud/bigquery/datatransfer/v1/DataSource.java
@@ -303,9 +303,7 @@ public enum AuthorizationType implements com.google.protobuf.ProtocolMessageEnum
      *
      *
      * <pre>
-     * Use First Party Client OAuth. First Party Client OAuth doesn't require a
-     * refresh token to get an offline access token. Instead, it uses a
-     * client-signed JWT assertion to retrieve an access token.
+     * Use First Party OAuth.
      * </pre>
      *
      * <code>FIRST_PARTY_OAUTH = 3;</code>
@@ -350,9 +348,7 @@ public enum AuthorizationType implements com.google.protobuf.ProtocolMessageEnum
      *
      *
      * <pre>
-     * Use First Party Client OAuth. First Party Client OAuth doesn't require a
-     * refresh token to get an offline access token. Instead, it uses a
-     * client-signed JWT assertion to retrieve an access token.
+     * Use First Party OAuth.
      * </pre>
      *
      * <code>FIRST_PARTY_OAUTH = 3;</code>