From 092bc28f3991e4894d530e02dc408ce905134310 Mon Sep 17 00:00:00 2001
From: Yoshi Automation Bot <yoshi-automation@google.com>
Date: Mon, 8 Feb 2021 16:40:04 -0800
Subject: [PATCH] docs: generate sample code in the Java microgenerator (#370)

This PR was generated using Autosynth. :rainbow:

Synth log will be available here:
https://source.cloud.google.com/results/invocations/fbee02a3-e9fc-4733-8d87-962a71f40117/targets

- [ ] To automatically regenerate this PR, check this box.

PiperOrigin-RevId: 356341083
Source-Link: https://github.com/googleapis/googleapis/commit/8d8c008e56f1af31d57f75561e0f1848ffb29eeb
---
 .../v1/SecretManagerServiceClient.java        | 731 ++++++++++++++++++
 .../cloud/secretmanager/v1/package-info.java  |  10 +
 .../v1beta1/SecretManagerServiceClient.java   | 731 ++++++++++++++++++
 .../secretmanager/v1beta1/package-info.java   |  10 +
 synth.metadata                                |   6 +-
 5 files changed, 1485 insertions(+), 3 deletions(-)

diff --git a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java
index e8567618..a320b755 100644
--- a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java
+++ b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/SecretManagerServiceClient.java
@@ -56,6 +56,16 @@
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
+ * <pre>{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ *     SecretManagerServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   String secretId = "secretId945974251";
+ *   Secret secret = Secret.newBuilder().build();
+ *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }</pre>
+ *
  * <p>Note: close() needs to be called on the SecretManagerServiceClient object to clean up
  * resources such as threads. In the example above, try-with-resources is used, which automatically
  * calls close().
@@ -162,6 +172,18 @@ public SecretManagerServiceStub getStub() {
   /**
    * Lists [Secrets][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project associated with the
    *     [Secrets][google.cloud.secretmanager.v1.Secret], in the format `projects/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -178,6 +200,18 @@ public final ListSecretsPagedResponse listSecrets(ProjectName parent) {
   /**
    * Lists [Secrets][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project associated with the
    *     [Secrets][google.cloud.secretmanager.v1.Secret], in the format `projects/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -191,6 +225,23 @@ public final ListSecretsPagedResponse listSecrets(String parent) {
   /**
    * Lists [Secrets][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretsRequest request =
+   *       ListSecretsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   for (Secret element : secretManagerServiceClient.listSecrets(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -203,6 +254,24 @@ public final ListSecretsPagedResponse listSecrets(ListSecretsRequest request) {
    * Lists [Secrets][google.cloud.secretmanager.v1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretsRequest request =
+   *       ListSecretsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   ApiFuture<Secret> future =
+   *       secretManagerServiceClient.listSecretsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Secret element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretsRequest, ListSecretsPagedResponse>
       listSecretsPagedCallable() {
@@ -214,6 +283,25 @@ public final ListSecretsPagedResponse listSecrets(ListSecretsRequest request) {
    * Lists [Secrets][google.cloud.secretmanager.v1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   while (true) {
+   *     ListSecretsResponse response =
+   *         secretManagerServiceClient.listSecretsCallable().call(request);
+   *     for (Secret element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretsRequest, ListSecretsResponse> listSecretsCallable() {
     return stub.listSecretsCallable();
@@ -224,6 +312,18 @@ public final UnaryCallable<ListSecretsRequest, ListSecretsResponse> listSecretsC
    * Creates a new [Secret][google.cloud.secretmanager.v1.Secret] containing no
    * [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   String secretId = "secretId945974251";
+   *   Secret secret = Secret.newBuilder().build();
+   *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project to associate with the
    *     [Secret][google.cloud.secretmanager.v1.Secret], in the format `projects/&#42;`.
    * @param secretId Required. This must be unique within the project.
@@ -249,6 +349,18 @@ public final Secret createSecret(ProjectName parent, String secretId, Secret sec
    * Creates a new [Secret][google.cloud.secretmanager.v1.Secret] containing no
    * [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   String secretId = "secretId945974251";
+   *   Secret secret = Secret.newBuilder().build();
+   *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project to associate with the
    *     [Secret][google.cloud.secretmanager.v1.Secret], in the format `projects/&#42;`.
    * @param secretId Required. This must be unique within the project.
@@ -274,6 +386,21 @@ public final Secret createSecret(String parent, String secretId, Secret secret)
    * Creates a new [Secret][google.cloud.secretmanager.v1.Secret] containing no
    * [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   CreateSecretRequest request =
+   *       CreateSecretRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setSecretId("secretId945974251")
+   *           .setSecret(Secret.newBuilder().build())
+   *           .build();
+   *   Secret response = secretManagerServiceClient.createSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -287,6 +414,22 @@ public final Secret createSecret(CreateSecretRequest request) {
    * [SecretVersions][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   CreateSecretRequest request =
+   *       CreateSecretRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setSecretId("secretId945974251")
+   *           .setSecret(Secret.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Secret> future =
+   *       secretManagerServiceClient.createSecretCallable().futureCall(request);
+   *   // Do something.
+   *   Secret response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<CreateSecretRequest, Secret> createSecretCallable() {
     return stub.createSecretCallable();
@@ -297,6 +440,17 @@ public final UnaryCallable<CreateSecretRequest, Secret> createSecretCallable() {
    * Creates a new [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] containing secret
    * data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+   *   SecretPayload payload = SecretPayload.newBuilder().build();
+   *   SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
    *     to associate with the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the
    *     format `projects/&#42;/secrets/&#42;`.
@@ -318,6 +472,17 @@ public final SecretVersion addSecretVersion(SecretName parent, SecretPayload pay
    * Creates a new [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] containing secret
    * data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   SecretPayload payload = SecretPayload.newBuilder().build();
+   *   SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
    *     to associate with the [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the
    *     format `projects/&#42;/secrets/&#42;`.
@@ -336,6 +501,20 @@ public final SecretVersion addSecretVersion(String parent, SecretPayload payload
    * Creates a new [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] containing secret
    * data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AddSecretVersionRequest request =
+   *       AddSecretVersionRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPayload(SecretPayload.newBuilder().build())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.addSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -349,6 +528,21 @@ public final SecretVersion addSecretVersion(AddSecretVersionRequest request) {
    * data and attaches it to an existing [Secret][google.cloud.secretmanager.v1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AddSecretVersionRequest request =
+   *       AddSecretVersionRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPayload(SecretPayload.newBuilder().build())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.addSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<AddSecretVersionRequest, SecretVersion> addSecretVersionCallable() {
     return stub.addSecretVersionCallable();
@@ -358,6 +552,16 @@ public final UnaryCallable<AddSecretVersionRequest, SecretVersion> addSecretVers
   /**
    * Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+   *   Secret response = secretManagerServiceClient.getSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret],
    *     in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -372,6 +576,16 @@ public final Secret getSecret(SecretName name) {
   /**
    * Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   Secret response = secretManagerServiceClient.getSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret],
    *     in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -385,6 +599,19 @@ public final Secret getSecret(String name) {
   /**
    * Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretRequest request =
+   *       GetSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   Secret response = secretManagerServiceClient.getSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -397,6 +624,19 @@ public final Secret getSecret(GetSecretRequest request) {
    * Gets metadata for a given [Secret][google.cloud.secretmanager.v1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretRequest request =
+   *       GetSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   ApiFuture<Secret> future = secretManagerServiceClient.getSecretCallable().futureCall(request);
+   *   // Do something.
+   *   Secret response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<GetSecretRequest, Secret> getSecretCallable() {
     return stub.getSecretCallable();
@@ -406,6 +646,17 @@ public final UnaryCallable<GetSecretRequest, Secret> getSecretCallable() {
   /**
    * Updates metadata of an existing [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   Secret secret = Secret.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Secret response = secretManagerServiceClient.updateSecret(secret, updateMask);
+   * }
+   * }</pre>
+   *
    * @param secret Required. [Secret][google.cloud.secretmanager.v1.Secret] with updated field
    *     values.
    * @param updateMask Required. Specifies the fields to be updated.
@@ -421,6 +672,20 @@ public final Secret updateSecret(Secret secret, FieldMask updateMask) {
   /**
    * Updates metadata of an existing [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   UpdateSecretRequest request =
+   *       UpdateSecretRequest.newBuilder()
+   *           .setSecret(Secret.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Secret response = secretManagerServiceClient.updateSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -433,6 +698,21 @@ public final Secret updateSecret(UpdateSecretRequest request) {
    * Updates metadata of an existing [Secret][google.cloud.secretmanager.v1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   UpdateSecretRequest request =
+   *       UpdateSecretRequest.newBuilder()
+   *           .setSecret(Secret.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Secret> future =
+   *       secretManagerServiceClient.updateSecretCallable().futureCall(request);
+   *   // Do something.
+   *   Secret response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<UpdateSecretRequest, Secret> updateSecretCallable() {
     return stub.updateSecretCallable();
@@ -442,6 +722,16 @@ public final UnaryCallable<UpdateSecretRequest, Secret> updateSecretCallable() {
   /**
    * Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+   *   secretManagerServiceClient.deleteSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
    *     to delete in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -456,6 +746,16 @@ public final void deleteSecret(SecretName name) {
   /**
    * Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   secretManagerServiceClient.deleteSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
    *     to delete in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -469,6 +769,19 @@ public final void deleteSecret(String name) {
   /**
    * Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DeleteSecretRequest request =
+   *       DeleteSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   secretManagerServiceClient.deleteSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -481,6 +794,20 @@ public final void deleteSecret(DeleteSecretRequest request) {
    * Deletes a [Secret][google.cloud.secretmanager.v1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DeleteSecretRequest request =
+   *       DeleteSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   ApiFuture<Empty> future =
+   *       secretManagerServiceClient.deleteSecretCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<DeleteSecretRequest, Empty> deleteSecretCallable() {
     return stub.deleteSecretCallable();
@@ -491,6 +818,19 @@ public final UnaryCallable<DeleteSecretRequest, Empty> deleteSecretCallable() {
    * Lists [SecretVersions][google.cloud.secretmanager.v1.SecretVersion]. This call does not return
    * secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+   *   for (SecretVersion element :
+   *       secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
    *     associated with the [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] to list,
    *     in the format `projects/&#42;/secrets/&#42;`.
@@ -509,6 +849,19 @@ public final ListSecretVersionsPagedResponse listSecretVersions(SecretName paren
    * Lists [SecretVersions][google.cloud.secretmanager.v1.SecretVersion]. This call does not return
    * secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   for (SecretVersion element :
+   *       secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secretmanager.v1.Secret]
    *     associated with the [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] to list,
    *     in the format `projects/&#42;/secrets/&#42;`.
@@ -525,6 +878,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(String parent) {
    * Lists [SecretVersions][google.cloud.secretmanager.v1.SecretVersion]. This call does not return
    * secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretVersionsRequest request =
+   *       ListSecretVersionsRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   for (SecretVersion element :
+   *       secretManagerServiceClient.listSecretVersions(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -539,6 +910,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
    * secret data.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretVersionsRequest request =
+   *       ListSecretVersionsRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.listSecretVersionsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (SecretVersion element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretVersionsRequest, ListSecretVersionsPagedResponse>
       listSecretVersionsPagedCallable() {
@@ -551,6 +940,25 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
    * secret data.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   while (true) {
+   *     ListSecretVersionsResponse response =
+   *         secretManagerServiceClient.listSecretVersionsCallable().call(request);
+   *     for (SecretVersion element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretVersionsRequest, ListSecretVersionsResponse>
       listSecretVersionsCallable() {
@@ -564,6 +972,16 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -584,6 +1002,16 @@ public final SecretVersion getSecretVersion(SecretVersionName name) {
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -603,6 +1031,19 @@ public final SecretVersion getSecretVersion(String name) {
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretVersionRequest request =
+   *       GetSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.getSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -618,6 +1059,20 @@ public final SecretVersion getSecretVersion(GetSecretVersionRequest request) {
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretVersionRequest request =
+   *       GetSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.getSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<GetSecretVersionRequest, SecretVersion> getSecretVersionCallable() {
     return stub.getSecretVersionCallable();
@@ -631,6 +1086,16 @@ public final UnaryCallable<GetSecretVersionRequest, SecretVersion> getSecretVers
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -652,6 +1117,16 @@ public final AccessSecretVersionResponse accessSecretVersion(SecretVersionName n
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -671,6 +1146,20 @@ public final AccessSecretVersionResponse accessSecretVersion(String name) {
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AccessSecretVersionRequest request =
+   *       AccessSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   AccessSecretVersionResponse response =
+   *       secretManagerServiceClient.accessSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -687,6 +1176,20 @@ public final AccessSecretVersionResponse accessSecretVersion(AccessSecretVersion
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AccessSecretVersionRequest request =
+   *       AccessSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<AccessSecretVersionResponse> future =
+   *       secretManagerServiceClient.accessSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   AccessSecretVersionResponse response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<AccessSecretVersionRequest, AccessSecretVersionResponse>
       accessSecretVersionCallable() {
@@ -701,6 +1204,16 @@ public final AccessSecretVersionResponse accessSecretVersion(AccessSecretVersion
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
    * [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to disable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -722,6 +1235,16 @@ public final SecretVersion disableSecretVersion(SecretVersionName name) {
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
    * [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to disable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -741,6 +1264,19 @@ public final SecretVersion disableSecretVersion(String name) {
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
    * [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DisableSecretVersionRequest request =
+   *       DisableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.disableSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -757,6 +1293,20 @@ public final SecretVersion disableSecretVersion(DisableSecretVersionRequest requ
    * [DISABLED][google.cloud.secretmanager.v1.SecretVersion.State.DISABLED].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DisableSecretVersionRequest request =
+   *       DisableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.disableSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<DisableSecretVersionRequest, SecretVersion>
       disableSecretVersionCallable() {
@@ -771,6 +1321,16 @@ public final SecretVersion disableSecretVersion(DisableSecretVersionRequest requ
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
    * [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to enable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -792,6 +1352,16 @@ public final SecretVersion enableSecretVersion(SecretVersionName name) {
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
    * [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to enable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -811,6 +1381,19 @@ public final SecretVersion enableSecretVersion(String name) {
    * [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to
    * [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   EnableSecretVersionRequest request =
+   *       EnableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.enableSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -827,6 +1410,20 @@ public final SecretVersion enableSecretVersion(EnableSecretVersionRequest reques
    * [ENABLED][google.cloud.secretmanager.v1.SecretVersion.State.ENABLED].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   EnableSecretVersionRequest request =
+   *       EnableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.enableSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<EnableSecretVersionRequest, SecretVersion>
       enableSecretVersionCallable() {
@@ -842,6 +1439,16 @@ public final SecretVersion enableSecretVersion(EnableSecretVersionRequest reques
    * [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED] and irrevocably
    * destroys the secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to destroy in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -864,6 +1471,16 @@ public final SecretVersion destroySecretVersion(SecretVersionName name) {
    * [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED] and irrevocably
    * destroys the secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secretmanager.v1.SecretVersion] to destroy in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -884,6 +1501,19 @@ public final SecretVersion destroySecretVersion(String name) {
    * [DESTROYED][google.cloud.secretmanager.v1.SecretVersion.State.DESTROYED] and irrevocably
    * destroys the secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DestroySecretVersionRequest request =
+   *       DestroySecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.destroySecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -901,6 +1531,20 @@ public final SecretVersion destroySecretVersion(DestroySecretVersionRequest requ
    * destroys the secret data.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DestroySecretVersionRequest request =
+   *       DestroySecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.destroySecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<DestroySecretVersionRequest, SecretVersion>
       destroySecretVersionCallable() {
@@ -914,6 +1558,20 @@ public final SecretVersion destroySecretVersion(DestroySecretVersionRequest requ
    * <p>Permissions on [SecretVersions][google.cloud.secretmanager.v1.SecretVersion] are enforced
    * according to the policy set on the associated [Secret][google.cloud.secretmanager.v1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SetIamPolicyRequest request =
+   *       SetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPolicy(Policy.newBuilder().build())
+   *           .build();
+   *   Policy response = secretManagerServiceClient.setIamPolicy(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -929,6 +1587,21 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
    * according to the policy set on the associated [Secret][google.cloud.secretmanager.v1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SetIamPolicyRequest request =
+   *       SetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPolicy(Policy.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Policy> future =
+   *       secretManagerServiceClient.setIamPolicyCallable().futureCall(request);
+   *   // Do something.
+   *   Policy response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<SetIamPolicyRequest, Policy> setIamPolicyCallable() {
     return stub.setIamPolicyCallable();
@@ -939,6 +1612,20 @@ public final UnaryCallable<SetIamPolicyRequest, Policy> setIamPolicyCallable() {
    * Gets the access control policy for a secret. Returns empty policy if the secret exists and does
    * not have a policy set.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetIamPolicyRequest request =
+   *       GetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setOptions(GetPolicyOptions.newBuilder().build())
+   *           .build();
+   *   Policy response = secretManagerServiceClient.getIamPolicy(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -952,6 +1639,21 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
    * not have a policy set.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetIamPolicyRequest request =
+   *       GetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setOptions(GetPolicyOptions.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Policy> future =
+   *       secretManagerServiceClient.getIamPolicyCallable().futureCall(request);
+   *   // Do something.
+   *   Policy response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<GetIamPolicyRequest, Policy> getIamPolicyCallable() {
     return stub.getIamPolicyCallable();
@@ -966,6 +1668,20 @@ public final UnaryCallable<GetIamPolicyRequest, Policy> getIamPolicyCallable() {
    * command-line tools, not for authorization checking. This operation may "fail open" without
    * warning.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   TestIamPermissionsRequest request =
+   *       TestIamPermissionsRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .addAllPermissions(new ArrayList<String>())
+   *           .build();
+   *   TestIamPermissionsResponse response = secretManagerServiceClient.testIamPermissions(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -983,6 +1699,21 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
    * warning.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   TestIamPermissionsRequest request =
+   *       TestIamPermissionsRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .addAllPermissions(new ArrayList<String>())
+   *           .build();
+   *   ApiFuture<TestIamPermissionsResponse> future =
+   *       secretManagerServiceClient.testIamPermissionsCallable().futureCall(request);
+   *   // Do something.
+   *   TestIamPermissionsResponse response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<TestIamPermissionsRequest, TestIamPermissionsResponse>
       testIamPermissionsCallable() {
diff --git a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/package-info.java b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/package-info.java
index a231a797..3625ade9 100644
--- a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/package-info.java
+++ b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1/package-info.java
@@ -30,6 +30,16 @@
  * </ul>
  *
  * <p>Sample for SecretManagerServiceClient:
+ *
+ * <pre>{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ *     SecretManagerServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   String secretId = "secretId945974251";
+ *   Secret secret = Secret.newBuilder().build();
+ *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 package com.google.cloud.secretmanager.v1;
diff --git a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java
index dcd6f27a..bfcc3acb 100644
--- a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java
+++ b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/SecretManagerServiceClient.java
@@ -56,6 +56,16 @@
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
  *
+ * <pre>{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ *     SecretManagerServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   String secretId = "secretId945974251";
+ *   Secret secret = Secret.newBuilder().build();
+ *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }</pre>
+ *
  * <p>Note: close() needs to be called on the SecretManagerServiceClient object to clean up
  * resources such as threads. In the example above, try-with-resources is used, which automatically
  * calls close().
@@ -163,6 +173,18 @@ public SecretManagerServiceStub getStub() {
   /**
    * Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project associated with the
    *     [Secrets][google.cloud.secrets.v1beta1.Secret], in the format `projects/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -179,6 +201,18 @@ public final ListSecretsPagedResponse listSecrets(ProjectName parent) {
   /**
    * Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   for (Secret element : secretManagerServiceClient.listSecrets(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project associated with the
    *     [Secrets][google.cloud.secrets.v1beta1.Secret], in the format `projects/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -192,6 +226,23 @@ public final ListSecretsPagedResponse listSecrets(String parent) {
   /**
    * Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretsRequest request =
+   *       ListSecretsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   for (Secret element : secretManagerServiceClient.listSecrets(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -204,6 +255,24 @@ public final ListSecretsPagedResponse listSecrets(ListSecretsRequest request) {
    * Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretsRequest request =
+   *       ListSecretsRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   ApiFuture<Secret> future =
+   *       secretManagerServiceClient.listSecretsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (Secret element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretsRequest, ListSecretsPagedResponse>
       listSecretsPagedCallable() {
@@ -215,6 +284,25 @@ public final ListSecretsPagedResponse listSecrets(ListSecretsRequest request) {
    * Lists [Secrets][google.cloud.secrets.v1beta1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   while (true) {
+   *     ListSecretsResponse response =
+   *         secretManagerServiceClient.listSecretsCallable().call(request);
+   *     for (Secret element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretsRequest, ListSecretsResponse> listSecretsCallable() {
     return stub.listSecretsCallable();
@@ -225,6 +313,18 @@ public final UnaryCallable<ListSecretsRequest, ListSecretsResponse> listSecretsC
    * Creates a new [Secret][google.cloud.secrets.v1beta1.Secret] containing no
    * [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ProjectName parent = ProjectName.of("[PROJECT]");
+   *   String secretId = "secretId945974251";
+   *   Secret secret = Secret.newBuilder().build();
+   *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project to associate with the
    *     [Secret][google.cloud.secrets.v1beta1.Secret], in the format `projects/&#42;`.
    * @param secretId Required. This must be unique within the project.
@@ -250,6 +350,18 @@ public final Secret createSecret(ProjectName parent, String secretId, Secret sec
    * Creates a new [Secret][google.cloud.secrets.v1beta1.Secret] containing no
    * [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = ProjectName.of("[PROJECT]").toString();
+   *   String secretId = "secretId945974251";
+   *   Secret secret = Secret.newBuilder().build();
+   *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the project to associate with the
    *     [Secret][google.cloud.secrets.v1beta1.Secret], in the format `projects/&#42;`.
    * @param secretId Required. This must be unique within the project.
@@ -275,6 +387,21 @@ public final Secret createSecret(String parent, String secretId, Secret secret)
    * Creates a new [Secret][google.cloud.secrets.v1beta1.Secret] containing no
    * [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   CreateSecretRequest request =
+   *       CreateSecretRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setSecretId("secretId945974251")
+   *           .setSecret(Secret.newBuilder().build())
+   *           .build();
+   *   Secret response = secretManagerServiceClient.createSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -288,6 +415,22 @@ public final Secret createSecret(CreateSecretRequest request) {
    * [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   CreateSecretRequest request =
+   *       CreateSecretRequest.newBuilder()
+   *           .setParent(ProjectName.of("[PROJECT]").toString())
+   *           .setSecretId("secretId945974251")
+   *           .setSecret(Secret.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Secret> future =
+   *       secretManagerServiceClient.createSecretCallable().futureCall(request);
+   *   // Do something.
+   *   Secret response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<CreateSecretRequest, Secret> createSecretCallable() {
     return stub.createSecretCallable();
@@ -298,6 +441,17 @@ public final UnaryCallable<CreateSecretRequest, Secret> createSecretCallable() {
    * Creates a new [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] containing secret
    * data and attaches it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+   *   SecretPayload payload = SecretPayload.newBuilder().build();
+   *   SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
    *     to associate with the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the
    *     format `projects/&#42;/secrets/&#42;`.
@@ -319,6 +473,17 @@ public final SecretVersion addSecretVersion(SecretName parent, SecretPayload pay
    * Creates a new [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] containing secret
    * data and attaches it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   SecretPayload payload = SecretPayload.newBuilder().build();
+   *   SecretVersion response = secretManagerServiceClient.addSecretVersion(parent, payload);
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
    *     to associate with the [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the
    *     format `projects/&#42;/secrets/&#42;`.
@@ -337,6 +502,20 @@ public final SecretVersion addSecretVersion(String parent, SecretPayload payload
    * Creates a new [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] containing secret
    * data and attaches it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AddSecretVersionRequest request =
+   *       AddSecretVersionRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPayload(SecretPayload.newBuilder().build())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.addSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -350,6 +529,21 @@ public final SecretVersion addSecretVersion(AddSecretVersionRequest request) {
    * data and attaches it to an existing [Secret][google.cloud.secrets.v1beta1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AddSecretVersionRequest request =
+   *       AddSecretVersionRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPayload(SecretPayload.newBuilder().build())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.addSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<AddSecretVersionRequest, SecretVersion> addSecretVersionCallable() {
     return stub.addSecretVersionCallable();
@@ -359,6 +553,16 @@ public final UnaryCallable<AddSecretVersionRequest, SecretVersion> addSecretVers
   /**
    * Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+   *   Secret response = secretManagerServiceClient.getSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret],
    *     in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -373,6 +577,16 @@ public final Secret getSecret(SecretName name) {
   /**
    * Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   Secret response = secretManagerServiceClient.getSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret],
    *     in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -386,6 +600,19 @@ public final Secret getSecret(String name) {
   /**
    * Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretRequest request =
+   *       GetSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   Secret response = secretManagerServiceClient.getSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -398,6 +625,19 @@ public final Secret getSecret(GetSecretRequest request) {
    * Gets metadata for a given [Secret][google.cloud.secrets.v1beta1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretRequest request =
+   *       GetSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   ApiFuture<Secret> future = secretManagerServiceClient.getSecretCallable().futureCall(request);
+   *   // Do something.
+   *   Secret response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<GetSecretRequest, Secret> getSecretCallable() {
     return stub.getSecretCallable();
@@ -407,6 +647,17 @@ public final UnaryCallable<GetSecretRequest, Secret> getSecretCallable() {
   /**
    * Updates metadata of an existing [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   Secret secret = Secret.newBuilder().build();
+   *   FieldMask updateMask = FieldMask.newBuilder().build();
+   *   Secret response = secretManagerServiceClient.updateSecret(secret, updateMask);
+   * }
+   * }</pre>
+   *
    * @param secret Required. [Secret][google.cloud.secrets.v1beta1.Secret] with updated field
    *     values.
    * @param updateMask Required. Specifies the fields to be updated.
@@ -422,6 +673,20 @@ public final Secret updateSecret(Secret secret, FieldMask updateMask) {
   /**
    * Updates metadata of an existing [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   UpdateSecretRequest request =
+   *       UpdateSecretRequest.newBuilder()
+   *           .setSecret(Secret.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   Secret response = secretManagerServiceClient.updateSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -434,6 +699,21 @@ public final Secret updateSecret(UpdateSecretRequest request) {
    * Updates metadata of an existing [Secret][google.cloud.secrets.v1beta1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   UpdateSecretRequest request =
+   *       UpdateSecretRequest.newBuilder()
+   *           .setSecret(Secret.newBuilder().build())
+   *           .setUpdateMask(FieldMask.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Secret> future =
+   *       secretManagerServiceClient.updateSecretCallable().futureCall(request);
+   *   // Do something.
+   *   Secret response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<UpdateSecretRequest, Secret> updateSecretCallable() {
     return stub.updateSecretCallable();
@@ -443,6 +723,16 @@ public final UnaryCallable<UpdateSecretRequest, Secret> updateSecretCallable() {
   /**
    * Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName name = SecretName.of("[PROJECT]", "[SECRET]");
+   *   secretManagerServiceClient.deleteSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] to
    *     delete in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -457,6 +747,16 @@ public final void deleteSecret(SecretName name) {
   /**
    * Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   secretManagerServiceClient.deleteSecret(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret] to
    *     delete in the format `projects/&#42;/secrets/&#42;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -470,6 +770,19 @@ public final void deleteSecret(String name) {
   /**
    * Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DeleteSecretRequest request =
+   *       DeleteSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   secretManagerServiceClient.deleteSecret(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -482,6 +795,20 @@ public final void deleteSecret(DeleteSecretRequest request) {
    * Deletes a [Secret][google.cloud.secrets.v1beta1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DeleteSecretRequest request =
+   *       DeleteSecretRequest.newBuilder()
+   *           .setName(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .build();
+   *   ApiFuture<Empty> future =
+   *       secretManagerServiceClient.deleteSecretCallable().futureCall(request);
+   *   // Do something.
+   *   future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<DeleteSecretRequest, Empty> deleteSecretCallable() {
     return stub.deleteSecretCallable();
@@ -492,6 +819,19 @@ public final UnaryCallable<DeleteSecretRequest, Empty> deleteSecretCallable() {
    * Lists [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion]. This call does not return
    * secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretName parent = SecretName.of("[PROJECT]", "[SECRET]");
+   *   for (SecretVersion element :
+   *       secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
    *     associated with the [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] to list,
    *     in the format `projects/&#42;/secrets/&#42;`.
@@ -510,6 +850,19 @@ public final ListSecretVersionsPagedResponse listSecretVersions(SecretName paren
    * Lists [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion]. This call does not return
    * secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String parent = SecretName.of("[PROJECT]", "[SECRET]").toString();
+   *   for (SecretVersion element :
+   *       secretManagerServiceClient.listSecretVersions(parent).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param parent Required. The resource name of the [Secret][google.cloud.secrets.v1beta1.Secret]
    *     associated with the [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] to list,
    *     in the format `projects/&#42;/secrets/&#42;`.
@@ -526,6 +879,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(String parent) {
    * Lists [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion]. This call does not return
    * secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretVersionsRequest request =
+   *       ListSecretVersionsRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   for (SecretVersion element :
+   *       secretManagerServiceClient.listSecretVersions(request).iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -540,6 +911,24 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
    * secret data.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   ListSecretVersionsRequest request =
+   *       ListSecretVersionsRequest.newBuilder()
+   *           .setParent(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPageSize(883849137)
+   *           .setPageToken("pageToken873572522")
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.listSecretVersionsPagedCallable().futureCall(request);
+   *   // Do something.
+   *   for (SecretVersion element : future.get().iterateAll()) {
+   *     // doThingsWith(element);
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretVersionsRequest, ListSecretVersionsPagedResponse>
       listSecretVersionsPagedCallable() {
@@ -552,6 +941,25 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
    * secret data.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   while (true) {
+   *     ListSecretVersionsResponse response =
+   *         secretManagerServiceClient.listSecretVersionsCallable().call(request);
+   *     for (SecretVersion element : response.getResponsesList()) {
+   *       // doThingsWith(element);
+   *     }
+   *     String nextPageToken = response.getNextPageToken();
+   *     if (!Strings.isNullOrEmpty(nextPageToken)) {
+   *       request = request.toBuilder().setPageToken(nextPageToken).build();
+   *     } else {
+   *       break;
+   *     }
+   *   }
+   * }
+   * }</pre>
    */
   public final UnaryCallable<ListSecretVersionsRequest, ListSecretVersionsResponse>
       listSecretVersionsCallable() {
@@ -565,6 +973,16 @@ public final ListSecretVersionsPagedResponse listSecretVersions(
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -585,6 +1003,16 @@ public final SecretVersion getSecretVersion(SecretVersionName name) {
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.getSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -604,6 +1032,19 @@ public final SecretVersion getSecretVersion(String name) {
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretVersionRequest request =
+   *       GetSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.getSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -619,6 +1060,20 @@ public final SecretVersion getSecretVersion(GetSecretVersionRequest request) {
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetSecretVersionRequest request =
+   *       GetSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.getSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<GetSecretVersionRequest, SecretVersion> getSecretVersionCallable() {
     return stub.getSecretVersionCallable();
@@ -632,6 +1087,16 @@ public final UnaryCallable<GetSecretVersionRequest, SecretVersion> getSecretVers
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -653,6 +1118,16 @@ public final AccessSecretVersionResponse accessSecretVersion(SecretVersionName n
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   AccessSecretVersionResponse response = secretManagerServiceClient.accessSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -672,6 +1147,20 @@ public final AccessSecretVersionResponse accessSecretVersion(String name) {
    * <p>`projects/&#42;/secrets/&#42;/versions/latest` is an alias to the `latest`
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AccessSecretVersionRequest request =
+   *       AccessSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   AccessSecretVersionResponse response =
+   *       secretManagerServiceClient.accessSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -688,6 +1177,20 @@ public final AccessSecretVersionResponse accessSecretVersion(AccessSecretVersion
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   AccessSecretVersionRequest request =
+   *       AccessSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<AccessSecretVersionResponse> future =
+   *       secretManagerServiceClient.accessSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   AccessSecretVersionResponse response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<AccessSecretVersionRequest, AccessSecretVersionResponse>
       accessSecretVersionCallable() {
@@ -702,6 +1205,16 @@ public final AccessSecretVersionResponse accessSecretVersion(AccessSecretVersion
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
    * [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to disable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -723,6 +1236,16 @@ public final SecretVersion disableSecretVersion(SecretVersionName name) {
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
    * [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.disableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to disable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -742,6 +1265,19 @@ public final SecretVersion disableSecretVersion(String name) {
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
    * [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DisableSecretVersionRequest request =
+   *       DisableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.disableSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -758,6 +1294,20 @@ public final SecretVersion disableSecretVersion(DisableSecretVersionRequest requ
    * [DISABLED][google.cloud.secrets.v1beta1.SecretVersion.State.DISABLED].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DisableSecretVersionRequest request =
+   *       DisableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.disableSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<DisableSecretVersionRequest, SecretVersion>
       disableSecretVersionCallable() {
@@ -772,6 +1322,16 @@ public final SecretVersion disableSecretVersion(DisableSecretVersionRequest requ
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
    * [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to enable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -793,6 +1353,16 @@ public final SecretVersion enableSecretVersion(SecretVersionName name) {
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
    * [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.enableSecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to enable in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -812,6 +1382,19 @@ public final SecretVersion enableSecretVersion(String name) {
    * [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to
    * [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   EnableSecretVersionRequest request =
+   *       EnableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.enableSecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -828,6 +1411,20 @@ public final SecretVersion enableSecretVersion(EnableSecretVersionRequest reques
    * [ENABLED][google.cloud.secrets.v1beta1.SecretVersion.State.ENABLED].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   EnableSecretVersionRequest request =
+   *       EnableSecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.enableSecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<EnableSecretVersionRequest, SecretVersion>
       enableSecretVersionCallable() {
@@ -843,6 +1440,16 @@ public final SecretVersion enableSecretVersion(EnableSecretVersionRequest reques
    * [DESTROYED][google.cloud.secrets.v1beta1.SecretVersion.State.DESTROYED] and irrevocably
    * destroys the secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SecretVersionName name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]");
+   *   SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to destroy in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -865,6 +1472,16 @@ public final SecretVersion destroySecretVersion(SecretVersionName name) {
    * [DESTROYED][google.cloud.secrets.v1beta1.SecretVersion.State.DESTROYED] and irrevocably
    * destroys the secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   String name = SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString();
+   *   SecretVersion response = secretManagerServiceClient.destroySecretVersion(name);
+   * }
+   * }</pre>
+   *
    * @param name Required. The resource name of the
    *     [SecretVersion][google.cloud.secrets.v1beta1.SecretVersion] to destroy in the format
    *     `projects/&#42;/secrets/&#42;/versions/&#42;`.
@@ -885,6 +1502,19 @@ public final SecretVersion destroySecretVersion(String name) {
    * [DESTROYED][google.cloud.secrets.v1beta1.SecretVersion.State.DESTROYED] and irrevocably
    * destroys the secret data.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DestroySecretVersionRequest request =
+   *       DestroySecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   SecretVersion response = secretManagerServiceClient.destroySecretVersion(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -902,6 +1532,20 @@ public final SecretVersion destroySecretVersion(DestroySecretVersionRequest requ
    * destroys the secret data.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   DestroySecretVersionRequest request =
+   *       DestroySecretVersionRequest.newBuilder()
+   *           .setName(SecretVersionName.of("[PROJECT]", "[SECRET]", "[SECRET_VERSION]").toString())
+   *           .build();
+   *   ApiFuture<SecretVersion> future =
+   *       secretManagerServiceClient.destroySecretVersionCallable().futureCall(request);
+   *   // Do something.
+   *   SecretVersion response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<DestroySecretVersionRequest, SecretVersion>
       destroySecretVersionCallable() {
@@ -915,6 +1559,20 @@ public final SecretVersion destroySecretVersion(DestroySecretVersionRequest requ
    * <p>Permissions on [SecretVersions][google.cloud.secrets.v1beta1.SecretVersion] are enforced
    * according to the policy set on the associated [Secret][google.cloud.secrets.v1beta1.Secret].
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SetIamPolicyRequest request =
+   *       SetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPolicy(Policy.newBuilder().build())
+   *           .build();
+   *   Policy response = secretManagerServiceClient.setIamPolicy(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -930,6 +1588,21 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
    * according to the policy set on the associated [Secret][google.cloud.secrets.v1beta1.Secret].
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   SetIamPolicyRequest request =
+   *       SetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setPolicy(Policy.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Policy> future =
+   *       secretManagerServiceClient.setIamPolicyCallable().futureCall(request);
+   *   // Do something.
+   *   Policy response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<SetIamPolicyRequest, Policy> setIamPolicyCallable() {
     return stub.setIamPolicyCallable();
@@ -940,6 +1613,20 @@ public final UnaryCallable<SetIamPolicyRequest, Policy> setIamPolicyCallable() {
    * Gets the access control policy for a secret. Returns empty policy if the secret exists and does
    * not have a policy set.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetIamPolicyRequest request =
+   *       GetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setOptions(GetPolicyOptions.newBuilder().build())
+   *           .build();
+   *   Policy response = secretManagerServiceClient.getIamPolicy(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -953,6 +1640,21 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
    * not have a policy set.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   GetIamPolicyRequest request =
+   *       GetIamPolicyRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .setOptions(GetPolicyOptions.newBuilder().build())
+   *           .build();
+   *   ApiFuture<Policy> future =
+   *       secretManagerServiceClient.getIamPolicyCallable().futureCall(request);
+   *   // Do something.
+   *   Policy response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<GetIamPolicyRequest, Policy> getIamPolicyCallable() {
     return stub.getIamPolicyCallable();
@@ -967,6 +1669,20 @@ public final UnaryCallable<GetIamPolicyRequest, Policy> getIamPolicyCallable() {
    * command-line tools, not for authorization checking. This operation may "fail open" without
    * warning.
    *
+   * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   TestIamPermissionsRequest request =
+   *       TestIamPermissionsRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .addAllPermissions(new ArrayList<String>())
+   *           .build();
+   *   TestIamPermissionsResponse response = secretManagerServiceClient.testIamPermissions(request);
+   * }
+   * }</pre>
+   *
    * @param request The request object containing all of the parameters for the API call.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
@@ -984,6 +1700,21 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
    * warning.
    *
    * <p>Sample code:
+   *
+   * <pre>{@code
+   * try (SecretManagerServiceClient secretManagerServiceClient =
+   *     SecretManagerServiceClient.create()) {
+   *   TestIamPermissionsRequest request =
+   *       TestIamPermissionsRequest.newBuilder()
+   *           .setResource(SecretName.of("[PROJECT]", "[SECRET]").toString())
+   *           .addAllPermissions(new ArrayList<String>())
+   *           .build();
+   *   ApiFuture<TestIamPermissionsResponse> future =
+   *       secretManagerServiceClient.testIamPermissionsCallable().futureCall(request);
+   *   // Do something.
+   *   TestIamPermissionsResponse response = future.get();
+   * }
+   * }</pre>
    */
   public final UnaryCallable<TestIamPermissionsRequest, TestIamPermissionsResponse>
       testIamPermissionsCallable() {
diff --git a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/package-info.java b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/package-info.java
index 588a0519..3c510728 100644
--- a/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/package-info.java
+++ b/google-cloud-secretmanager/src/main/java/com/google/cloud/secretmanager/v1beta1/package-info.java
@@ -30,6 +30,16 @@
  * </ul>
  *
  * <p>Sample for SecretManagerServiceClient:
+ *
+ * <pre>{@code
+ * try (SecretManagerServiceClient secretManagerServiceClient =
+ *     SecretManagerServiceClient.create()) {
+ *   ProjectName parent = ProjectName.of("[PROJECT]");
+ *   String secretId = "secretId945974251";
+ *   Secret secret = Secret.newBuilder().build();
+ *   Secret response = secretManagerServiceClient.createSecret(parent, secretId, secret);
+ * }
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 package com.google.cloud.secretmanager.v1beta1;
diff --git a/synth.metadata b/synth.metadata
index 202af4b7..1e981ae2 100644
--- a/synth.metadata
+++ b/synth.metadata
@@ -4,15 +4,15 @@
       "git": {
         "name": ".",
         "remote": "https://github.com/googleapis/java-secretmanager.git",
-        "sha": "5822b254a545c0316241b7142fa551ff266daa0b"
+        "sha": "77ecec01eb733b0b1871591dade7743d9f35bb29"
       }
     },
     {
       "git": {
         "name": "googleapis",
         "remote": "https://github.com/googleapis/googleapis.git",
-        "sha": "9ecdacc9a00e1dd443b11bf10215d6e7648db8a7",
-        "internalRef": "352563582"
+        "sha": "8d8c008e56f1af31d57f75561e0f1848ffb29eeb",
+        "internalRef": "356341083"
       }
     },
     {