docs: generate sample code in the javadocs (#355)

* feat: generate sample code in the Java microgenerator

Committer: @miraleung
PiperOrigin-RevId: 356341083

Source-Author: Google APIs <noreply@google.com>
Source-Date: Mon Feb 8 13:33:28 2021 -0800
Source-Repo: googleapis/googleapis
Source-Sha: 8d8c008e56f1af31d57f75561e0f1848ffb29eeb
Source-Link: googleapis/googleapis@8d8c008

* chore: update gapic-generator-java to 0.0.20

Committer: @miraleung
PiperOrigin-RevId: 357800868

Source-Author: Google APIs <noreply@google.com>
Source-Date: Tue Feb 16 14:06:04 2021 -0800
Source-Repo: googleapis/googleapis
Source-Sha: e8bc4471a88ac5f60defe3ed436f517174e59ba0
Source-Link: googleapis/googleapis@e8bc447

google-cloud-game-servers/src/main/java/com/google/cloud/gaming/v1/package-info.java

@@ -24,25 +24,60 @@
  *
  * <p>Sample for GameServerClustersServiceClient:
  *
+ * <pre>{@code
+ * try (GameServerClustersServiceClient gameServerClustersServiceClient =
+ *     GameServerClustersServiceClient.create()) {
+ *   GameServerClusterName name =
+ *       GameServerClusterName.of("[PROJECT]", "[LOCATION]", "[REALM]", "[CLUSTER]");
+ *   GameServerCluster response = gameServerClustersServiceClient.getGameServerCluster(name);
+ * }
+ * }</pre>
+ *
  * <p>======================= GameServerConfigsServiceClient =======================
  *
  * <p>Service Description: The game server config configures the game servers in an Agones fleet.
  *
  * <p>Sample for GameServerConfigsServiceClient:
  *
+ * <pre>{@code
+ * try (GameServerConfigsServiceClient gameServerConfigsServiceClient =
+ *     GameServerConfigsServiceClient.create()) {
+ *   GameServerConfigName name =
+ *       GameServerConfigName.of("[PROJECT]", "[LOCATION]", "[DEPLOYMENT]", "[CONFIG]");
+ *   GameServerConfig response = gameServerConfigsServiceClient.getGameServerConfig(name);
+ * }
+ * }</pre>
+ *
  * <p>======================= GameServerDeploymentsServiceClient =======================
  *
  * <p>Service Description: The game server deployment is used to control the deployment of Agones
  * fleets.
  *
  * <p>Sample for GameServerDeploymentsServiceClient:
  *
+ * <pre>{@code
+ * try (GameServerDeploymentsServiceClient gameServerDeploymentsServiceClient =
+ *     GameServerDeploymentsServiceClient.create()) {
+ *   GameServerDeploymentName name =
+ *       GameServerDeploymentName.of("[PROJECT]", "[LOCATION]", "[DEPLOYMENT]");
+ *   GameServerDeployment response =
+ *       gameServerDeploymentsServiceClient.getGameServerDeployment(name);
+ * }
+ * }</pre>
+ *
  * <p>======================= RealmsServiceClient =======================
  *
  * <p>Service Description: A realm is a grouping of game server clusters that are considered
  * interchangeable.
  *
  * <p>Sample for RealmsServiceClient:
+ *
+ * <pre>{@code
+ * try (RealmsServiceClient realmsServiceClient = RealmsServiceClient.create()) {
+ *   RealmName name = RealmName.of("[PROJECT]", "[LOCATION]", "[REALM]");
+ *   Realm response = realmsServiceClient.getRealm(name);
+ * }
+ * }</pre>
  */
 @Generated("by gapic-generator-java")
 package com.google.cloud.gaming.v1;

google-cloud-game-servers/src/main/java/com/google/cloud/gaming/v1/stub/GrpcGameServerClustersServiceStub.java

@@ -439,63 +439,75 @@ public GrpcOperationsStub getOperationsStub() {
     return operationsStub;
   }
 
+  @Override
   public UnaryCallable<ListGameServerClustersRequest, ListGameServerClustersResponse>
       listGameServerClustersCallable() {
     return listGameServerClustersCallable;
   }
 
+  @Override
   public UnaryCallable<ListGameServerClustersRequest, ListGameServerClustersPagedResponse>
       listGameServerClustersPagedCallable() {
     return listGameServerClustersPagedCallable;
   }
 
+  @Override
   public UnaryCallable<GetGameServerClusterRequest, GameServerCluster>
       getGameServerClusterCallable() {
     return getGameServerClusterCallable;
   }
 
+  @Override
   public UnaryCallable<CreateGameServerClusterRequest, Operation>
       createGameServerClusterCallable() {
     return createGameServerClusterCallable;
   }
 
+  @Override
   public OperationCallable<CreateGameServerClusterRequest, GameServerCluster, OperationMetadata>
       createGameServerClusterOperationCallable() {
     return createGameServerClusterOperationCallable;
   }
 
+  @Override
   public UnaryCallable<
           PreviewCreateGameServerClusterRequest, PreviewCreateGameServerClusterResponse>
       previewCreateGameServerClusterCallable() {
     return previewCreateGameServerClusterCallable;
   }
 
+  @Override
   public UnaryCallable<DeleteGameServerClusterRequest, Operation>
       deleteGameServerClusterCallable() {
     return deleteGameServerClusterCallable;
   }
 
+  @Override
   public OperationCallable<DeleteGameServerClusterRequest, Empty, OperationMetadata>
       deleteGameServerClusterOperationCallable() {
     return deleteGameServerClusterOperationCallable;
   }
 
+  @Override
   public UnaryCallable<
           PreviewDeleteGameServerClusterRequest, PreviewDeleteGameServerClusterResponse>
       previewDeleteGameServerClusterCallable() {
     return previewDeleteGameServerClusterCallable;
   }
 
+  @Override
   public UnaryCallable<UpdateGameServerClusterRequest, Operation>
       updateGameServerClusterCallable() {
     return updateGameServerClusterCallable;
   }
 
+  @Override
   public OperationCallable<UpdateGameServerClusterRequest, GameServerCluster, OperationMetadata>
       updateGameServerClusterOperationCallable() {
     return updateGameServerClusterOperationCallable;
   }
 
+  @Override
   public UnaryCallable<
           PreviewUpdateGameServerClusterRequest, PreviewUpdateGameServerClusterResponse>
       previewUpdateGameServerClusterCallable() {

google-cloud-game-servers/src/main/java/com/google/cloud/gaming/v1/stub/GrpcGameServerConfigsServiceStub.java

@@ -262,33 +262,40 @@ public GrpcOperationsStub getOperationsStub() {
     return operationsStub;
   }
 
+  @Override
   public UnaryCallable<ListGameServerConfigsRequest, ListGameServerConfigsResponse>
       listGameServerConfigsCallable() {
     return listGameServerConfigsCallable;
   }
 
+  @Override
   public UnaryCallable<ListGameServerConfigsRequest, ListGameServerConfigsPagedResponse>
       listGameServerConfigsPagedCallable() {
     return listGameServerConfigsPagedCallable;
   }
 
+  @Override
   public UnaryCallable<GetGameServerConfigRequest, GameServerConfig> getGameServerConfigCallable() {
     return getGameServerConfigCallable;
   }
 
+  @Override
   public UnaryCallable<CreateGameServerConfigRequest, Operation> createGameServerConfigCallable() {
     return createGameServerConfigCallable;
   }
 
+  @Override
   public OperationCallable<CreateGameServerConfigRequest, GameServerConfig, OperationMetadata>
       createGameServerConfigOperationCallable() {
     return createGameServerConfigOperationCallable;
   }
 
+  @Override
   public UnaryCallable<DeleteGameServerConfigRequest, Operation> deleteGameServerConfigCallable() {
     return deleteGameServerConfigCallable;
   }
 
+  @Override
   public OperationCallable<DeleteGameServerConfigRequest, Empty, OperationMetadata>
       deleteGameServerConfigOperationCallable() {
     return deleteGameServerConfigOperationCallable;

google-cloud-game-servers/src/main/java/com/google/cloud/gaming/v1/stub/GrpcGameServerDeploymentsServiceStub.java

@@ -480,75 +480,89 @@ public GrpcOperationsStub getOperationsStub() {
     return operationsStub;
   }
 
+  @Override
   public UnaryCallable<ListGameServerDeploymentsRequest, ListGameServerDeploymentsResponse>
       listGameServerDeploymentsCallable() {
     return listGameServerDeploymentsCallable;
   }
 
+  @Override
   public UnaryCallable<ListGameServerDeploymentsRequest, ListGameServerDeploymentsPagedResponse>
       listGameServerDeploymentsPagedCallable() {
     return listGameServerDeploymentsPagedCallable;
   }
 
+  @Override
   public UnaryCallable<GetGameServerDeploymentRequest, GameServerDeployment>
       getGameServerDeploymentCallable() {
     return getGameServerDeploymentCallable;
   }
 
+  @Override
   public UnaryCallable<CreateGameServerDeploymentRequest, Operation>
       createGameServerDeploymentCallable() {
     return createGameServerDeploymentCallable;
   }
 
+  @Override
   public OperationCallable<
           CreateGameServerDeploymentRequest, GameServerDeployment, OperationMetadata>
       createGameServerDeploymentOperationCallable() {
     return createGameServerDeploymentOperationCallable;
   }
 
+  @Override
   public UnaryCallable<DeleteGameServerDeploymentRequest, Operation>
       deleteGameServerDeploymentCallable() {
     return deleteGameServerDeploymentCallable;
   }
 
+  @Override
   public OperationCallable<DeleteGameServerDeploymentRequest, Empty, OperationMetadata>
       deleteGameServerDeploymentOperationCallable() {
     return deleteGameServerDeploymentOperationCallable;
   }
 
+  @Override
   public UnaryCallable<UpdateGameServerDeploymentRequest, Operation>
       updateGameServerDeploymentCallable() {
     return updateGameServerDeploymentCallable;
   }
 
+  @Override
   public OperationCallable<
           UpdateGameServerDeploymentRequest, GameServerDeployment, OperationMetadata>
       updateGameServerDeploymentOperationCallable() {
     return updateGameServerDeploymentOperationCallable;
   }
 
+  @Override
   public UnaryCallable<GetGameServerDeploymentRolloutRequest, GameServerDeploymentRollout>
       getGameServerDeploymentRolloutCallable() {
     return getGameServerDeploymentRolloutCallable;
   }
 
+  @Override
   public UnaryCallable<UpdateGameServerDeploymentRolloutRequest, Operation>
       updateGameServerDeploymentRolloutCallable() {
     return updateGameServerDeploymentRolloutCallable;
   }
 
+  @Override
   public OperationCallable<
           UpdateGameServerDeploymentRolloutRequest, GameServerDeployment, OperationMetadata>
       updateGameServerDeploymentRolloutOperationCallable() {
     return updateGameServerDeploymentRolloutOperationCallable;
   }
 
+  @Override
   public UnaryCallable<
           PreviewGameServerDeploymentRolloutRequest, PreviewGameServerDeploymentRolloutResponse>
       previewGameServerDeploymentRolloutCallable() {
     return previewGameServerDeploymentRolloutCallable;
   }
 
+  @Override
   public UnaryCallable<FetchDeploymentStateRequest, FetchDeploymentStateResponse>
       fetchDeploymentStateCallable() {
     return fetchDeploymentStateCallable;

google-cloud-game-servers/src/main/java/com/google/cloud/gaming/v1/stub/GrpcRealmsServiceStub.java

@@ -294,45 +294,55 @@ public GrpcOperationsStub getOperationsStub() {
     return operationsStub;
   }
 
+  @Override
   public UnaryCallable<ListRealmsRequest, ListRealmsResponse> listRealmsCallable() {
     return listRealmsCallable;
   }
 
+  @Override
   public UnaryCallable<ListRealmsRequest, ListRealmsPagedResponse> listRealmsPagedCallable() {
     return listRealmsPagedCallable;
   }
 
+  @Override
   public UnaryCallable<GetRealmRequest, Realm> getRealmCallable() {
     return getRealmCallable;
   }
 
+  @Override
   public UnaryCallable<CreateRealmRequest, Operation> createRealmCallable() {
     return createRealmCallable;
   }
 
+  @Override
   public OperationCallable<CreateRealmRequest, Realm, OperationMetadata>
       createRealmOperationCallable() {
     return createRealmOperationCallable;
   }
 
+  @Override
   public UnaryCallable<DeleteRealmRequest, Operation> deleteRealmCallable() {
     return deleteRealmCallable;
   }
 
+  @Override
   public OperationCallable<DeleteRealmRequest, Empty, OperationMetadata>
       deleteRealmOperationCallable() {
     return deleteRealmOperationCallable;
   }
 
+  @Override
   public UnaryCallable<UpdateRealmRequest, Operation> updateRealmCallable() {
     return updateRealmCallable;
   }
 
+  @Override
   public OperationCallable<UpdateRealmRequest, Realm, OperationMetadata>
       updateRealmOperationCallable() {
     return updateRealmOperationCallable;
   }
 
+  @Override
   public UnaryCallable<PreviewRealmUpdateRequest, PreviewRealmUpdateResponse>
       previewRealmUpdateCallable() {
     return previewRealmUpdateCallable;