From dd8b28d035c8d9cabf3c8814724cb24e88696c76 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Thu, 12 Oct 2023 15:55:46 -0400 Subject: [PATCH 01/21] feat: update javadocs for Client classes to include table of methods and method variants --- .../comment/ServiceClientCommentComposer.java | 154 +++- .../AbstractServiceClientClassComposer.java | 63 +- .../grpcrest/ServiceClientClassComposer.java | 4 +- .../api/generator/gapic/model/Method.java | 8 + ...cServiceClientWithNestedClassImport.golden | 35 +- .../grpc/goldens/BookshopClient.golden | 42 +- .../goldens/DeprecatedServiceClient.golden | 53 +- .../composer/grpc/goldens/EchoClient.golden | 202 ++++- .../grpc/goldens/IdentityClient.golden | 132 ++- .../grpc/goldens/MessagingClient.golden | 315 ++++++- .../grpcrest/goldens/EchoClient.golden | 238 +++++- .../grpcrest/goldens/EchoEmpty.golden | 19 +- .../grpcrest/goldens/WickedClient.golden | 59 +- .../v1/ConnectionServiceClient.java | 44 +- .../cloud/apigeeconnect/v1/TetherClient.java | 37 +- .../cloud/asset/v1/AssetServiceClient.java | 523 +++++++++++- .../data/v2/BaseBigtableDataClient.java | 176 +++- .../compute/v1small/AddressesClient.java | 119 ++- .../v1small/RegionOperationsClient.java | 69 +- .../credentials/v1/IamCredentialsClient.java | 119 ++- .../com/google/iam/v1/IAMPolicyClient.java | 84 +- .../kms/v1/KeyManagementServiceClient.java | 746 +++++++++++++++- .../library/v1/LibraryServiceClient.java | 302 ++++++- .../google/cloud/logging/v2/ConfigClient.java | 686 ++++++++++++++- .../cloud/logging/v2/LoggingClient.java | 166 +++- .../cloud/logging/v2/MetricsClient.java | 145 +++- .../cloud/pubsub/v1/SchemaServiceClient.java | 329 ++++++- .../pubsub/v1/SubscriptionAdminClient.java | 538 +++++++++++- .../cloud/pubsub/v1/TopicAdminClient.java | 312 ++++++- .../cloud/redis/v1beta1/CloudRedisClient.java | 341 +++++++- .../com/google/storage/v2/StorageClient.java | 803 +++++++++++++++++- 31 files changed, 6497 insertions(+), 366 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index 5835c77935..e8194d09cb 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -27,7 +27,9 @@ import java.util.Arrays; import java.util.Collections; import java.util.List; +import java.util.Map; import java.util.Optional; +import java.util.stream.Collectors; public class ServiceClientCommentComposer { // Tokens. @@ -39,9 +41,6 @@ public class ServiceClientCommentComposer { private static final String SERVICE_DESCRIPTION_INTRO_STRING = "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:"; - private static final String SERVICE_DESCRIPTION_SURFACE_SUMMARY_STRING = - "The surface of this class includes several types of Java methods for each of the API's " - + "methods:"; private static final String SERVICE_DESCRIPTION_SURFACE_CODA_STRING = "See the individual methods for example code."; private static final String SERVICE_DESCRIPTION_RESOURCE_NAMES_FORMATTING_STRING = @@ -61,18 +60,6 @@ public class ServiceClientCommentComposer { private static final String METHOD_DESCRIPTION_SAMPLE_CODE_SUMMARY_STRING = "Sample code:"; - private static final List SERVICE_DESCRIPTION_SURFACE_DESCRIPTION = - Arrays.asList( - "A \"flattened\" method. With this type of method, the fields of the request type have" - + " been converted into function parameters. It may be the case that not all fields" - + " are available as parameters, and not every API method will have a flattened" - + " method entry point.", - "A \"request object\" method. This type of method only takes one parameter, a request" - + " object, which must be constructed before the call. Not every API method will" - + " have a request object method.", - "A \"callable\" method. This type of method takes no parameters and returns an immutable " - + "API callable object, which can be used to initiate calls to the service."); - // Patterns. private static final String CREATE_METHOD_STUB_ARG_PATTERN = "Constructs an instance of %s, using the given stub for making calls. This is for" @@ -109,6 +96,7 @@ public class ServiceClientCommentComposer { + " operation returned by another API method call."); public static List createClassHeaderComments( + Map> methodVariantsForClientHeader, Service service, String classMethodSampleCode, String credentialsSampleCode, @@ -132,8 +120,31 @@ public static List createClassHeaderComments( classHeaderJavadocBuilder.addParagraph( String.format( SERVICE_DESCRIPTION_CLOSE_PATTERN, ClassNames.getServiceClientClassName(service))); - classHeaderJavadocBuilder.addParagraph(SERVICE_DESCRIPTION_SURFACE_SUMMARY_STRING); - classHeaderJavadocBuilder.addOrderedList(SERVICE_DESCRIPTION_SURFACE_DESCRIPTION); + + // Build the map of methods and descriptions + Map mapOfMethodsAndDescriptions = + Collections.unmodifiableMap( + service.methods().stream() + .collect( + Collectors.toMap( + Method::getName, + method -> { + String description = method.getDescription(); + return description != null ? description : ""; + }))); + + // Build a list of MethodAndVariants to create the table + List methodAndVariantsList = new ArrayList<>(); + for (Map.Entry method : mapOfMethodsAndDescriptions.entrySet()) { + MethodAndVariants methodAndVariants = + new MethodAndVariants( + method.getKey(), + method.getValue(), + methodVariantsForClientHeader.get(method.getKey())); + methodAndVariantsList.add(methodAndVariants); + } + + classHeaderJavadocBuilder.addUnescapedComment(createTableOfMethods(methodAndVariantsList)); classHeaderJavadocBuilder.addParagraph(SERVICE_DESCRIPTION_SURFACE_CODA_STRING); // Formatting resource names. @@ -215,6 +226,115 @@ public static List createRpcMethodHeaderComment( return comments; } + private static String createTableOfMethods(List methodAndVariantsList) { + String FLATTENED_METHODS = + "

\"Flattened\" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

\n\n"; + String REQUEST_OBJECT_METHODS = + "

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

\n\n"; + String CALLABLE_METHODS = + "

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

\n\n"; + String ASYNC_METHODS = + "

Methods that return long-running operations have \"Async\" method variants that return `OperationFuture` which is used to track polling of the service.

\n\n"; + + StringBuilder tableBuilder = new StringBuilder(); + tableBuilder + .append("\n") + .append(" \n") + .append(" \n") + .append(" \n") + .append(" \n"); + for (MethodAndVariants method : methodAndVariantsList) { + tableBuilder + .append(" \n") + .append(" \n") + .append(" \n") + .append(" \n").append(" \n"); + } + tableBuilder.append("
MethodDescriptionMethod Variants
") + .append(method.method) + .append("") + .append(method.description) + .append("\n"); + if (method.hasRequestObjectVariants) { + tableBuilder + .append(" " + REQUEST_OBJECT_METHODS + " ") + .append("
    \n") + .append("
  • ") + .append(String.join("\n
  • ", method.requestObjectVariants)) + .append("\n") + .append("
") + .append("\n\n"); + } + if (method.hasFlattenedVariants) { + tableBuilder + .append(" " + FLATTENED_METHODS + " ") + .append("
    \n") + .append("
  • ") + .append(String.join("\n
  • ", method.flattenedVariants)) + .append("\n") + .append("
") + .append("\n\n"); + } + if (method.hasAsyncVariants) { + tableBuilder + .append(" " + ASYNC_METHODS + " ") + .append("
    \n") + .append("
  • ") + .append(String.join("\n
  • ", method.asyncVariants)) + .append("\n") + .append("
") + .append("\n\n"); + } + if (method.hasCallableVariants) { + tableBuilder + .append(" " + CALLABLE_METHODS + " ") + .append("
    \n") + .append("
  • ") + .append(String.join("\n
  • ", method.callableVariants)) + .append("\n") + .append("
") + .append("\n\n"); + } + tableBuilder.append("
\n"); + return tableBuilder.toString(); + } + + public static class MethodAndVariants { + String method; + String description; + boolean hasFlattenedVariants = false; + boolean hasRequestObjectVariants; + boolean hasCallableVariants; + boolean hasAsyncVariants; + + List flattenedVariants; + List requestObjectVariants; + List callableVariants; + List asyncVariants; + + public MethodAndVariants(String method, String description, List methodVariants) { + this.method = method; + this.description = description; + requestObjectVariants = + methodVariants.stream().filter(s -> s.contains("request")).collect(Collectors.toList()); + hasRequestObjectVariants = methodVariants.removeAll(requestObjectVariants); + // hasRequestObjectVariants = methodVariants.stream().anyMatch(s -> s.contains("request")); + callableVariants = + methodVariants.stream().filter(s -> s.contains("Callable")).collect(Collectors.toList()); + hasCallableVariants = methodVariants.removeAll(callableVariants); + // hasCallableVariants = methodVariants.stream().anyMatch(s -> s.contains("Callable")); + asyncVariants = + methodVariants.stream().filter(s -> s.contains("Async")).collect(Collectors.toList()); + hasAsyncVariants = methodVariants.removeAll(asyncVariants); + // hasAsyncVariants = methodVariants.stream().anyMatch(s -> s.contains("Async")); + // Whatever is remaining should just be flattened variants + flattenedVariants = methodVariants; + if (!flattenedVariants.isEmpty()) { + hasFlattenedVariants = true; + } + } + } + public static List createRpcMethodHeaderComment( Method method, Optional sampleCodeOpt) { return createRpcMethodHeaderComment(method, Collections.emptyList(), sampleCodeOpt); diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java index b6095be08b..4899df67f6 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java @@ -139,11 +139,10 @@ public GapicClass generate(GapicContext context, Service service) { List samples = new ArrayList<>(); Map> grpcRpcsToJavaMethodNames = new HashMap<>(); + Map> methodVariantsForClientHeader = new HashMap<>(); ClassDefinition classDef = ClassDefinition.builder() - .setHeaderCommentStatements( - createClassHeaderComments(service, typeStore, resourceNames, messageTypes, samples)) .setPackageString(pakkage) .setAnnotations(createClassAnnotations(service, typeStore)) .setScope(ScopeNode.PUBLIC) @@ -158,8 +157,17 @@ public GapicClass generate(GapicContext context, Service service) { resourceNames, hasLroClient, grpcRpcsToJavaMethodNames, + methodVariantsForClientHeader, samples)) .setNestedClasses(createNestedPagingClasses(service, messageTypes, typeStore)) + .setHeaderCommentStatements( + createClassHeaderComments( + methodVariantsForClientHeader, + service, + typeStore, + resourceNames, + messageTypes, + samples)) .build(); updateGapicMetadata(context, service, className, grpcRpcsToJavaMethodNames); @@ -189,6 +197,7 @@ private static List createClassImplements(TypeStore typeStore) { } protected List createClassHeaderComments( + Map> methodVariantsForClientHeader, Service service, TypeStore typeStore, Map resourceNames, @@ -207,6 +216,7 @@ protected List createClassHeaderComments( clientType, settingsType, service); samples.addAll(Arrays.asList(classMethodSampleCode, credentialsSampleCode, endpointSampleCode)); return ServiceClientCommentComposer.createClassHeaderComments( + methodVariantsForClientHeader, service, SampleCodeWriter.writeInlineSample(classMethodSampleCode.body()), SampleCodeWriter.writeInlineSample(credentialsSampleCode.body()), @@ -223,6 +233,7 @@ private List createClassMethods( Map resourceNames, boolean hasLroClient, Map> grpcRpcToJavaMethodMetadata, + Map> methodVariantsForClientHeader, List samples) { List methods = new ArrayList<>(); methods.addAll(createStaticCreatorMethods(service, typeStore)); @@ -230,7 +241,13 @@ private List createClassMethods( methods.addAll(createGetterMethods(service, typeStore, hasLroClient)); methods.addAll( createServiceMethods( - service, messageTypes, typeStore, resourceNames, grpcRpcToJavaMethodMetadata, samples)); + service, + messageTypes, + typeStore, + resourceNames, + grpcRpcToJavaMethodMetadata, + methodVariantsForClientHeader, + samples)); methods.addAll(createBackgroundResourceMethods(service, typeStore)); return methods; } @@ -567,12 +584,32 @@ private static List createServiceMethods( TypeStore typeStore, Map resourceNames, Map> grpcRpcToJavaMethodMetadata, + Map> methodVariantsForClientHeader, List samples) { List javaMethods = new ArrayList<>(); Function javaMethodNameFn = m -> m.methodIdentifier().name(); + // This generates the list of method variants with arguments for the Client header statements + Function javaMethodFn = + m -> { + String s; + if (m.arguments().isEmpty()) { + s = m.methodIdentifier().name() + "()"; + } else { + String argument = m.arguments().get(0).variable().type().reference() != null ? m.arguments().get(0).variable().type().reference().name() + " " : ""; + s = + m.methodIdentifier().name() + + "(" + + argument + + m.arguments().get(0).variable().identifier().name() + + ")"; + } + ; + return s; + }; for (Method method : service.methods()) { if (!grpcRpcToJavaMethodMetadata.containsKey(method.name())) { grpcRpcToJavaMethodMetadata.put(method.name(), new ArrayList<>()); + methodVariantsForClientHeader.put(method.name(), new ArrayList<>()); } if (method.stream().equals(Stream.NONE)) { List generatedMethods = @@ -592,6 +629,14 @@ private static List createServiceMethods( generatedMethods.stream() .map(m -> javaMethodNameFn.apply(m)) .collect(Collectors.toList())); + + // Collect data for Client header + methodVariantsForClientHeader + .get(method.name()) + .addAll( + generatedMethods.stream() + .map(m -> javaMethodFn.apply(m)) + .collect(Collectors.toList())); javaMethods.addAll(generatedMethods); MethodDefinition generatedMethod = @@ -604,8 +649,9 @@ private static List createServiceMethods( samples, service); - // Collect data for gapic_metadata.json. + // Collect data for gapic_metadata.json and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); javaMethods.add(generatedMethod); } if (method.hasLro()) { @@ -613,8 +659,9 @@ private static List createServiceMethods( createLroCallableMethod( service, method, typeStore, messageTypes, resourceNames, samples); - // Collect data for gapic_metadata.json. + // Collect data for gapic_metadata.json and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); javaMethods.add(generatedMethod); } if (method.isPaged()) { @@ -622,15 +669,17 @@ private static List createServiceMethods( createPagedCallableMethod( service, method, typeStore, messageTypes, resourceNames, samples); - // Collect data for gapic_metadata.json. + // Collect data for gapic_metadata.json and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); javaMethods.add(generatedMethod); } MethodDefinition generatedMethod = createCallableMethod(service, method, typeStore, messageTypes, resourceNames, samples); - // Collect data for the gapic_metadata.json file. + // Collect data for the gapic_metadata.json file and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); javaMethods.add(generatedMethod); } return javaMethods; diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java index c101c96469..3710f69492 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/grpcrest/ServiceClientClassComposer.java @@ -44,6 +44,7 @@ public static ServiceClientClassComposer instance() { @Override protected List createClassHeaderComments( + Map> grpcRpcsToJavaMethodNames, Service service, TypeStore typeStore, Map resourceNames, @@ -51,7 +52,7 @@ protected List createClassHeaderComments( List samples) { if (!service.hasAnyEnabledMethodsForTransport(Transport.REST)) { return super.createClassHeaderComments( - service, typeStore, resourceNames, messageTypes, samples); + grpcRpcsToJavaMethodNames, service, typeStore, resourceNames, messageTypes, samples); } TypeNode clientType = typeStore.get(ClassNames.getServiceClientClassName(service)); TypeNode settingsType = typeStore.get(ClassNames.getServiceSettingsClassName(service)); @@ -72,6 +73,7 @@ protected List createClassHeaderComments( classMethodSampleCode, credentialsSampleCode, endpointSampleCode, transportSampleCode)); return ServiceClientCommentComposer.createClassHeaderComments( + grpcRpcsToJavaMethodNames, service, SampleCodeWriter.writeInlineSample(classMethodSampleCode.body()), SampleCodeWriter.writeInlineSample(credentialsSampleCode.body()), diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java index 4fd5c4f384..b1a57d4e33 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java @@ -71,6 +71,14 @@ public boolean isPaged() { public abstract boolean operationPollingMethod(); + public String getName() { + return name(); + } + + public String getDescription() { + return description(); + } + public boolean hasLro() { return lro() != null; } diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden index 84c259a6b6..7fa727683e 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden @@ -31,19 +31,30 @@ import javax.annotation.Generated; * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
NestedMessageMethod + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • nestedMessageMethod(Outer.Middle request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • nestedMessageMethodCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden index e1de9b7f4e..6ab6b4f77f 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden @@ -31,19 +31,37 @@ import javax.annotation.Generated; *

Note: close() needs to be called on the BookshopClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetBook + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • getBook(GetBookRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getBook(booksCount) + *
  • getBook(String booksList) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getBookCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden index 25847773a2..67f9dd49a0 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden @@ -30,19 +30,48 @@ import javax.annotation.Generated; * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
SlowFibonacci + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • slowFibonacci(FibonacciRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • slowFibonacciCallable() + *
+ * + *
FastFibonacci + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • fastFibonacci(FibonacciRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • fastFibonacciCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden index 5bc547af78..335f9a5de1 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden @@ -52,19 +52,197 @@ import javax.annotation.Generated; *

Note: close() needs to be called on the EchoClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
Echo + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • echo(EchoRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • echo() + *
  • echo(ResourceName parent) + *
  • echo(Status error) + *
  • echo(FoobarName name) + *
  • echo(String content) + *
  • echo(String name) + *
  • echo(String parent) + *
  • echo(String content) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • echoCallable() + *
+ * + *
Collect + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • collectCallable() + *
+ * + *
Expand + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • expandCallable() + *
+ * + *
PagedExpand + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • pagedExpand(PagedExpandRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • pagedExpandPagedCallable() + *
  • pagedExpandCallable() + *
+ * + *
Chat + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • chatCallable() + *
+ * + *
Block + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • block(BlockRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • blockCallable() + *
+ * + *
Wait + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • waitAsync(WaitRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • waitAsync(Duration ttl) + *
  • waitAsync(Timestamp endTime) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • waitOperationCallable() + *
  • waitCallable() + *
+ * + *
SimplePagedExpand + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • simplePagedExpand(PagedExpandRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • simplePagedExpand() + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • simplePagedExpandPagedCallable() + *
  • simplePagedExpandCallable() + *
+ * + *
ChatAgain + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • chatAgainCallable() + *
+ * + *
CollideName + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • collideName(EchoRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • collideNameCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden index bcd0f26738..245ababcbc 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden @@ -40,19 +40,125 @@ import javax.annotation.Generated; *

Note: close() needs to be called on the IdentityClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListUsers + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listUsers(ListUsersRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listUsersPagedCallable() + *
  • listUsersCallable() + *
+ * + *
CreateUser + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createUser(CreateUserRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createUser(String parent) + *
  • createUser(String parent) + *
  • createUser(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createUserCallable() + *
+ * + *
DeleteUser + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteUser(DeleteUserRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteUser(UserName name) + *
  • deleteUser(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteUserCallable() + *
+ * + *
UpdateUser + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateUser(UpdateUserRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateUserCallable() + *
+ * + *
GetUser + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getUser(GetUserRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getUser(UserName name) + *
  • getUser(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getUserCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden index 78b665668f..a5ea61e3f9 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden @@ -47,19 +47,308 @@ import javax.annotation.Generated; *

Note: close() needs to be called on the MessagingClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
SearchBlurbs + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • searchBlurbsAsync(SearchBlurbsRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • searchBlurbsAsync(String query) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • searchBlurbsOperationCallable() + *
  • searchBlurbsCallable() + *
+ * + *
Connect + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • connectCallable() + *
+ * + *
SendBlurbs + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • sendBlurbsCallable() + *
+ * + *
UpdateRoom + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateRoom(UpdateRoomRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateRoomCallable() + *
+ * + *
GetBlurb + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getBlurb(GetBlurbRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getBlurb(BlurbName name) + *
  • getBlurb(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getBlurbCallable() + *
+ * + *
GetRoom + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getRoom(GetRoomRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getRoom(RoomName name) + *
  • getRoom(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getRoomCallable() + *
+ * + *
UpdateBlurb + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateBlurb(UpdateBlurbRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateBlurbCallable() + *
+ * + *
ListBlurbs + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listBlurbs(ListBlurbsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listBlurbs(ProfileName parent) + *
  • listBlurbs(RoomName parent) + *
  • listBlurbs(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listBlurbsPagedCallable() + *
  • listBlurbsCallable() + *
+ * + *
StreamBlurbs + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • streamBlurbsCallable() + *
+ * + *
DeleteRoom + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteRoom(DeleteRoomRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteRoom(RoomName name) + *
  • deleteRoom(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteRoomCallable() + *
+ * + *
ListRooms + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listRooms(ListRoomsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listRoomsPagedCallable() + *
  • listRoomsCallable() + *
+ * + *
CreateRoom + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createRoom(CreateRoomRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createRoom(String displayName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createRoomCallable() + *
+ * + *
CreateBlurb + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createBlurb(CreateBlurbRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createBlurb(ProfileName parent) + *
  • createBlurb(ProfileName parent) + *
  • createBlurb(RoomName parent) + *
  • createBlurb(RoomName parent) + *
  • createBlurb(String parent) + *
  • createBlurb(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createBlurbCallable() + *
+ * + *
DeleteBlurb + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteBlurb(DeleteBlurbRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteBlurb(BlurbName name) + *
  • deleteBlurb(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteBlurbCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index 334dacf40b..1075a3d85c 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -47,19 +47,233 @@ import javax.annotation.Generated; *

Note: close() needs to be called on the EchoClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
Echo + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • echo(EchoRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • echo() + *
  • echo(ResourceName parent) + *
  • echo(Status error) + *
  • echo(FoobarName name) + *
  • echo(String content) + *
  • echo(String name) + *
  • echo(String parent) + *
  • echo(String content) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • echoCallable() + *
+ * + *
NoBinding + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • noBinding(EchoRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • noBindingCallable() + *
+ * + *
Expand + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • expandCallable() + *
+ * + *
PagedExpand + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • pagedExpand(PagedExpandRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • pagedExpandPagedCallable() + *
  • pagedExpandCallable() + *
+ * + *
Chat + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • chatCallable() + *
+ * + *
Block + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • block(BlockRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • blockCallable() + *
+ * + *
Wait + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • waitAsync(WaitRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • waitAsync(Duration ttl) + *
  • waitAsync(Timestamp endTime) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • waitOperationCallable() + *
  • waitCallable() + *
+ * + *
SimplePagedExpand + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • simplePagedExpand(PagedExpandRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • simplePagedExpand() + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • simplePagedExpandPagedCallable() + *
  • simplePagedExpandCallable() + *
+ * + *
CollideName + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • collideName(EchoRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • collideNameCallable() + *
+ * + *
NestedBinding + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • nestedBinding(EchoRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • nestedBindingCallable() + *
+ * + *
UpdateCase + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateCase(UpdateCaseRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateCase(Case case_) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateCaseCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden index ad2bd517d2..dd0d881277 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden @@ -25,19 +25,12 @@ import javax.annotation.Generated; *

Note: close() needs to be called on the EchoEmpyClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + *
MethodDescriptionMethod Variants
* *

See the individual methods for example code. * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden index 67f9212085..84a7518515 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden @@ -32,19 +32,54 @@ import javax.annotation.Generated; *

Note: close() needs to be called on the WickedClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
BrainstormEvilPlans + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • brainstormEvilPlansCallable() + *
+ * + *
PersuadeEvilPlan + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • persuadeEvilPlanCallable() + *
+ * + *
CraftEvilPlan + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • craftEvilPlan(EvilRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • craftEvilPlanCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java index 0254061ebe..692e117360 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java @@ -57,19 +57,39 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListConnectionsLists connections that are currently active for the given Apigee Connect + * endpoint. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • listConnections(ListConnectionsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listConnections(EndpointName parent) + *
  • listConnections(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listConnectionsPagedCallable() + *
  • listConnectionsCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java index d085337c32..8a241e2ff0 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java @@ -61,19 +61,30 @@ *

Note: close() needs to be called on the TetherClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
EgressEgress streams egress requests and responses. Logically, this is not + * actually a streaming request, but uses streaming as a mechanism to flip + * the client-server relationship of gRPC so that the server can act as a + * client. + * The listener, the RPC server, accepts connections from the dialer, + * the RPC client. + * The listener streams http requests and the dialer streams http responses. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • egressCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index bea5e6251a..2296991a0c 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -69,19 +69,516 @@ *

Note: close() needs to be called on the AssetServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
UpdateFeedUpdates an asset feed configuration. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateFeed(UpdateFeedRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateFeed(Feed feed) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateFeedCallable() + *
+ * + *
ListFeedsLists all asset feeds in a parent project/folder/organization. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listFeeds(ListFeedsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listFeeds(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listFeedsCallable() + *
+ * + *
GetFeedGets details about an asset feed. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getFeed(GetFeedRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getFeed(FeedName name) + *
  • getFeed(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getFeedCallable() + *
+ * + *
BatchGetAssetsHistoryBatch gets the update history of assets that overlap a time window. + * For IAM_POLICY content, this API outputs history when the asset and its + * attached IAM POLICY both exist. This can create gaps in the output history. + * Otherwise, this API outputs history with asset in both non-delete or + * deleted status. + * If a specified asset does not exist, this API returns an INVALID_ARGUMENT + * error. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • batchGetAssetsHistoryCallable() + *
+ * + *
AnalyzeIamPolicyAnalyzes IAM policies to answer which identities have what accesses on + * which resources. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • analyzeIamPolicy(AnalyzeIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • analyzeIamPolicyCallable() + *
+ * + *
ExportAssetsExports assets with time and resource types to a given Cloud Storage + * location/BigQuery table. For Cloud Storage location destinations, the + * output format is newline-delimited JSON. Each line represents a + * [google.cloud.asset.v1.Asset][google.cloud.asset.v1.Asset] in the JSON format; for BigQuery table + * destinations, the output table stores the fields in asset Protobuf as + * columns. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API, + * which allows you to keep track of the export. We recommend intervals of at + * least 2 seconds with exponential retry to poll the export operation result. + * For regular-size resource parent, the export operation usually finishes + * within 5 minutes. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • exportAssetsAsync(ExportAssetsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • exportAssetsOperationCallable() + *
  • exportAssetsCallable() + *
+ * + *
GetSavedQueryGets details about a saved query. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSavedQuery(GetSavedQueryRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getSavedQuery(SavedQueryName name) + *
  • getSavedQuery(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSavedQueryCallable() + *
+ * + *
CreateSavedQueryCreates a saved query in a parent project/folder/organization. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createSavedQuery(CreateSavedQueryRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createSavedQuery(FolderName parent) + *
  • createSavedQuery(OrganizationName parent) + *
  • createSavedQuery(ProjectName parent) + *
  • createSavedQuery(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createSavedQueryCallable() + *
+ * + *
ListAssetsLists assets with time and resource types and returns paged results in + * response. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listAssets(ListAssetsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listAssets(ResourceName parent) + *
  • listAssets(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listAssetsPagedCallable() + *
  • listAssetsCallable() + *
+ * + *
DeleteFeedDeletes an asset feed. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteFeed(DeleteFeedRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteFeed(FeedName name) + *
  • deleteFeed(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteFeedCallable() + *
+ * + *
QueryAssetsIssue a job that queries assets using a SQL statement compatible with + * [BigQuery Standard + * SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql). + * + * If the query execution finishes within timeout and there's no pagination, + * the full query results will be returned in the `QueryAssetsResponse`. + * + * Otherwise, full query results can be obtained by issuing extra requests + * with the `job_reference` from the a previous `QueryAssets` call. + * + * Note, the query result has approximately 10 GB limitation enforced by + * BigQuery + * https://cloud.google.com/bigquery/docs/best-practices-performance-output, + * queries return larger results will result in errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • queryAssets(QueryAssetsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • queryAssetsCallable() + *
+ * + *
DeleteSavedQueryDeletes a saved query. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteSavedQuery(DeleteSavedQueryRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteSavedQuery(SavedQueryName name) + *
  • deleteSavedQuery(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteSavedQueryCallable() + *
+ * + *
SearchAllResourcesSearches all Cloud resources within the specified scope, such as a project, + * folder, or organization. The caller must be granted the + * `cloudasset.assets.searchAllResources` permission on the desired scope, + * otherwise the request will be rejected. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • searchAllResources(SearchAllResourcesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • searchAllResources(String scope) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • searchAllResourcesPagedCallable() + *
  • searchAllResourcesCallable() + *
+ * + *
UpdateSavedQueryUpdates a saved query. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateSavedQuery(UpdateSavedQueryRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateSavedQuery(SavedQuery savedQuery) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateSavedQueryCallable() + *
+ * + *
AnalyzeIamPolicyLongrunningAnalyzes IAM policies asynchronously to answer which identities have what + * accesses on which resources, and writes the analysis results to a Google + * Cloud Storage or a BigQuery destination. For Cloud Storage destination, the + * output format is the JSON format that represents a + * [AnalyzeIamPolicyResponse][google.cloud.asset.v1.AnalyzeIamPolicyResponse]. This method implements the + * [google.longrunning.Operation][google.longrunning.Operation], which allows you to track the operation + * status. We recommend intervals of at least 2 seconds with exponential + * backoff retry to poll the operation result. The metadata contains the + * metadata for the long-running operation. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • analyzeIamPolicyLongrunningOperationCallable() + *
  • analyzeIamPolicyLongrunningCallable() + *
+ * + *
ListSavedQueriesLists all saved queries in a parent project/folder/organization. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listSavedQueries(ListSavedQueriesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listSavedQueries(FolderName parent) + *
  • listSavedQueries(OrganizationName parent) + *
  • listSavedQueries(ProjectName parent) + *
  • listSavedQueries(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listSavedQueriesPagedCallable() + *
  • listSavedQueriesCallable() + *
+ * + *
CreateFeedCreates a feed in a parent project/folder/organization to listen to its + * asset updates. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createFeed(CreateFeedRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createFeed(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createFeedCallable() + *
+ * + *
BatchGetEffectiveIamPoliciesGets effective IAM policies for a batch of resources. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • batchGetEffectiveIamPoliciesCallable() + *
+ * + *
SearchAllIamPoliciesSearches all IAM policies within the specified scope, such as a project, + * folder, or organization. The caller must be granted the + * `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, + * otherwise the request will be rejected. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • searchAllIamPolicies(SearchAllIamPoliciesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • searchAllIamPolicies(String scope) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • searchAllIamPoliciesPagedCallable() + *
  • searchAllIamPoliciesCallable() + *
+ * + *
AnalyzeMoveAnalyze moving a resource to a specified destination without kicking off + * the actual move. The analysis is best effort depending on the user's + * permissions of viewing different hierarchical policies and configurations. + * The policies and configuration are subject to change before the actual + * resource migration takes place. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • analyzeMove(AnalyzeMoveRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • analyzeMoveCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index 34257fb4cd..ebdc6e8f9d 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -71,19 +71,171 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
MutateRowsMutates multiple rows in a batch. Each individual row is mutated + * atomically as in MutateRow, but the entire batch is not executed + * atomically. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • mutateRowsCallable() + *
+ * + *
PingAndWarmWarm up associated instance metadata for this connection. + * This call is not required but may be useful for connection keep-alive. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • pingAndWarm(PingAndWarmRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • pingAndWarm(InstanceName name) + *
  • pingAndWarm(String name) + *
  • pingAndWarm(InstanceName name) + *
  • pingAndWarm(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • pingAndWarmCallable() + *
+ * + *
ReadRowsStreams back the contents of all requested rows in key order, optionally + * applying the same Reader filter to each. Depending on their size, + * rows and cells may be broken up across multiple responses, but + * atomicity of each row will still be preserved. See the + * ReadRowsResponse documentation for details. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • readRowsCallable() + *
+ * + *
ReadModifyWriteRowModifies a row atomically on the server. The method reads the latest + * existing timestamp and value from the specified columns and writes a new + * entry based on pre-defined read/modify/write rules. The new value for the + * timestamp is the greater of the existing timestamp or the current server + * time. The method returns the new contents of all modified cells. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • readModifyWriteRow(ReadModifyWriteRowRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • readModifyWriteRow(TableName tableName) + *
  • readModifyWriteRow(String tableName) + *
  • readModifyWriteRow(TableName tableName) + *
  • readModifyWriteRow(String tableName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • readModifyWriteRowCallable() + *
+ * + *
MutateRowMutates a row atomically. Cells already present in the row are left + * unchanged unless explicitly changed by `mutation`. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • mutateRow(MutateRowRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • mutateRow(TableName tableName) + *
  • mutateRow(String tableName) + *
  • mutateRow(TableName tableName) + *
  • mutateRow(String tableName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • mutateRowCallable() + *
+ * + *
SampleRowKeysReturns a sample of row keys in the table. The returned row keys will + * delimit contiguous sections of the table of approximately equal size, + * which can be used to break up the data for distributed tasks like + * mapreduces. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • sampleRowKeysCallable() + *
+ * + *
CheckAndMutateRowMutates a row atomically based on the output of a predicate Reader filter. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • checkAndMutateRow(CheckAndMutateRowRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • checkAndMutateRow(TableName tableName) + *
  • checkAndMutateRow(String tableName) + *
  • checkAndMutateRow(TableName tableName) + *
  • checkAndMutateRow(String tableName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • checkAndMutateRowCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index 7da6db9b67..3fe69e5458 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -63,19 +63,112 @@ *

Note: close() needs to be called on the AddressesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
DeleteDeletes the specified address resource. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteAsync(DeleteAddressRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • deleteAsync(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteOperationCallable() + *
  • deleteCallable() + *
+ * + *
ListRetrieves a list of addresses contained within the specified region. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • list(ListAddressesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • list(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listPagedCallable() + *
  • listCallable() + *
+ * + *
InsertCreates an address resource in the specified project by using the data included in the request. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • insertAsync(InsertAddressRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • insertAsync(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • insertOperationCallable() + *
  • insertCallable() + *
+ * + *
AggregatedListRetrieves an aggregated list of addresses. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • aggregatedList(AggregatedListAddressesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • aggregatedList(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • aggregatedListPagedCallable() + *
  • aggregatedListCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java index d74718729f..946b6f9829 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java @@ -49,19 +49,64 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetRetrieves the specified region-specific Operations resource. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • get(GetRegionOperationRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • get(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getCallable() + *
+ * + *
WaitWaits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. + * + * This method is called on a best-effort basis. Specifically: + * - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. + * - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • wait(WaitRegionOperationRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • wait(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • waitCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java index aa18c91623..e89c7ac900 100644 --- a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java +++ b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java @@ -60,19 +60,112 @@ *

Note: close() needs to be called on the IamCredentialsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GenerateAccessTokenGenerates an OAuth 2.0 access token for a service account. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • generateAccessToken(GenerateAccessTokenRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • generateAccessToken(ServiceAccountName name) + *
  • generateAccessToken(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • generateAccessTokenCallable() + *
+ * + *
GenerateIdTokenGenerates an OpenID Connect ID token for a service account. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • generateIdToken(GenerateIdTokenRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • generateIdToken(ServiceAccountName name) + *
  • generateIdToken(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • generateIdTokenCallable() + *
+ * + *
SignBlobSigns a blob using a service account's system-managed private key. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • signBlob(SignBlobRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • signBlob(ServiceAccountName name) + *
  • signBlob(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • signBlobCallable() + *
+ * + *
SignJwtSigns a JWT using a service account's system-managed private key. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • signJwt(SignJwtRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • signJwt(ServiceAccountName name) + *
  • signJwt(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • signJwtCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java index 43009b89f4..eb5c50f533 100644 --- a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java +++ b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java @@ -72,19 +72,77 @@ *

Note: close() needs to be called on the IAMPolicyClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetIamPolicyGets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index 23f83c2389..bc92d88e96 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -80,19 +80,739 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
UpdateCryptoKeyUpdate a [CryptoKey][google.cloud.kms.v1.CryptoKey]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateCryptoKey(UpdateCryptoKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateCryptoKey(CryptoKey cryptoKey) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateCryptoKeyCallable() + *
+ * + *
DecryptDecrypts data that was protected by + * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • decrypt(DecryptRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • decrypt(CryptoKeyName name) + *
  • decrypt(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • decryptCallable() + *
+ * + *
ListKeyRingsLists [KeyRings][google.cloud.kms.v1.KeyRing]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listKeyRings(ListKeyRingsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listKeyRings(LocationName parent) + *
  • listKeyRings(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listKeyRingsPagedCallable() + *
  • listKeyRingsCallable() + *
+ * + *
AsymmetricDecryptDecrypts data that was encrypted with a public key retrieved from + * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] + * corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] + * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] + * ASYMMETRIC_DECRYPT. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • asymmetricDecrypt(AsymmetricDecryptRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • asymmetricDecrypt(CryptoKeyVersionName name) + *
  • asymmetricDecrypt(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • asymmetricDecryptCallable() + *
+ * + *
ListImportJobsLists [ImportJobs][google.cloud.kms.v1.ImportJob]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listImportJobs(ListImportJobsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listImportJobs(KeyRingName parent) + *
  • listImportJobs(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listImportJobsPagedCallable() + *
  • listImportJobsCallable() + *
+ * + *
GetImportJobReturns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getImportJob(GetImportJobRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getImportJob(ImportJobName name) + *
  • getImportJob(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getImportJobCallable() + *
+ * + *
CreateImportJobCreate a new [ImportJob][google.cloud.kms.v1.ImportJob] within a + * [KeyRing][google.cloud.kms.v1.KeyRing]. + * + * [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is + * required. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createImportJob(CreateImportJobRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createImportJob(KeyRingName parent) + *
  • createImportJob(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createImportJobCallable() + *
+ * + *
ImportCryptoKeyVersionImports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into + * an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the wrapped + * key material provided in the request. + * + * The version ID will be assigned the next sequential id within the + * [CryptoKey][google.cloud.kms.v1.CryptoKey]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • importCryptoKeyVersionCallable() + *
+ * + *
GetPublicKeyReturns the public key for the given + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] + * or + * [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getPublicKey(GetPublicKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getPublicKey(CryptoKeyVersionName name) + *
  • getPublicKey(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getPublicKeyCallable() + *
+ * + *
GetLocationGets information about a location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLocation(GetLocationRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLocationCallable() + *
+ * + *
TestIamPermissionsThis is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
CreateKeyRingCreate a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and + * Location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createKeyRing(CreateKeyRingRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createKeyRing(LocationName parent) + *
  • createKeyRing(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createKeyRingCallable() + *
+ * + *
GetKeyRingReturns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getKeyRing(GetKeyRingRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getKeyRing(KeyRingName name) + *
  • getKeyRing(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getKeyRingCallable() + *
+ * + *
ListLocationsLists information about the supported locations for this service. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLocations(ListLocationsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ * + *
CreateCryptoKeyCreate a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a + * [KeyRing][google.cloud.kms.v1.KeyRing]. + * + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] and + * [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm] + * are required. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createCryptoKey(CreateCryptoKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createCryptoKey(KeyRingName parent) + *
  • createCryptoKey(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createCryptoKeyCallable() + *
+ * + *
CreateCryptoKeyVersionCreate a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a + * [CryptoKey][google.cloud.kms.v1.CryptoKey]. + * + * The server will assign the next sequential id. If unset, + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to + * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createCryptoKeyVersion(CreateCryptoKeyVersionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createCryptoKeyVersion(CryptoKeyName parent) + *
  • createCryptoKeyVersion(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createCryptoKeyVersionCallable() + *
+ * + *
UpdateCryptoKeyPrimaryVersionUpdate the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that + * will be used in + * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. + * + * Returns an error if called on an asymmetric key. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateCryptoKeyPrimaryVersion(CryptoKeyName name) + *
  • updateCryptoKeyPrimaryVersion(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateCryptoKeyPrimaryVersionCallable() + *
+ * + *
DestroyCryptoKeyVersionSchedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for + * destruction. + * + * Upon calling this method, + * [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will + * be set to + * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] + * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will + * be set to a time 24 hours in the future, at which point the + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be changed to + * [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], + * and the key material will be irrevocably destroyed. + * + * Before the + * [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is + * reached, + * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] + * may be called to reverse the process. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • destroyCryptoKeyVersion(CryptoKeyVersionName name) + *
  • destroyCryptoKeyVersion(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • destroyCryptoKeyVersionCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. ADDED ONLY FOR MIXIN TESTS. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
GetCryptoKeyVersionReturns metadata for a given + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getCryptoKeyVersion(CryptoKeyVersionName name) + *
  • getCryptoKeyVersion(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getCryptoKeyVersionCallable() + *
+ * + *
UpdateCryptoKeyVersionUpdate a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s + * metadata. + * + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] may be changed between + * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] + * and + * [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] + * using this method. See + * [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] + * and + * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] + * to move between other states. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateCryptoKeyVersion(UpdateCryptoKeyVersionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateCryptoKeyVersionCallable() + *
+ * + *
ListCryptoKeyVersionsLists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listCryptoKeyVersions(CryptoKeyName parent) + *
  • listCryptoKeyVersions(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listCryptoKeyVersionsPagedCallable() + *
  • listCryptoKeyVersionsCallable() + *
+ * + *
AsymmetricSignSigns data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] + * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] + * ASYMMETRIC_SIGN, producing a signature that can be verified with the public + * key retrieved from + * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • asymmetricSign(AsymmetricSignRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • asymmetricSign(CryptoKeyVersionName name) + *
  • asymmetricSign(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • asymmetricSignCallable() + *
+ * + *
EncryptEncrypts data, so that it can only be recovered by a call to + * [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • encrypt(EncryptRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • encrypt(ResourceName name) + *
  • encrypt(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • encryptCallable() + *
+ * + *
GetCryptoKeyReturns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as + * well as its [primary][google.cloud.kms.v1.CryptoKey.primary] + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getCryptoKey(GetCryptoKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getCryptoKey(CryptoKeyName name) + *
  • getCryptoKey(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getCryptoKeyCallable() + *
+ * + *
RestoreCryptoKeyVersionRestore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the + * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] + * state. + * + * Upon restoration of the CryptoKeyVersion, + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to + * [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED], + * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will + * be cleared. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • restoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • restoreCryptoKeyVersion(CryptoKeyVersionName name) + *
  • restoreCryptoKeyVersion(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • restoreCryptoKeyVersionCallable() + *
+ * + *
ListCryptoKeysLists [CryptoKeys][google.cloud.kms.v1.CryptoKey]. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listCryptoKeys(ListCryptoKeysRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listCryptoKeys(KeyRingName parent) + *
  • listCryptoKeys(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listCryptoKeysPagedCallable() + *
  • listCryptoKeysCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index 0796286c2e..bee7d14049 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -80,19 +80,295 @@ *

Note: close() needs to be called on the LibraryServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListShelvesLists shelves. The order is unspecified but deterministic. Newly created + * shelves will not necessarily be added to the end of this list. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listShelves(ListShelvesRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listShelvesPagedCallable() + *
  • listShelvesCallable() + *
+ * + *
CreateShelfCreates a shelf, and returns the new Shelf. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createShelf(CreateShelfRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createShelf(Shelf shelf) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createShelfCallable() + *
+ * + *
DeleteShelfDeletes a shelf. Returns NOT_FOUND if the shelf does not exist. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteShelf(DeleteShelfRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteShelf(ShelfName name) + *
  • deleteShelf(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteShelfCallable() + *
+ * + *
MoveBookMoves a book to another shelf, and returns the new book. The book + * id of the new book may not be the same as the original book. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • moveBook(MoveBookRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • moveBook(BookName name) + *
  • moveBook(BookName name) + *
  • moveBook(String name) + *
  • moveBook(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • moveBookCallable() + *
+ * + *
CreateBookCreates a book, and returns the new Book. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createBook(CreateBookRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createBook(ShelfName parent) + *
  • createBook(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createBookCallable() + *
+ * + *
DeleteBookDeletes a book. Returns NOT_FOUND if the book does not exist. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteBook(DeleteBookRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteBook(BookName name) + *
  • deleteBook(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteBookCallable() + *
+ * + *
UpdateBookUpdates a book. Returns INVALID_ARGUMENT if the name of the book + * is non-empty and does not equal the existing name. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateBook(UpdateBookRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateBook(Book book) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateBookCallable() + *
+ * + *
GetShelfGets a shelf. Returns NOT_FOUND if the shelf does not exist. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getShelf(GetShelfRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getShelf(ShelfName name) + *
  • getShelf(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getShelfCallable() + *
+ * + *
GetBookGets a book. Returns NOT_FOUND if the book does not exist. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getBook(GetBookRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getBook(BookName name) + *
  • getBook(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getBookCallable() + *
+ * + *
MergeShelvesMerges two shelves by adding all books from the shelf named + * `other_shelf_name` to shelf `name`, and deletes + * `other_shelf_name`. Returns the updated shelf. + * The book ids of the moved books may not be the same as the original books. + * + * Returns NOT_FOUND if either shelf does not exist. + * This call is a no-op if the specified shelves are the same. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • mergeShelves(MergeShelvesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • mergeShelves(ShelfName name) + *
  • mergeShelves(ShelfName name) + *
  • mergeShelves(String name) + *
  • mergeShelves(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • mergeShelvesCallable() + *
+ * + *
ListBooksLists books in a shelf. The order is unspecified but deterministic. Newly + * created books will not necessarily be added to the end of this list. + * Returns NOT_FOUND if the shelf does not exist. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listBooks(ListBooksRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listBooks(ShelfName parent) + *
  • listBooks(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listBooksPagedCallable() + *
  • listBooksCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index 72aa8590aa..a51b96dfdb 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -114,19 +114,679 @@ *

Note: close() needs to be called on the ConfigClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
DeleteSinkDeletes a sink. If the sink has a unique `writer_identity`, then that + * service account is also deleted. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteSink(DeleteSinkRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteSink(LogSinkName sinkName) + *
  • deleteSink(String sinkName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteSinkCallable() + *
+ * + *
UpdateViewUpdates a view on a log bucket. This method replaces the following fields + * in the existing view with values from the new view: `filter`. + * If an `UNAVAILABLE` error is returned, this indicates that system is not in + * a state where it can update the view. If this occurs, please try again in a + * few minutes. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateView(UpdateViewRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateViewCallable() + *
+ * + *
UpdateCmekSettingsUpdates the Log Router CMEK settings for the given resource. + * + * Note: CMEK for the Log Router can currently only be configured for Google + * Cloud organizations. Once configured, it applies to all projects and + * folders in the Google Cloud organization. + * + * [UpdateCmekSettings][google.logging.v2.ConfigServiceV2.UpdateCmekSettings] + * will fail if 1) `kms_key_name` is invalid, or 2) the associated service + * account does not have the required + * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or + * 3) access to the key is disabled. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateCmekSettings(UpdateCmekSettingsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateCmekSettingsCallable() + *
+ * + *
GetViewGets a view on a log bucket.. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getView(GetViewRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getViewCallable() + *
+ * + *
UndeleteBucketUndeletes a log bucket. A bucket that has been deleted can be undeleted + * within the grace period of 7 days. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • undeleteBucket(UndeleteBucketRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • undeleteBucketCallable() + *
+ * + *
ListExclusionsLists all the exclusions on the _Default sink in a parent resource. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listExclusions(ListExclusionsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listExclusions(BillingAccountName parent) + *
  • listExclusions(FolderName parent) + *
  • listExclusions(OrganizationName parent) + *
  • listExclusions(ProjectName parent) + *
  • listExclusions(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listExclusionsPagedCallable() + *
  • listExclusionsCallable() + *
+ * + *
UpdateSettingsUpdates the Log Router settings for the given resource. + * + * Note: Settings for the Log Router can currently only be configured for + * Google Cloud organizations. Once configured, it applies to all projects and + * folders in the Google Cloud organization. + * + * [UpdateSettings][google.logging.v2.ConfigServiceV2.UpdateSettings] + * will fail if 1) `kms_key_name` is invalid, or 2) the associated service + * account does not have the required + * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or + * 3) access to the key is disabled. 4) `location_id` is not supported by + * Logging. 5) `location_id` violate OrgPolicy. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateSettings(UpdateSettingsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateSettings(Settings settings) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateSettingsCallable() + *
+ * + *
CreateViewCreates a view over log entries in a log bucket. A bucket may contain a + * maximum of 30 views. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createView(CreateViewRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createViewCallable() + *
+ * + *
DeleteViewDeletes a view on a log bucket. + * If an `UNAVAILABLE` error is returned, this indicates that system is not in + * a state where it can delete the view. If this occurs, please try again in a + * few minutes. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteView(DeleteViewRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteViewCallable() + *
+ * + *
UpdateExclusionChanges one or more properties of an existing exclusion in the _Default + * sink. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateExclusion(UpdateExclusionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateExclusion(LogExclusionName name) + *
  • updateExclusion(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateExclusionCallable() + *
+ * + *
GetSinkGets a sink. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSink(GetSinkRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getSink(LogSinkName sinkName) + *
  • getSink(String sinkName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSinkCallable() + *
+ * + *
CreateExclusionCreates a new exclusion in the _Default sink in a specified parent + * resource. Only log entries belonging to that resource can be excluded. You + * can have up to 10 exclusions in a resource. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createExclusion(CreateExclusionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createExclusion(BillingAccountName parent) + *
  • createExclusion(FolderName parent) + *
  • createExclusion(OrganizationName parent) + *
  • createExclusion(ProjectName parent) + *
  • createExclusion(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createExclusionCallable() + *
+ * + *
DeleteBucketDeletes a log bucket. + * + * Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state. + * After 7 days, the bucket will be purged and all log entries in the bucket + * will be permanently deleted. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteBucket(DeleteBucketRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteBucketCallable() + *
+ * + *
ListBucketsLists log buckets. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listBuckets(ListBucketsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listBuckets(BillingAccountLocationName parent) + *
  • listBuckets(FolderLocationName parent) + *
  • listBuckets(LocationName parent) + *
  • listBuckets(OrganizationLocationName parent) + *
  • listBuckets(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listBucketsPagedCallable() + *
  • listBucketsCallable() + *
+ * + *
GetCmekSettingsGets the Logging CMEK settings for the given resource. + * + * Note: CMEK for the Log Router can be configured for Google Cloud projects, + * folders, organizations and billing accounts. Once configured for an + * organization, it applies to all projects and folders in the Google Cloud + * organization. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getCmekSettings(GetCmekSettingsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getCmekSettingsCallable() + *
+ * + *
CreateSinkCreates a sink that exports specified log entries to a destination. The + * export of newly-ingested log entries begins immediately, unless the sink's + * `writer_identity` is not permitted to write to the destination. A sink can + * export log entries only from the resource owning the sink. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createSink(CreateSinkRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createSink(BillingAccountName parent) + *
  • createSink(FolderName parent) + *
  • createSink(OrganizationName parent) + *
  • createSink(ProjectName parent) + *
  • createSink(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createSinkCallable() + *
+ * + *
GetBucketGets a log bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getBucket(GetBucketRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getBucketCallable() + *
+ * + *
ListViewsLists views on a log bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listViews(ListViewsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listViews(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listViewsPagedCallable() + *
  • listViewsCallable() + *
+ * + *
ListSinksLists sinks. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listSinks(ListSinksRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listSinks(BillingAccountName parent) + *
  • listSinks(FolderName parent) + *
  • listSinks(OrganizationName parent) + *
  • listSinks(ProjectName parent) + *
  • listSinks(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listSinksPagedCallable() + *
  • listSinksCallable() + *
+ * + *
UpdateSinkUpdates a sink. This method replaces the following fields in the existing + * sink with values from the new sink: `destination`, and `filter`. + * + * The updated sink might also have a new `writer_identity`; see the + * `unique_writer_identity` field. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateSink(UpdateSinkRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateSink(LogSinkName sinkName) + *
  • updateSink(String sinkName) + *
  • updateSink(LogSinkName sinkName) + *
  • updateSink(String sinkName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateSinkCallable() + *
+ * + *
UpdateBucketUpdates a log bucket. This method replaces the following fields in the + * existing bucket with values from the new bucket: `retention_period` + * + * If the retention period is decreased and the bucket is locked, + * `FAILED_PRECONDITION` will be returned. + * + * If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then + * `FAILED_PRECONDITION` will be returned. + * + * After a bucket has been created, the bucket's location cannot be changed. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateBucket(UpdateBucketRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateBucketCallable() + *
+ * + *
GetExclusionGets the description of an exclusion in the _Default sink. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getExclusion(GetExclusionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getExclusion(LogExclusionName name) + *
  • getExclusion(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getExclusionCallable() + *
+ * + *
DeleteExclusionDeletes an exclusion in the _Default sink. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteExclusion(DeleteExclusionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteExclusion(LogExclusionName name) + *
  • deleteExclusion(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteExclusionCallable() + *
+ * + *
CopyLogEntriesCopies a set of log entries from a log bucket to a Cloud Storage bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • copyLogEntriesAsync(CopyLogEntriesRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • copyLogEntriesOperationCallable() + *
  • copyLogEntriesCallable() + *
+ * + *
CreateBucketCreates a log bucket that can be used to store log entries. After a bucket + * has been created, the bucket's location cannot be changed. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createBucket(CreateBucketRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createBucketCallable() + *
+ * + *
GetSettingsGets the Log Router settings for the given resource. + * + * Note: Settings for the Log Router can be get for Google Cloud projects, + * folders, organizations and billing accounts. Currently it can only be + * configured for organizations. Once configured for an organization, it + * applies to all projects and folders in the Google Cloud organization. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSettings(GetSettingsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getSettings(SettingsName name) + *
  • getSettings(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSettingsCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index 642d2947a5..e95e8200ce 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -76,19 +76,161 @@ *

Note: close() needs to be called on the LoggingClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
WriteLogEntriesWrites log entries to Logging. This API method is the + * only way to send log entries to Logging. This method + * is used, directly or indirectly, by the Logging agent + * (fluentd) and all logging libraries configured to use Logging. + * A single request may contain log entries for a maximum of 1000 + * different resources (projects, organizations, billing accounts or + * folders) + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

* - *
    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ *
    + *
  • writeLogEntries(WriteLogEntriesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • writeLogEntries(LogName logName) + *
  • writeLogEntries(String logName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • writeLogEntriesCallable() + *
+ * + *
ListMonitoredResourceDescriptorsLists the descriptors for monitored resource types used by Logging. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listMonitoredResourceDescriptorsPagedCallable() + *
  • listMonitoredResourceDescriptorsCallable() + *
+ * + *
ListLogsLists the logs in projects, organizations, folders, or billing accounts. + * Only logs that have entries are listed. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLogs(ListLogsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listLogs(BillingAccountName parent) + *
  • listLogs(FolderName parent) + *
  • listLogs(OrganizationName parent) + *
  • listLogs(ProjectName parent) + *
  • listLogs(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLogsPagedCallable() + *
  • listLogsCallable() + *
+ * + *
DeleteLogDeletes all the log entries in a log for the _Default Log Bucket. The log + * reappears if it receives new entries. Log entries written shortly before + * the delete operation might not be deleted. Entries received after the + * delete operation with a timestamp before the operation will be deleted. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteLog(DeleteLogRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteLog(LogName logName) + *
  • deleteLog(String logName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteLogCallable() + *
+ * + *
ListLogEntriesLists log entries. Use this method to retrieve log entries that originated + * from a project/folder/organization/billing account. For ways to export log + * entries, see [Exporting + * Logs](https://cloud.google.com/logging/docs/export). + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLogEntries(ListLogEntriesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listLogEntries(List resourceNames) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLogEntriesPagedCallable() + *
  • listLogEntriesCallable() + *
+ * + *
TailLogEntriesStreaming read of log entries as they are ingested. Until the stream is + * terminated, it will continue reading logs. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • tailLogEntriesCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index a0306451a1..97f52e98e3 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -64,19 +64,138 @@ *

Note: close() needs to be called on the MetricsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
UpdateLogMetricCreates or updates a logs-based metric. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateLogMetric(UpdateLogMetricRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateLogMetric(LogMetricName metricName) + *
  • updateLogMetric(String metricName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateLogMetricCallable() + *
+ * + *
CreateLogMetricCreates a logs-based metric. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createLogMetric(CreateLogMetricRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createLogMetric(ProjectName parent) + *
  • createLogMetric(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createLogMetricCallable() + *
+ * + *
GetLogMetricGets a logs-based metric. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLogMetric(GetLogMetricRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getLogMetric(LogMetricName metricName) + *
  • getLogMetric(String metricName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLogMetricCallable() + *
+ * + *
DeleteLogMetricDeletes a logs-based metric. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteLogMetric(DeleteLogMetricRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteLogMetric(LogMetricName metricName) + *
  • deleteLogMetric(String metricName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteLogMetricCallable() + *
+ * + *
ListLogMetricsLists logs-based metrics. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLogMetrics(ListLogMetricsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listLogMetrics(ProjectName parent) + *
  • listLogMetrics(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLogMetricsPagedCallable() + *
  • listLogMetricsCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index fd82725ee7..74db29642b 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -79,19 +79,322 @@ *

Note: close() needs to be called on the SchemaServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
DeleteSchemaDeletes a schema. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteSchema(DeleteSchemaRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteSchema(SchemaName name) + *
  • deleteSchema(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteSchemaCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
ListSchemaRevisionsLists all schema revisions for the named schema. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listSchemaRevisions(ListSchemaRevisionsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listSchemaRevisions(SchemaName name) + *
  • listSchemaRevisions(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listSchemaRevisionsPagedCallable() + *
  • listSchemaRevisionsCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces + * any existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
RollbackSchemaCreates a new schema revision that is a copy of the provided revision_id. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • rollbackSchema(RollbackSchemaRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • rollbackSchema(SchemaName name) + *
  • rollbackSchema(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • rollbackSchemaCallable() + *
+ * + *
DeleteSchemaRevisionDeletes a specific schema revision. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteSchemaRevision(DeleteSchemaRevisionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteSchemaRevision(SchemaName name) + *
  • deleteSchemaRevision(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteSchemaRevisionCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
ValidateMessageValidates a message against a schema. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • validateMessage(ValidateMessageRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • validateMessageCallable() + *
+ * + *
CreateSchemaCreates a schema. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createSchema(CreateSchemaRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createSchema(ProjectName parent) + *
  • createSchema(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createSchemaCallable() + *
+ * + *
ListSchemasLists schemas in a project. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listSchemas(ListSchemasRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listSchemas(ProjectName parent) + *
  • listSchemas(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listSchemasPagedCallable() + *
  • listSchemasCallable() + *
+ * + *
CommitSchemaCommits a new schema revision to an existing schema. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • commitSchema(CommitSchemaRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • commitSchema(SchemaName name) + *
  • commitSchema(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • commitSchemaCallable() + *
+ * + *
GetSchemaGets a schema. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSchema(GetSchemaRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getSchema(SchemaName name) + *
  • getSchema(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSchemaCallable() + *
+ * + *
ValidateSchemaValidates a schema. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • validateSchema(ValidateSchemaRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • validateSchema(ProjectName parent) + *
  • validateSchema(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • validateSchemaCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 87b846e1c8..e661df812c 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -95,19 +95,531 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
PullPulls messages from the server. The server may return `UNAVAILABLE` if + * there are too many concurrent pull requests pending for the given + * subscription. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • pull(PullRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • pull(SubscriptionName subscription) + *
  • pull(String subscription) + *
  • pull(SubscriptionName subscription) + *
  • pull(String subscription) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • pullCallable() + *
+ * + *
GetSnapshotGets the configuration details of a snapshot. Snapshots are used in + * Seek + * operations, which allow you to manage message acknowledgments in bulk. That + * is, you can set the acknowledgment state of messages in an existing + * subscription to the state captured by a snapshot. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSnapshot(GetSnapshotRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getSnapshot(SnapshotName snapshot) + *
  • getSnapshot(String snapshot) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSnapshotCallable() + *
+ * + *
AcknowledgeAcknowledges the messages associated with the `ack_ids` in the + * `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages + * from the subscription. + * + * Acknowledging a message whose ack deadline has expired may succeed, + * but such a message may be redelivered later. Acknowledging a message more + * than once will not result in an error. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • acknowledge(AcknowledgeRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • acknowledge(SubscriptionName subscription) + *
  • acknowledge(String subscription) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • acknowledgeCallable() + *
+ * + *
ModifyAckDeadlineModifies the ack deadline for a specific message. This method is useful + * to indicate that more time is needed to process a message by the + * subscriber, or to make the message available for redelivery if the + * processing was interrupted. Note that this does not modify the + * subscription-level `ackDeadlineSeconds` used for subsequent messages. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • modifyAckDeadline(ModifyAckDeadlineRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • modifyAckDeadline(SubscriptionName subscription) + *
  • modifyAckDeadline(String subscription) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • modifyAckDeadlineCallable() + *
+ * + *
ModifyPushConfigModifies the `PushConfig` for a specified subscription. + * + * This may be used to change a push subscription to a pull one (signified by + * an empty `PushConfig`) or vice versa, or change the endpoint URL and other + * attributes of a push subscription. Messages will accumulate for delivery + * continuously through the call regardless of changes to the `PushConfig`. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • modifyPushConfig(ModifyPushConfigRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • modifyPushConfig(SubscriptionName subscription) + *
  • modifyPushConfig(String subscription) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • modifyPushConfigCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
GetSubscriptionGets the configuration details of a subscription. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSubscription(GetSubscriptionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getSubscription(SubscriptionName subscription) + *
  • getSubscription(String subscription) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSubscriptionCallable() + *
+ * + *
StreamingPullEstablishes a stream with the server, which sends messages down to the + * client. The client streams acknowledgements and ack deadline modifications + * back to the server. The server will close the stream and return the status + * on any error. The server may close the stream with status `UNAVAILABLE` to + * reassign server-side resources, in which case, the client should + * re-establish the stream. Flow control can be achieved by configuring the + * underlying RPC channel. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • streamingPullCallable() + *
+ * + *
ListSnapshotsLists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listSnapshots(ListSnapshotsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listSnapshots(ProjectName project) + *
  • listSnapshots(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listSnapshotsPagedCallable() + *
  • listSnapshotsCallable() + *
+ * + *
CreateSubscriptionCreates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). + * If the subscription already exists, returns `ALREADY_EXISTS`. + * If the corresponding topic doesn't exist, returns `NOT_FOUND`. + * + * If the name is not provided in the request, the server will assign a random + * name for this subscription on the same project as the topic, conforming + * to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated + * name is populated in the returned Subscription object. Note that for REST + * API requests, you must specify a name in the request. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createSubscription(Subscription request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createSubscription(SubscriptionName name) + *
  • createSubscription(SubscriptionName name) + *
  • createSubscription(String name) + *
  • createSubscription(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createSubscriptionCallable() + *
+ * + *
DeleteSnapshotRemoves an existing snapshot. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + * When the snapshot is deleted, all messages retained in the snapshot + * are immediately dropped. After a snapshot is deleted, a new one may be + * created with the same name, but the new one has no association with the old + * snapshot or its subscription, unless the same subscription is specified. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteSnapshot(DeleteSnapshotRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteSnapshot(SnapshotName snapshot) + *
  • deleteSnapshot(String snapshot) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteSnapshotCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces + * any existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
UpdateSnapshotUpdates an existing snapshot. Snapshots are used in + * Seek + * operations, which allow + * you to manage message acknowledgments in bulk. That is, you can set the + * acknowledgment state of messages in an existing subscription to the state + * captured by a snapshot. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateSnapshot(UpdateSnapshotRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateSnapshotCallable() + *
+ * + *
UpdateSubscriptionUpdates an existing subscription. Note that certain properties of a + * subscription, such as its topic, are not modifiable. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateSubscription(UpdateSubscriptionRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateSubscriptionCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
DeleteSubscriptionDeletes an existing subscription. All messages retained in the subscription + * are immediately dropped. Calls to `Pull` after deletion will return + * `NOT_FOUND`. After a subscription is deleted, a new one may be created with + * the same name, but the new one has no association with the old + * subscription or its topic unless the same topic is specified. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteSubscription(DeleteSubscriptionRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteSubscription(SubscriptionName subscription) + *
  • deleteSubscription(String subscription) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteSubscriptionCallable() + *
+ * + *
ListSubscriptionsLists matching subscriptions. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listSubscriptions(ListSubscriptionsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listSubscriptions(ProjectName project) + *
  • listSubscriptions(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listSubscriptionsPagedCallable() + *
  • listSubscriptionsCallable() + *
+ * + *
CreateSnapshotCreates a snapshot from the requested subscription. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + * which allow you to manage message acknowledgments in bulk. That is, you can + * set the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + * If the snapshot already exists, returns `ALREADY_EXISTS`. + * If the requested subscription doesn't exist, returns `NOT_FOUND`. + * If the backlog in the subscription is too old -- and the resulting snapshot + * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. + * See also the `Snapshot.expire_time` field. If the name is not provided in + * the request, the server will assign a random + * name for this snapshot on the same project as the subscription, conforming + * to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The + * generated name is populated in the returned Snapshot object. Note that for + * REST API requests, you must specify a name in the request. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createSnapshot(CreateSnapshotRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createSnapshot(SnapshotName name) + *
  • createSnapshot(SnapshotName name) + *
  • createSnapshot(String name) + *
  • createSnapshot(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createSnapshotCallable() + *
+ * + *
SeekSeeks an existing subscription to a point in time or to a given snapshot, + * whichever is provided in the request. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. Note that both the subscription and the + * snapshot must be on the same topic. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • seek(SeekRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • seekCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index bb74a760d4..4ba719782e 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -78,19 +78,305 @@ *

Note: close() needs to be called on the TopicAdminClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListTopicSubscriptionsLists the names of the attached subscriptions on this topic. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listTopicSubscriptions(ListTopicSubscriptionsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listTopicSubscriptions(TopicName topic) + *
  • listTopicSubscriptions(String topic) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listTopicSubscriptionsPagedCallable() + *
  • listTopicSubscriptionsCallable() + *
+ * + *
DetachSubscriptionDetaches a subscription from this topic. All messages retained in the + * subscription are dropped. Subsequent `Pull` and `StreamingPull` requests + * will return FAILED_PRECONDITION. If the subscription is a push + * subscription, pushes to the endpoint will stop. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • detachSubscription(DetachSubscriptionRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • detachSubscriptionCallable() + *
+ * + *
CreateTopicCreates the given topic with the given name. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createTopic(Topic request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createTopic(TopicName name) + *
  • createTopic(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createTopicCallable() + *
+ * + *
ListTopicsLists matching topics. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listTopics(ListTopicsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listTopics(ProjectName project) + *
  • listTopics(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listTopicsPagedCallable() + *
  • listTopicsCallable() + *
+ * + *
GetTopicGets the configuration of a topic. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getTopic(GetTopicRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getTopic(TopicName topic) + *
  • getTopic(String topic) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getTopicCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
UpdateTopicUpdates an existing topic. Note that certain properties of a + * topic are not modifiable. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateTopic(UpdateTopicRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateTopicCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
DeleteTopicDeletes the topic with the given name. Returns `NOT_FOUND` if the topic + * does not exist. After a topic is deleted, a new topic may be created with + * the same name; this is an entirely new topic with none of the old + * configuration or subscriptions. Existing subscriptions to this topic are + * not deleted, but their `topic` field is set to `_deleted-topic_`. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteTopic(DeleteTopicRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteTopic(TopicName topic) + *
  • deleteTopic(String topic) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteTopicCallable() + *
+ * + *
ListTopicSnapshotsLists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + * which allow you to manage message acknowledgments in bulk. That is, you can + * set the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listTopicSnapshots(ListTopicSnapshotsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listTopicSnapshots(TopicName topic) + *
  • listTopicSnapshots(String topic) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listTopicSnapshotsPagedCallable() + *
  • listTopicSnapshotsCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces + * any existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
PublishAdds one or more messages to the topic. Returns `NOT_FOUND` if the topic + * does not exist. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • publish(PublishRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • publish(TopicName topic) + *
  • publish(String topic) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • publishCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index fb9a41852b..30fa378208 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -82,19 +82,334 @@ *

Note: close() needs to be called on the CloudRedisClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetInstanceGets the details of a specific Redis instance. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getInstance(GetInstanceRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getInstance(InstanceName name) + *
  • getInstance(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getInstanceCallable() + *
+ * + *
ExportInstanceExport Redis instance data into a Redis RDB format file in Cloud Storage. + * + * Redis will continue serving during this operation. + * + * The returned operation is automatically deleted after a few hours, so + * there is no need to call DeleteOperation. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • exportInstanceAsync(ExportInstanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • exportInstanceAsync(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • exportInstanceOperationCallable() + *
  • exportInstanceCallable() + *
+ * + *
ListInstancesLists all Redis instances owned by a project in either the specified + * location (region) or all locations. + * + * The location should have the following format: + * + * * `projects/{project_id}/locations/{location_id}` + * + * If `location_id` is specified as `-` (wildcard), then all regions + * available to the project are queried, and the results are aggregated. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listInstances(ListInstancesRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listInstances(LocationName parent) + *
  • listInstances(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listInstancesPagedCallable() + *
  • listInstancesCallable() + *
+ * + *
UpdateInstanceUpdates the metadata and configuration of a specific Redis instance. + * + * Completed longrunning.Operation will contain the new instance object + * in the response field. The returned operation is automatically deleted + * after a few hours, so there is no need to call DeleteOperation. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateInstanceAsync(UpdateInstanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • updateInstanceAsync(FieldMask updateMask) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateInstanceOperationCallable() + *
  • updateInstanceCallable() + *
+ * + *
GetInstanceAuthStringGets the AUTH string for a Redis instance. If AUTH is not enabled for the + * instance the response will be empty. This information is not included in + * the details returned to GetInstance. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getInstanceAuthString(GetInstanceAuthStringRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getInstanceAuthString(InstanceName name) + *
  • getInstanceAuthString(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getInstanceAuthStringCallable() + *
+ * + *
RescheduleMaintenanceReschedule maintenance for a given instance in a given project and + * location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • rescheduleMaintenanceAsync(InstanceName name) + *
  • rescheduleMaintenanceAsync(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • rescheduleMaintenanceOperationCallable() + *
  • rescheduleMaintenanceCallable() + *
+ * + *
CreateInstanceCreates a Redis instance based on the specified tier and memory size. + * + * By default, the instance is accessible from the project's + * [default network](https://cloud.google.com/vpc/docs/vpc). + * + * The creation is executed asynchronously and callers may check the returned + * operation to track its progress. Once the operation is completed the Redis + * instance will be fully functional. The completed longrunning.Operation will + * contain the new instance object in the response field. + * + * The returned operation is automatically deleted after a few hours, so there + * is no need to call DeleteOperation. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createInstanceAsync(CreateInstanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • createInstanceAsync(LocationName parent) + *
  • createInstanceAsync(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createInstanceOperationCallable() + *
  • createInstanceCallable() + *
+ * + *
ImportInstanceImport a Redis RDB snapshot file from Cloud Storage into a Redis instance. + * + * Redis may stop serving during this operation. Instance state will be + * IMPORTING for entire operation. When complete, the instance will contain + * only data from the imported file. + * + * The returned operation is automatically deleted after a few hours, so + * there is no need to call DeleteOperation. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • importInstanceAsync(ImportInstanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • importInstanceAsync(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • importInstanceOperationCallable() + *
  • importInstanceCallable() + *
+ * + *
FailoverInstanceInitiates a failover of the primary node to current replica node for a + * specific STANDARD tier Cloud Memorystore for Redis instance. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • failoverInstanceAsync(FailoverInstanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • failoverInstanceAsync(InstanceName name) + *
  • failoverInstanceAsync(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • failoverInstanceOperationCallable() + *
  • failoverInstanceCallable() + *
+ * + *
UpgradeInstanceUpgrades Redis instance to the newer Redis version specified in the + * request. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • upgradeInstanceAsync(UpgradeInstanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • upgradeInstanceAsync(InstanceName name) + *
  • upgradeInstanceAsync(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • upgradeInstanceOperationCallable() + *
  • upgradeInstanceCallable() + *
+ * + *
DeleteInstanceDeletes a specific Redis instance. Instance stops serving and data is + * deleted. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteInstanceAsync(DeleteInstanceRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • deleteInstanceAsync(InstanceName name) + *
  • deleteInstanceAsync(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteInstanceOperationCallable() + *
  • deleteInstanceCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index 650dafb7a8..729c820658 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -78,19 +78,796 @@ *

Note: close() needs to be called on the StorageClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
DeleteNotificationPermanently deletes a notification subscription. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteNotification(DeleteNotificationRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteNotification(NotificationName name) + *
  • deleteNotification(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteNotificationCallable() + *
+ * + *
DeleteObjectDeletes an object and its metadata. Deletions are permanent if versioning + * is not enabled for the bucket, or if the `generation` parameter is used. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteObject(DeleteObjectRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteObject(String bucket) + *
  • deleteObject(String bucket) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteObjectCallable() + *
+ * + *
StartResumableWriteStarts a resumable write. How long the write operation remains valid, and + * what happens when the write operation becomes invalid, are + * service-dependent. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • startResumableWrite(StartResumableWriteRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • startResumableWriteCallable() + *
+ * + *
SetIamPolicyUpdates an IAM policy for the specified bucket or object. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • setIamPolicy(ResourceName resource) + *
  • setIamPolicy(String resource) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
ListNotificationsRetrieves a list of notification subscriptions for a given bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listNotifications(ListNotificationsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listNotifications(ProjectName parent) + *
  • listNotifications(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listNotificationsPagedCallable() + *
  • listNotificationsCallable() + *
+ * + *
UpdateHmacKeyUpdates a given HMAC key state between ACTIVE and INACTIVE. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateHmacKey(UpdateHmacKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateHmacKey(HmacKeyMetadata hmacKey) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateHmacKeyCallable() + *
+ * + *
GetHmacKeyGets an existing HMAC key metadata for the given id. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getHmacKey(GetHmacKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getHmacKey(String accessId) + *
  • getHmacKey(String accessId) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getHmacKeyCallable() + *
+ * + *
DeleteBucketPermanently deletes an empty bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteBucket(DeleteBucketRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteBucket(BucketName name) + *
  • deleteBucket(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteBucketCallable() + *
+ * + *
TestIamPermissionsTests a set of permissions on the given bucket or object to see which, if + * any, are held by the caller. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • testIamPermissions(ResourceName resource) + *
  • testIamPermissions(String resource) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
ListBucketsRetrieves a list of buckets for a given project. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listBuckets(ListBucketsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listBuckets(ProjectName parent) + *
  • listBuckets(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listBucketsPagedCallable() + *
  • listBucketsCallable() + *
+ * + *
DeleteHmacKeyDeletes a given HMAC key. Key must be in an INACTIVE state. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteHmacKey(DeleteHmacKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteHmacKey(String accessId) + *
  • deleteHmacKey(String accessId) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteHmacKeyCallable() + *
+ * + *
ListHmacKeysLists HMAC keys under a given project with the additional filters provided. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listHmacKeys(ListHmacKeysRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listHmacKeys(ProjectName project) + *
  • listHmacKeys(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listHmacKeysPagedCallable() + *
  • listHmacKeysCallable() + *
+ * + *
GetObjectRetrieves an object's metadata. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getObject(GetObjectRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getObject(String bucket) + *
  • getObject(String bucket) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getObjectCallable() + *
+ * + *
CreateNotificationCreates a notification subscription for a given bucket. + * These notifications, when triggered, publish messages to the specified + * Pub/Sub topics. + * See https://cloud.google.com/storage/docs/pubsub-notifications. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createNotification(CreateNotificationRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createNotification(ProjectName parent) + *
  • createNotification(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createNotificationCallable() + *
+ * + *
WriteObjectStores a new object and metadata. + * + * An object can be written either in a single message stream or in a + * resumable sequence of message streams. To write using a single stream, + * the client should include in the first message of the stream an + * `WriteObjectSpec` describing the destination bucket, object, and any + * preconditions. Additionally, the final message must set 'finish_write' to + * true, or else it is an error. + * + * For a resumable write, the client should instead call + * `StartResumableWrite()`, populating a `WriteObjectSpec` into that request. + * They should then attach the returned `upload_id` to the first message of + * each following call to `WriteObject`. If the stream is closed before + * finishing the upload (either explicitly by the client or due to a network + * error or an error response from the server), the client should do as + * follows: + * - Check the result Status of the stream, to determine if writing can be + * resumed on this stream or must be restarted from scratch (by calling + * `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED, + * INTERNAL, and UNAVAILABLE. For each case, the client should use binary + * exponential backoff before retrying. Additionally, writes can be + * resumed after RESOURCE_EXHAUSTED errors, but only after taking + * appropriate measures, which may include reducing aggregate send rate + * across clients and/or requesting a quota increase for your project. + * - If the call to `WriteObject` returns `ABORTED`, that indicates + * concurrent attempts to update the resumable write, caused either by + * multiple racing clients or by a single client where the previous + * request was timed out on the client side but nonetheless reached the + * server. In this case the client should take steps to prevent further + * concurrent writes (e.g., increase the timeouts, stop using more than + * one process to perform the upload, etc.), and then should follow the + * steps below for resuming the upload. + * - For resumable errors, the client should call `QueryWriteStatus()` and + * then continue writing from the returned `persisted_size`. This may be + * less than the amount of data the client previously sent. Note also that + * it is acceptable to send data starting at an offset earlier than the + * returned `persisted_size`; in this case, the service will skip data at + * offsets that were already persisted (without checking that it matches + * the previously written data), and write only the data starting from the + * persisted offset. This behavior can make client-side handling simpler + * in some cases. + * + * The service will not view the object as complete until the client has + * sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any + * requests on a stream after sending a request with `finish_write` set to + * `true` will cause an error. The client **should** check the response it + * receives to determine how much data the service was able to commit and + * whether the service views the object as complete. + * + * Attempting to resume an already finalized object will result in an OK + * status, with a WriteObjectResponse containing the finalized object's + * metadata. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • writeObjectCallable() + *
+ * + *
GetServiceAccountRetrieves the name of a project's Google Cloud Storage service account. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getServiceAccount(GetServiceAccountRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getServiceAccount(ProjectName project) + *
  • getServiceAccount(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getServiceAccountCallable() + *
+ * + *
ListObjectsRetrieves a list of objects matching the criteria. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listObjects(ListObjectsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listObjects(ProjectName parent) + *
  • listObjects(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listObjectsPagedCallable() + *
  • listObjectsCallable() + *
+ * + *
GetBucketReturns metadata for the specified bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getBucket(GetBucketRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getBucket(BucketName name) + *
  • getBucket(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getBucketCallable() + *
+ * + *
UpdateObjectUpdates an object's metadata. + * Equivalent to JSON API's storage.objects.patch. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateObject(UpdateObjectRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateObject(Object object) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateObjectCallable() + *
+ * + *
GetIamPolicyGets the IAM policy for a specified bucket or object. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getIamPolicy(ResourceName resource) + *
  • getIamPolicy(String resource) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
QueryWriteStatusDetermines the `persisted_size` for an object that is being written, which + * can then be used as the `write_offset` for the next `Write()` call. + * + * If the object does not exist (i.e., the object has been deleted, or the + * first `Write()` has not yet reached the service), this method returns the + * error `NOT_FOUND`. + * + * The client **may** call `QueryWriteStatus()` at any time to determine how + * much data has been processed for this object. This is useful if the + * client is buffering data and needs to know which data can be safely + * evicted. For any sequence of `QueryWriteStatus()` calls for a given + * object name, the sequence of returned `persisted_size` values will be + * non-decreasing. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • queryWriteStatus(QueryWriteStatusRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • queryWriteStatus(String uploadId) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • queryWriteStatusCallable() + *
+ * + *
RewriteObjectRewrites a source object to a destination object. Optionally overrides + * metadata. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • rewriteObject(RewriteObjectRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • rewriteObjectCallable() + *
+ * + *
LockBucketRetentionPolicyLocks retention policy on a bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • lockBucketRetentionPolicy(BucketName bucket) + *
  • lockBucketRetentionPolicy(String bucket) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • lockBucketRetentionPolicyCallable() + *
+ * + *
CreateHmacKeyCreates a new HMAC key for the given service account. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createHmacKey(CreateHmacKeyRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createHmacKey(ProjectName project) + *
  • createHmacKey(String project) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createHmacKeyCallable() + *
+ * + *
ComposeObjectConcatenates a list of existing objects into a new object in the same + * bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • composeObject(ComposeObjectRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • composeObjectCallable() + *
+ * + *
CancelResumableWriteCancels an in-progress resumable upload. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • cancelResumableWrite(CancelResumableWriteRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • cancelResumableWrite(String uploadId) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • cancelResumableWriteCallable() + *
+ * + *
UpdateBucketUpdates a bucket. Equivalent to JSON API's storage.buckets.patch method. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateBucket(UpdateBucketRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • updateBucket(Bucket bucket) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateBucketCallable() + *
+ * + *
ReadObjectReads an object's data. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • readObjectCallable() + *
+ * + *
CreateBucketCreates a new bucket. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createBucket(CreateBucketRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createBucket(ProjectName parent) + *
  • createBucket(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createBucketCallable() + *
+ * + *
GetNotificationView a notification config. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getNotification(GetNotificationRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getNotification(BucketName name) + *
  • getNotification(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getNotificationCallable() + *
+ * + *
* *

See the individual methods for example code. * From 218eb5dd018c79a3b73c2aa7e061e6945718fa2e Mon Sep 17 00:00:00 2001 From: Alice Li Date: Thu, 12 Oct 2023 17:19:41 -0400 Subject: [PATCH 02/21] fix lint --- .../composer/common/AbstractServiceClientClassComposer.java | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java index 4899df67f6..df1e848a5f 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java @@ -595,7 +595,10 @@ private static List createServiceMethods( if (m.arguments().isEmpty()) { s = m.methodIdentifier().name() + "()"; } else { - String argument = m.arguments().get(0).variable().type().reference() != null ? m.arguments().get(0).variable().type().reference().name() + " " : ""; + String argument = + m.arguments().get(0).variable().type().reference() != null + ? m.arguments().get(0).variable().type().reference().name() + " " + : ""; s = m.methodIdentifier().name() + "(" From dd3d21ebe2db8350d5f3971d7c5ca0198aeefdf0 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Thu, 12 Oct 2023 17:26:07 -0400 Subject: [PATCH 03/21] update showcase goldens --- .../showcase/v1beta1/ComplianceClient.java | 317 ++++++++++++- .../google/showcase/v1beta1/EchoClient.java | 283 +++++++++++- .../showcase/v1beta1/IdentityClient.java | 233 +++++++++- .../showcase/v1beta1/MessagingClient.java | 435 +++++++++++++++++- .../v1beta1/SequenceServiceClient.java | 256 ++++++++++- .../showcase/v1beta1/TestingClient.java | 277 ++++++++++- 6 files changed, 1723 insertions(+), 78 deletions(-) diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java index c760c1f1a4..aa57e88c80 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java @@ -79,19 +79,310 @@ *

Note: close() needs to be called on the ComplianceClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetEnumThis method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the + * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the + * response from this RPC as the request to VerifyEnum() + * + * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for + * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getEnum(EnumRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getEnumCallable() + *
+ * + *
RepeatDataPathTrailingResourceSame as RepeatDataSimplePath, but with a trailing resource. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataPathTrailingResource(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataPathTrailingResourceCallable() + *
+ * + *
VerifyEnumThis method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum() + * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds + * with the same EnumResponse; otherwise, the RPC errors. + * + * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run, + * although they are not guaranteed to be the same across separate Showcase server runs. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • verifyEnum(EnumResponse request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • verifyEnumCallable() + *
+ * + *
RepeatDataQueryThis method echoes the ComplianceData request. This method exercises + * sending all request fields as query parameters. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataQuery(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataQueryCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
RepeatDataSimplePathThis method echoes the ComplianceData request. This method exercises + * sending some parameters as "simple" path variables (i.e., of the form + * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataSimplePath(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataSimplePathCallable() + *
+ * + *
RepeatDataBodyPutThis method echoes the ComplianceData request, using the HTTP PUT method. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataBodyPut(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataBodyPutCallable() + *
+ * + *
RepeatDataBodyPatchThis method echoes the ComplianceData request, using the HTTP PATCH method. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataBodyPatch(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataBodyPatchCallable() + *
+ * + *
GetLocationGets information about a location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLocation(GetLocationRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLocationCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
RepeatDataPathResourceSame as RepeatDataSimplePath, but with a path resource. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataPathResource(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataPathResourceCallable() + *
+ * + *
ListLocationsLists information about the supported locations for this service. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLocations(ListLocationsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ * + *
RepeatDataBodyThis method echoes the ComplianceData request. This method exercises + * sending the entire request object in the REST body. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataBody(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataBodyCallable() + *
+ * + *
RepeatDataBodyInfoThis method echoes the ComplianceData request. This method exercises + * sending the a message-type field in the REST body. Per AIP-127, only + * top-level, non-repeated fields can be sent this way. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • repeatDataBodyInfo(RepeatRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • repeatDataBodyInfoCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java index 687f28376b..89a511692a 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java @@ -82,19 +82,276 @@ *

Note: close() needs to be called on the EchoClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
PagedExpandLegacyMappedThis method returns a map containing lists of words that appear in the input, keyed by their + * initial character. The only words returned are the ones included in the current page, + * as determined by page_token and page_size, which both refer to the word indices in the + * input. This paging result consisting of a map of lists is a pattern used by some legacy + * APIs. New APIs should NOT use this pattern. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • pagedExpandLegacyMapped(PagedExpandRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • pagedExpandLegacyMappedPagedCallable() + *
  • pagedExpandLegacyMappedCallable() + *
+ * + *
EchoThis method simply echoes the request. This method showcases unary RPCs. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • echo(EchoRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • echoCallable() + *
+ * + *
CollectThis method will collect the words given to it. When the stream is closed + * by the client, this method will return the a concatenation of the strings + * passed to it. This method showcases client-side streaming RPCs. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • collectCallable() + *
+ * + *
PagedExpandThis is similar to the Expand method but instead of returning a stream of + * expanded words, this method returns a paged list of expanded words. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • pagedExpand(PagedExpandRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • pagedExpandPagedCallable() + *
  • pagedExpandCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
PagedExpandLegacyThis is similar to the PagedExpand except that it uses + * max_results instead of page_size, as some legacy APIs still + * do. New APIs should NOT use this pattern. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • pagedExpandLegacy(PagedExpandLegacyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • pagedExpandLegacyCallable() + *
+ * + *
ExpandThis method splits the given content into words and will pass each word back + * through the stream. This method showcases server-side streaming RPCs. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • expandCallable() + *
+ * + *
ChatThis method, upon receiving a request on the stream, will pass the same + * content back on the stream. This method showcases bidirectional + * streaming RPCs. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • chatCallable() + *
+ * + *
GetLocationGets information about a location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLocation(GetLocationRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLocationCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
BlockThis method will block (wait) for the requested amount of time + * and then return the response or error. + * This method showcases how a client handles delays or retries. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • block(BlockRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • blockCallable() + *
+ * + *
WaitThis method will wait for the requested amount of time and then return. + * This method showcases how a client handles a request timeout. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • waitAsync(WaitRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • waitOperationCallable() + *
  • waitCallable() + *
+ * + *
ListLocationsLists information about the supported locations for this service. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLocations(ListLocationsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java index 93777c8925..ee2d7df654 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java @@ -66,19 +66,226 @@ *

Note: close() needs to be called on the IdentityClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
ListUsersLists all users. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listUsers(ListUsersRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listUsersPagedCallable() + *
  • listUsersCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
GetLocationGets information about a location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLocation(GetLocationRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLocationCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
CreateUserCreates a user. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createUser(CreateUserRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createUser(String displayName) + *
  • createUser(String displayName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createUserCallable() + *
+ * + *
DeleteUserDeletes a user, their profile, and all of their authored messages. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteUser(DeleteUserRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteUser(UserName name) + *
  • deleteUser(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteUserCallable() + *
+ * + *
UpdateUserUpdates a user. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateUser(UpdateUserRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateUserCallable() + *
+ * + *
ListLocationsLists information about the supported locations for this service. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLocations(ListLocationsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
GetUserRetrieves the User with the given uri. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getUser(GetUserRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getUser(UserName name) + *
  • getUser(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getUserCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java index 38922dbca2..bd7efedd9e 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java @@ -77,19 +77,428 @@ *

Note: close() needs to be called on the MessagingClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
SearchBlurbsThis method searches through all blurbs across all rooms and profiles + * for blurbs containing to words found in the query. Only posts that + * contain an exact match of a queried word will be returned. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • searchBlurbsAsync(SearchBlurbsRequest request) + *
+ * + *

Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

+ * + *
    + *
  • searchBlurbsAsync(ProfileName parent) + *
  • searchBlurbsAsync(RoomName parent) + *
  • searchBlurbsAsync(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • searchBlurbsOperationCallable() + *
  • searchBlurbsCallable() + *
+ * + *
ConnectThis method starts a bidirectional stream that receives all blurbs that + * are being created after the stream has started and sends requests to create + * blurbs. If an invalid blurb is requested to be created, the stream will + * close with an error. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • connectCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
SendBlurbsThis is a stream to create multiple blurbs. If an invalid blurb is + * requested to be created, the stream will close with an error. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • sendBlurbsCallable() + *
+ * + *
UpdateRoomUpdates a room. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateRoom(UpdateRoomRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateRoomCallable() + *
+ * + *
GetBlurbRetrieves the Blurb with the given resource name. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getBlurb(GetBlurbRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getBlurb(BlurbName name) + *
  • getBlurb(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getBlurbCallable() + *
+ * + *
GetRoomRetrieves the Room with the given resource name. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getRoom(GetRoomRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getRoom(RoomName name) + *
  • getRoom(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getRoomCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
UpdateBlurbUpdates a blurb. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • updateBlurb(UpdateBlurbRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • updateBlurbCallable() + *
+ * + *
ListBlurbsLists blurbs for a specific chat room or user profile depending on the + * parent resource name. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listBlurbs(ListBlurbsRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • listBlurbs(ProfileName parent) + *
  • listBlurbs(RoomName parent) + *
  • listBlurbs(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listBlurbsPagedCallable() + *
  • listBlurbsCallable() + *
+ * + *
StreamBlurbsThis returns a stream that emits the blurbs that are created for a + * particular chat room or user profile. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • streamBlurbsCallable() + *
+ * + *
DeleteRoomDeletes a room and all of its blurbs. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteRoom(DeleteRoomRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteRoom(RoomName name) + *
  • deleteRoom(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteRoomCallable() + *
+ * + *
ListRoomsLists all chat rooms. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listRooms(ListRoomsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listRoomsPagedCallable() + *
  • listRoomsCallable() + *
+ * + *
GetLocationGets information about a location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLocation(GetLocationRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLocationCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
CreateRoomCreates a room. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createRoom(CreateRoomRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createRoom(String displayName) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createRoomCallable() + *
+ * + *
ListLocationsLists information about the supported locations for this service. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLocations(ListLocationsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ * + *
CreateBlurbCreates a blurb. If the parent is a room, the blurb is understood to be a + * message in that room. If the parent is a profile, the blurb is understood + * to be a post on the profile. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createBlurb(CreateBlurbRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createBlurb(ProfileName parent) + *
  • createBlurb(ProfileName parent) + *
  • createBlurb(ProfileName parent) + *
  • createBlurb(ProfileName parent) + *
  • createBlurb(RoomName parent) + *
  • createBlurb(RoomName parent) + *
  • createBlurb(RoomName parent) + *
  • createBlurb(RoomName parent) + *
  • createBlurb(String parent) + *
  • createBlurb(String parent) + *
  • createBlurb(String parent) + *
  • createBlurb(String parent) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createBlurbCallable() + *
+ * + *
DeleteBlurbDeletes a blurb. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteBlurb(DeleteBlurbRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • deleteBlurb(BlurbName name) + *
  • deleteBlurb(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteBlurbCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java index ab56a9a453..152b63db82 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java @@ -65,19 +65,249 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
GetSequenceReportRetrieves a sequence. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSequenceReport(GetSequenceReportRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getSequenceReport(SequenceReportName name) + *
  • getSequenceReport(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSequenceReportCallable() + *
+ * + *
GetStreamingSequenceReportRetrieves a sequence. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getStreamingSequenceReport(GetStreamingSequenceReportRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • getStreamingSequenceReport(StreamingSequenceReportName name) + *
  • getStreamingSequenceReport(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getStreamingSequenceReportCallable() + *
+ * + *
AttemptStreamingSequenceAttempts a streaming sequence. + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • attemptStreamingSequenceCallable() + *
+ * + *
AttemptSequenceAttempts a sequence. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • attemptSequence(AttemptSequenceRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • attemptSequence(SequenceName name) + *
  • attemptSequence(String name) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • attemptSequenceCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
CreateStreamingSequenceCreates a sequence. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createStreamingSequence(CreateStreamingSequenceRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createStreamingSequence(StreamingSequence streamingSequence) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createStreamingSequenceCallable() + *
+ * + *
GetLocationGets information about a location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLocation(GetLocationRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLocationCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
CreateSequenceCreates a sequence. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createSequence(CreateSequenceRequest request) + *
+ * + *

"Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

+ * + *
    + *
  • createSequence(Sequence sequence) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createSequenceCallable() + *
+ * + *
ListLocationsLists information about the supported locations for this service. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLocations(ListLocationsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
* *

See the individual methods for example code. * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java index 9691ed234a..65c6728bbf 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java @@ -66,19 +66,270 @@ *

Note: close() needs to be called on the TestingClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

    - *
  1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
  2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
  3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
MethodDescriptionMethod Variants
DeleteTestExplicitly decline to implement a test. + * + * This removes the test from subsequent `ListTests` calls, and + * attempting to do the test will error. + * + * This method will error if attempting to delete a required test. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteTest(DeleteTestRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteTestCallable() + *
+ * + *
GetIamPolicyGets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getIamPolicy(GetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getIamPolicyCallable() + *
+ * + *
CreateSessionCreates a new testing session. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • createSession(CreateSessionRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • createSessionCallable() + *
+ * + *
SetIamPolicySets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • setIamPolicy(SetIamPolicyRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • setIamPolicyCallable() + *
+ * + *
GetSessionGets a testing session. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getSession(GetSessionRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getSessionCallable() + *
+ * + *
DeleteSessionDelete a test session. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • deleteSession(DeleteSessionRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • deleteSessionCallable() + *
+ * + *
VerifyTestRegister a response to a test. + * + * In cases where a test involves registering a final answer at the + * end of the test, this method provides the means to do so. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • verifyTest(VerifyTestRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • verifyTestCallable() + *
+ * + *
GetLocationGets information about a location. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • getLocation(GetLocationRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • getLocationCallable() + *
+ * + *
TestIamPermissionsReturns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • testIamPermissions(TestIamPermissionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • testIamPermissionsCallable() + *
+ * + *
ListTestsList the tests of a sessesion. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listTests(ListTestsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listTestsPagedCallable() + *
  • listTestsCallable() + *
+ * + *
ListLocationsLists information about the supported locations for this service. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listLocations(ListLocationsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listLocationsPagedCallable() + *
  • listLocationsCallable() + *
+ * + *
ReportSessionReport on the status of a session. + * This generates a report detailing which tests have been completed, + * and an overall rollup. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • reportSession(ReportSessionRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • reportSessionCallable() + *
+ * + *
ListSessionsLists the current test sessions. + *

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

+ * + *
    + *
  • listSessions(ListSessionsRequest request) + *
+ * + *

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

+ * + *
    + *
  • listSessionsPagedCallable() + *
  • listSessionsCallable() + *
+ * + *
* *

See the individual methods for example code. * From 116ca1cfc4b64ff4523beae86c880f91fae99bf5 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 13 Oct 2023 15:53:01 -0400 Subject: [PATCH 04/21] remove unnecessary newlines and encapsulate method description within

tags --- .../comment/ServiceClientCommentComposer.java | 18 +- ...cServiceClientWithNestedClassImport.golden | 6 +- .../grpc/goldens/BookshopClient.golden | 8 +- .../goldens/DeprecatedServiceClient.golden | 12 +- .../composer/grpc/goldens/EchoClient.golden | 58 +--- .../grpc/goldens/IdentityClient.golden | 36 +-- .../grpc/goldens/MessagingClient.golden | 94 +------ .../grpcrest/goldens/EchoClient.golden | 70 +---- .../grpcrest/goldens/WickedClient.golden | 14 +- .../v1/ConnectionServiceClient.java | 10 +- .../cloud/apigeeconnect/v1/TetherClient.java | 6 +- .../cloud/asset/v1/AssetServiceClient.java | 166 +++--------- .../data/v2/BaseBigtableDataClient.java | 56 +--- .../compute/v1small/AddressesClient.java | 32 +-- .../v1small/RegionOperationsClient.java | 18 +- .../credentials/v1/IamCredentialsClient.java | 32 +-- .../com/google/iam/v1/IAMPolicyClient.java | 24 +- .../kms/v1/KeyManagementServiceClient.java | 240 ++++------------- .../library/v1/LibraryServiceClient.java | 96 ++----- .../google/cloud/logging/v2/ConfigClient.java | 216 +++------------ .../cloud/logging/v2/LoggingClient.java | 52 +--- .../cloud/logging/v2/MetricsClient.java | 40 +-- .../cloud/pubsub/v1/SchemaServiceClient.java | 102 ++----- .../pubsub/v1/SubscriptionAdminClient.java | 170 +++--------- .../cloud/pubsub/v1/TopicAdminClient.java | 104 ++------ .../cloud/redis/v1beta1/CloudRedisClient.java | 108 ++------ .../com/google/storage/v2/StorageClient.java | 248 +++--------------- 27 files changed, 373 insertions(+), 1663 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index e8194d09cb..7e305b0c87 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -228,13 +228,13 @@ public static List createRpcMethodHeaderComment( private static String createTableOfMethods(List methodAndVariantsList) { String FLATTENED_METHODS = - "

\"Flattened\" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

\n\n"; + "

\"Flattened\" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

\n"; String REQUEST_OBJECT_METHODS = - "

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

\n\n"; + "

Request object method variants only takes one parameter, a request object, which must be constructed before the call.

\n"; String CALLABLE_METHODS = - "

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

\n\n"; + "

Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

\n"; String ASYNC_METHODS = - "

Methods that return long-running operations have \"Async\" method variants that return `OperationFuture` which is used to track polling of the service.

\n\n"; + "

Methods that return long-running operations have \"Async\" method variants that return `OperationFuture` which is used to track polling of the service.

\n"; StringBuilder tableBuilder = new StringBuilder(); tableBuilder @@ -250,7 +250,7 @@ private static String createTableOfMethods(List methodAndVari .append(method.method) .append("\n") .append(" ") - .append(method.description) + .append("

"+ method.description + "

") .append("\n") .append(" \n"); if (method.hasRequestObjectVariants) { @@ -261,7 +261,7 @@ private static String createTableOfMethods(List methodAndVari .append(String.join("\n
  • ", method.requestObjectVariants)) .append("\n") .append(" ") - .append("\n\n"); + .append("\n"); } if (method.hasFlattenedVariants) { tableBuilder @@ -271,7 +271,7 @@ private static String createTableOfMethods(List methodAndVari .append(String.join("\n
  • ", method.flattenedVariants)) .append("\n") .append(" ") - .append("\n\n"); + .append("\n"); } if (method.hasAsyncVariants) { tableBuilder @@ -281,7 +281,7 @@ private static String createTableOfMethods(List methodAndVari .append(String.join("\n
  • ", method.asyncVariants)) .append("\n") .append(" ") - .append("\n\n"); + .append("\n"); } if (method.hasCallableVariants) { tableBuilder @@ -291,7 +291,7 @@ private static String createTableOfMethods(List methodAndVari .append(String.join("\n
  • ", method.callableVariants)) .append("\n") .append(" ") - .append("\n\n"); + .append("\n"); } tableBuilder.append(" \n").append(" \n"); } diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden index 7fa727683e..ec78bea370 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden @@ -38,20 +38,16 @@ import javax.annotation.Generated; * Method Variants * * NestedMessageMethod - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • nestedMessageMethod(Outer.Middle request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • nestedMessageMethodCallable() *
    - * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden index 6ab6b4f77f..630306eb18 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden @@ -38,27 +38,21 @@ import javax.annotation.Generated; * Method Variants * * GetBook - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getBook(GetBookRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getBook(booksCount) *
    • getBook(String booksList) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getBookCallable() *
    - * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden index 67f9dd49a0..1927fa0a4b 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden @@ -37,38 +37,30 @@ import javax.annotation.Generated; * Method Variants * * SlowFibonacci - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • slowFibonacci(FibonacciRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • slowFibonacciCallable() *
    - * * * * * FastFibonacci - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • fastFibonacci(FibonacciRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • fastFibonacciCallable() *
    - * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden index 335f9a5de1..af92656e6d 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden @@ -59,16 +59,13 @@ import javax.annotation.Generated; * Method Variants * * Echo - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • echo(EchoRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • echo() *
    • echo(ResourceName parent) @@ -79,167 +76,132 @@ import javax.annotation.Generated; *
    • echo(String parent) *
    • echo(String content) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • echoCallable() *
    - * * * * * Collect - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • collectCallable() *
    - * * * * * Expand - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • expandCallable() *
    - * * * * * PagedExpand - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • pagedExpand(PagedExpandRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • pagedExpandPagedCallable() *
    • pagedExpandCallable() *
    - * * * * * Chat - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • chatCallable() *
    - * * * * * Block - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • block(BlockRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • blockCallable() *
    - * * * * * Wait - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • waitAsync(WaitRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • waitAsync(Duration ttl) *
    • waitAsync(Timestamp endTime) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • waitOperationCallable() *
    • waitCallable() *
    - * * * * * SimplePagedExpand - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • simplePagedExpand(PagedExpandRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • simplePagedExpand() *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • simplePagedExpandPagedCallable() *
    • simplePagedExpandCallable() *
    - * * * * * ChatAgain - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • chatAgainCallable() *
    - * * * * * CollideName - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • collideName(EchoRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • collideNameCallable() *
    - * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden index 245ababcbc..2199646ef3 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden @@ -47,115 +47,89 @@ import javax.annotation.Generated; * Method Variants * * ListUsers - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listUsers(ListUsersRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listUsersPagedCallable() *
    • listUsersCallable() *
    - * * * * * CreateUser - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createUser(CreateUserRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createUser(String parent) *
    • createUser(String parent) *
    • createUser(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createUserCallable() *
    - * * * * * DeleteUser - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteUser(DeleteUserRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteUser(UserName name) *
    • deleteUser(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteUserCallable() *
    - * * * * * UpdateUser - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateUser(UpdateUserRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateUserCallable() *
    - * * * * * GetUser - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getUser(GetUserRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getUser(UserName name) *
    • getUser(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getUserCallable() *
    - * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden index a5ea61e3f9..a19db5582a 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden @@ -54,258 +54,201 @@ import javax.annotation.Generated; * Method Variants * * SearchBlurbs - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • searchBlurbsAsync(SearchBlurbsRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • searchBlurbsAsync(String query) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • searchBlurbsOperationCallable() *
    • searchBlurbsCallable() *
    - * * * * * Connect - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • connectCallable() *
    - * * * * * SendBlurbs - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • sendBlurbsCallable() *
    - * * * * * UpdateRoom - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateRoom(UpdateRoomRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateRoomCallable() *
    - * * * * * GetBlurb - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getBlurb(GetBlurbRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getBlurb(BlurbName name) *
    • getBlurb(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getBlurbCallable() *
    - * * * * * GetRoom - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getRoom(GetRoomRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getRoom(RoomName name) *
    • getRoom(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getRoomCallable() *
    - * * * * * UpdateBlurb - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateBlurb(UpdateBlurbRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateBlurbCallable() *
    - * * * * * ListBlurbs - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listBlurbs(ListBlurbsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listBlurbs(ProfileName parent) *
    • listBlurbs(RoomName parent) *
    • listBlurbs(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listBlurbsPagedCallable() *
    • listBlurbsCallable() *
    - * * * * * StreamBlurbs - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • streamBlurbsCallable() *
    - * * * * * DeleteRoom - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteRoom(DeleteRoomRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteRoom(RoomName name) *
    • deleteRoom(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteRoomCallable() *
    - * * * * * ListRooms - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listRooms(ListRoomsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listRoomsPagedCallable() *
    • listRoomsCallable() *
    - * * * * * CreateRoom - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createRoom(CreateRoomRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createRoom(String displayName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createRoomCallable() *
    - * * * * * CreateBlurb - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createBlurb(CreateBlurbRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createBlurb(ProfileName parent) *
    • createBlurb(ProfileName parent) @@ -314,38 +257,29 @@ import javax.annotation.Generated; *
    • createBlurb(String parent) *
    • createBlurb(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createBlurbCallable() *
    - * * * * * DeleteBlurb - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteBlurb(DeleteBlurbRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteBlurb(BlurbName name) *
    • deleteBlurb(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteBlurbCallable() *
    - * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index 1075a3d85c..0c26809459 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -54,16 +54,13 @@ import javax.annotation.Generated; * Method Variants * * Echo - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • echo(EchoRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • echo() *
    • echo(ResourceName parent) @@ -74,203 +71,158 @@ import javax.annotation.Generated; *
    • echo(String parent) *
    • echo(String content) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • echoCallable() *
    - * * * * * NoBinding - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • noBinding(EchoRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • noBindingCallable() *
    - * * * * * Expand - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • expandCallable() *
    - * * * * * PagedExpand - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • pagedExpand(PagedExpandRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • pagedExpandPagedCallable() *
    • pagedExpandCallable() *
    - * * * * * Chat - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • chatCallable() *
    - * * * * * Block - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • block(BlockRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • blockCallable() *
    - * * * * * Wait - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • waitAsync(WaitRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • waitAsync(Duration ttl) *
    • waitAsync(Timestamp endTime) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • waitOperationCallable() *
    • waitCallable() *
    - * * * * * SimplePagedExpand - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • simplePagedExpand(PagedExpandRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • simplePagedExpand() *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • simplePagedExpandPagedCallable() *
    • simplePagedExpandCallable() *
    - * * * * * CollideName - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • collideName(EchoRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • collideNameCallable() *
    - * * * * * NestedBinding - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • nestedBinding(EchoRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • nestedBindingCallable() *
    - * * * * * UpdateCase - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateCase(UpdateCaseRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateCase(Case case_) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateCaseCallable() *
    - * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden index 84a7518515..7637bff29a 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden @@ -39,44 +39,36 @@ import javax.annotation.Generated; * Method Variants * * BrainstormEvilPlans - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • brainstormEvilPlansCallable() *
    - * * * * * PersuadeEvilPlan - * + *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • persuadeEvilPlanCallable() *
    - * * * * * CraftEvilPlan - * + *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • craftEvilPlan(EvilRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • craftEvilPlanCallable() *
    - * * * * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java index 692e117360..d41dc4399f 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java @@ -64,29 +64,23 @@ * Method Variants * * ListConnections - * Lists connections that are currently active for the given Apigee Connect - * endpoint. + *

    Lists connections that are currently active for the given Apigee Connect + * endpoint.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listConnections(ListConnectionsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listConnections(EndpointName parent) *
    • listConnections(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listConnectionsPagedCallable() *
    • listConnectionsCallable() *
    - * * * * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java index 8a241e2ff0..fbb28f87c3 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java @@ -68,20 +68,18 @@ * Method Variants * * Egress - * Egress streams egress requests and responses. Logically, this is not + *

    Egress streams egress requests and responses. Logically, this is not * actually a streaming request, but uses streaming as a mechanism to flip * the client-server relationship of gRPC so that the server can act as a * client. * The listener, the RPC server, accepts connections from the dialer, * the RPC client. - * The listener streams http requests and the dialer streams http responses. + * The listener streams http requests and the dialer streams http responses.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • egressCallable() *
    - * * * * diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index 2296991a0c..07eb2dab2c 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -76,123 +76,97 @@ * Method Variants * * UpdateFeed - * Updates an asset feed configuration. + *

    Updates an asset feed configuration.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateFeed(UpdateFeedRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateFeed(Feed feed) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateFeedCallable() *
    - * * * * * ListFeeds - * Lists all asset feeds in a parent project/folder/organization. + *

    Lists all asset feeds in a parent project/folder/organization.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listFeeds(ListFeedsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listFeeds(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listFeedsCallable() *
    - * * * * * GetFeed - * Gets details about an asset feed. + *

    Gets details about an asset feed.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getFeed(GetFeedRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getFeed(FeedName name) *
    • getFeed(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getFeedCallable() *
    - * * * * * BatchGetAssetsHistory - * Batch gets the update history of assets that overlap a time window. + *

    Batch gets the update history of assets that overlap a time window. * For IAM_POLICY content, this API outputs history when the asset and its * attached IAM POLICY both exist. This can create gaps in the output history. * Otherwise, this API outputs history with asset in both non-delete or * deleted status. * If a specified asset does not exist, this API returns an INVALID_ARGUMENT - * error. + * error.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • batchGetAssetsHistoryCallable() *
    - * * * * * AnalyzeIamPolicy - * Analyzes IAM policies to answer which identities have what accesses on - * which resources. + *

    Analyzes IAM policies to answer which identities have what accesses on + * which resources.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • analyzeIamPolicy(AnalyzeIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • analyzeIamPolicyCallable() *
    - * * * * * ExportAssets - * Exports assets with time and resource types to a given Cloud Storage + *

    Exports assets with time and resource types to a given Cloud Storage * location/BigQuery table. For Cloud Storage location destinations, the * output format is newline-delimited JSON. Each line represents a * [google.cloud.asset.v1.Asset][google.cloud.asset.v1.Asset] in the JSON format; for BigQuery table @@ -201,130 +175,102 @@ * which allows you to keep track of the export. We recommend intervals of at * least 2 seconds with exponential retry to poll the export operation result. * For regular-size resource parent, the export operation usually finishes - * within 5 minutes. + * within 5 minutes.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • exportAssetsAsync(ExportAssetsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • exportAssetsOperationCallable() *
    • exportAssetsCallable() *
    - * * * * * GetSavedQuery - * Gets details about a saved query. + *

    Gets details about a saved query.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSavedQuery(GetSavedQueryRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getSavedQuery(SavedQueryName name) *
    • getSavedQuery(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSavedQueryCallable() *
    - * * * * * CreateSavedQuery - * Creates a saved query in a parent project/folder/organization. + *

    Creates a saved query in a parent project/folder/organization.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createSavedQuery(CreateSavedQueryRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createSavedQuery(FolderName parent) *
    • createSavedQuery(OrganizationName parent) *
    • createSavedQuery(ProjectName parent) *
    • createSavedQuery(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createSavedQueryCallable() *
    - * * * * * ListAssets - * Lists assets with time and resource types and returns paged results in - * response. + *

    Lists assets with time and resource types and returns paged results in + * response.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listAssets(ListAssetsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listAssets(ResourceName parent) *
    • listAssets(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listAssetsPagedCallable() *
    • listAssetsCallable() *
    - * * * * * DeleteFeed - * Deletes an asset feed. + *

    Deletes an asset feed.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteFeed(DeleteFeedRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteFeed(FeedName name) *
    • deleteFeed(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteFeedCallable() *
    - * * * * * QueryAssets - * Issue a job that queries assets using a SQL statement compatible with + *

    Issue a job that queries assets using a SQL statement compatible with * [BigQuery Standard * SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql). * @@ -337,102 +283,80 @@ * Note, the query result has approximately 10 GB limitation enforced by * BigQuery * https://cloud.google.com/bigquery/docs/best-practices-performance-output, - * queries return larger results will result in errors. + * queries return larger results will result in errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • queryAssets(QueryAssetsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • queryAssetsCallable() *
    - * * * * * DeleteSavedQuery - * Deletes a saved query. + *

    Deletes a saved query.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteSavedQuery(DeleteSavedQueryRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteSavedQuery(SavedQueryName name) *
    • deleteSavedQuery(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteSavedQueryCallable() *
    - * * * * * SearchAllResources - * Searches all Cloud resources within the specified scope, such as a project, + *

    Searches all Cloud resources within the specified scope, such as a project, * folder, or organization. The caller must be granted the * `cloudasset.assets.searchAllResources` permission on the desired scope, - * otherwise the request will be rejected. + * otherwise the request will be rejected.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • searchAllResources(SearchAllResourcesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • searchAllResources(String scope) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • searchAllResourcesPagedCallable() *
    • searchAllResourcesCallable() *
    - * * * * * UpdateSavedQuery - * Updates a saved query. + *

    Updates a saved query.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateSavedQuery(UpdateSavedQueryRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateSavedQuery(SavedQuery savedQuery) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateSavedQueryCallable() *
    - * * * * * AnalyzeIamPolicyLongrunning - * Analyzes IAM policies asynchronously to answer which identities have what + *

    Analyzes IAM policies asynchronously to answer which identities have what * accesses on which resources, and writes the analysis results to a Google * Cloud Storage or a BigQuery destination. For Cloud Storage destination, the * output format is the JSON format that represents a @@ -440,142 +364,112 @@ * [google.longrunning.Operation][google.longrunning.Operation], which allows you to track the operation * status. We recommend intervals of at least 2 seconds with exponential * backoff retry to poll the operation result. The metadata contains the - * metadata for the long-running operation. + * metadata for the long-running operation.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • analyzeIamPolicyLongrunningOperationCallable() *
    • analyzeIamPolicyLongrunningCallable() *
    - * * * * * ListSavedQueries - * Lists all saved queries in a parent project/folder/organization. + *

    Lists all saved queries in a parent project/folder/organization.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listSavedQueries(ListSavedQueriesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listSavedQueries(FolderName parent) *
    • listSavedQueries(OrganizationName parent) *
    • listSavedQueries(ProjectName parent) *
    • listSavedQueries(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listSavedQueriesPagedCallable() *
    • listSavedQueriesCallable() *
    - * * * * * CreateFeed - * Creates a feed in a parent project/folder/organization to listen to its - * asset updates. + *

    Creates a feed in a parent project/folder/organization to listen to its + * asset updates.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createFeed(CreateFeedRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createFeed(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createFeedCallable() *
    - * * * * * BatchGetEffectiveIamPolicies - * Gets effective IAM policies for a batch of resources. + *

    Gets effective IAM policies for a batch of resources.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • batchGetEffectiveIamPoliciesCallable() *
    - * * * * * SearchAllIamPolicies - * Searches all IAM policies within the specified scope, such as a project, + *

    Searches all IAM policies within the specified scope, such as a project, * folder, or organization. The caller must be granted the * `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, - * otherwise the request will be rejected. + * otherwise the request will be rejected.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • searchAllIamPolicies(SearchAllIamPoliciesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • searchAllIamPolicies(String scope) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • searchAllIamPoliciesPagedCallable() *
    • searchAllIamPoliciesCallable() *
    - * * * * * AnalyzeMove - * Analyze moving a resource to a specified destination without kicking off + *

    Analyze moving a resource to a specified destination without kicking off * the actual move. The analysis is best effort depending on the user's * permissions of viewing different hierarchical policies and configurations. * The policies and configuration are subject to change before the actual - * resource migration takes place. + * resource migration takes place.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • analyzeMove(AnalyzeMoveRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • analyzeMoveCallable() *
    - * * * * diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index ebdc6e8f9d..d01885145f 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -78,161 +78,131 @@ * Method Variants * * MutateRows - * Mutates multiple rows in a batch. Each individual row is mutated + *

    Mutates multiple rows in a batch. Each individual row is mutated * atomically as in MutateRow, but the entire batch is not executed - * atomically. + * atomically.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • mutateRowsCallable() *
    - * * * * * PingAndWarm - * Warm up associated instance metadata for this connection. - * This call is not required but may be useful for connection keep-alive. + *

    Warm up associated instance metadata for this connection. + * This call is not required but may be useful for connection keep-alive.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • pingAndWarm(PingAndWarmRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • pingAndWarm(InstanceName name) *
    • pingAndWarm(String name) *
    • pingAndWarm(InstanceName name) *
    • pingAndWarm(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • pingAndWarmCallable() *
    - * * * * * ReadRows - * Streams back the contents of all requested rows in key order, optionally + *

    Streams back the contents of all requested rows in key order, optionally * applying the same Reader filter to each. Depending on their size, * rows and cells may be broken up across multiple responses, but * atomicity of each row will still be preserved. See the - * ReadRowsResponse documentation for details. + * ReadRowsResponse documentation for details.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • readRowsCallable() *
    - * * * * * ReadModifyWriteRow - * Modifies a row atomically on the server. The method reads the latest + *

    Modifies a row atomically on the server. The method reads the latest * existing timestamp and value from the specified columns and writes a new * entry based on pre-defined read/modify/write rules. The new value for the * timestamp is the greater of the existing timestamp or the current server - * time. The method returns the new contents of all modified cells. + * time. The method returns the new contents of all modified cells.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • readModifyWriteRow(ReadModifyWriteRowRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • readModifyWriteRow(TableName tableName) *
    • readModifyWriteRow(String tableName) *
    • readModifyWriteRow(TableName tableName) *
    • readModifyWriteRow(String tableName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • readModifyWriteRowCallable() *
    - * * * * * MutateRow - * Mutates a row atomically. Cells already present in the row are left - * unchanged unless explicitly changed by `mutation`. + *

    Mutates a row atomically. Cells already present in the row are left + * unchanged unless explicitly changed by `mutation`.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • mutateRow(MutateRowRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • mutateRow(TableName tableName) *
    • mutateRow(String tableName) *
    • mutateRow(TableName tableName) *
    • mutateRow(String tableName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • mutateRowCallable() *
    - * * * * * SampleRowKeys - * Returns a sample of row keys in the table. The returned row keys will + *

    Returns a sample of row keys in the table. The returned row keys will * delimit contiguous sections of the table of approximately equal size, * which can be used to break up the data for distributed tasks like - * mapreduces. + * mapreduces.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • sampleRowKeysCallable() *
    - * * * * * CheckAndMutateRow - * Mutates a row atomically based on the output of a predicate Reader filter. + *

    Mutates a row atomically based on the output of a predicate Reader filter.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • checkAndMutateRow(CheckAndMutateRowRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • checkAndMutateRow(TableName tableName) *
    • checkAndMutateRow(String tableName) *
    • checkAndMutateRow(TableName tableName) *
    • checkAndMutateRow(String tableName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • checkAndMutateRowCallable() *
    - * * * * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index 3fe69e5458..4aec80ab53 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -70,102 +70,78 @@ * Method Variants * * Delete - * Deletes the specified address resource. + *

    Deletes the specified address resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteAsync(DeleteAddressRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • deleteAsync(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteOperationCallable() *
    • deleteCallable() *
    - * * * * * List - * Retrieves a list of addresses contained within the specified region. + *

    Retrieves a list of addresses contained within the specified region.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • list(ListAddressesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • list(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listPagedCallable() *
    • listCallable() *
    - * * * * * Insert - * Creates an address resource in the specified project by using the data included in the request. + *

    Creates an address resource in the specified project by using the data included in the request.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • insertAsync(InsertAddressRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • insertAsync(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • insertOperationCallable() *
    • insertCallable() *
    - * * * * * AggregatedList - * Retrieves an aggregated list of addresses. + *

    Retrieves an aggregated list of addresses.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • aggregatedList(AggregatedListAddressesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • aggregatedList(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • aggregatedListPagedCallable() *
    • aggregatedListCallable() *
    - * * * * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java index 946b6f9829..ff43ff31a1 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java @@ -56,54 +56,42 @@ * Method Variants * * Get - * Retrieves the specified region-specific Operations resource. + *

    Retrieves the specified region-specific Operations resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • get(GetRegionOperationRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • get(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getCallable() *
    - * * * * * Wait - * Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. + *

    Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. * * This method is called on a best-effort basis. Specifically: * - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - * - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`. + * - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • wait(WaitRegionOperationRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • wait(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • waitCallable() *
    - * * * * diff --git a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java index e89c7ac900..2c573b309a 100644 --- a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java +++ b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java @@ -67,102 +67,78 @@ * Method Variants * * GenerateAccessToken - * Generates an OAuth 2.0 access token for a service account. + *

    Generates an OAuth 2.0 access token for a service account.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • generateAccessToken(GenerateAccessTokenRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • generateAccessToken(ServiceAccountName name) *
    • generateAccessToken(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • generateAccessTokenCallable() *
    - * * * * * GenerateIdToken - * Generates an OpenID Connect ID token for a service account. + *

    Generates an OpenID Connect ID token for a service account.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • generateIdToken(GenerateIdTokenRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • generateIdToken(ServiceAccountName name) *
    • generateIdToken(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • generateIdTokenCallable() *
    - * * * * * SignBlob - * Signs a blob using a service account's system-managed private key. + *

    Signs a blob using a service account's system-managed private key.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • signBlob(SignBlobRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • signBlob(ServiceAccountName name) *
    • signBlob(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • signBlobCallable() *
    - * * * * * SignJwt - * Signs a JWT using a service account's system-managed private key. + *

    Signs a JWT using a service account's system-managed private key.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • signJwt(SignJwtRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • signJwt(ServiceAccountName name) *
    • signJwt(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • signJwtCallable() *
    - * * * * diff --git a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java index eb5c50f533..89a94e6fa2 100644 --- a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java +++ b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java @@ -79,67 +79,55 @@ * Method Variants * * GetIamPolicy - * Gets the access control policy for a resource. + *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. + *

    Returns permissions that a caller has on the specified resource. * If the resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building permission-aware * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning. + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces any + *

    Sets the access control policy on the specified resource. Replaces any * existing policy. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index bc92d88e96..228cd0f025 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -87,442 +87,348 @@ * Method Variants * * UpdateCryptoKey - * Update a [CryptoKey][google.cloud.kms.v1.CryptoKey]. + *

    Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateCryptoKey(UpdateCryptoKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateCryptoKey(CryptoKey cryptoKey) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateCryptoKeyCallable() *
    - * * * * * Decrypt - * Decrypts data that was protected by + *

    Decrypts data that was protected by * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT]. + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • decrypt(DecryptRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • decrypt(CryptoKeyName name) *
    • decrypt(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • decryptCallable() *
    - * * * * * ListKeyRings - * Lists [KeyRings][google.cloud.kms.v1.KeyRing]. + *

    Lists [KeyRings][google.cloud.kms.v1.KeyRing].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listKeyRings(ListKeyRingsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listKeyRings(LocationName parent) *
    • listKeyRings(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listKeyRingsPagedCallable() *
    • listKeyRingsCallable() *
    - * * * * * AsymmetricDecrypt - * Decrypts data that was encrypted with a public key retrieved from + *

    Decrypts data that was encrypted with a public key retrieved from * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] * corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] - * ASYMMETRIC_DECRYPT. + * ASYMMETRIC_DECRYPT.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • asymmetricDecrypt(AsymmetricDecryptRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • asymmetricDecrypt(CryptoKeyVersionName name) *
    • asymmetricDecrypt(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • asymmetricDecryptCallable() *
    - * * * * * ListImportJobs - * Lists [ImportJobs][google.cloud.kms.v1.ImportJob]. + *

    Lists [ImportJobs][google.cloud.kms.v1.ImportJob].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listImportJobs(ListImportJobsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listImportJobs(KeyRingName parent) *
    • listImportJobs(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listImportJobsPagedCallable() *
    • listImportJobsCallable() *
    - * * * * * GetImportJob - * Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob]. + *

    Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getImportJob(GetImportJobRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getImportJob(ImportJobName name) *
    • getImportJob(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getImportJobCallable() *
    - * * * * * CreateImportJob - * Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a + *

    Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a * [KeyRing][google.cloud.kms.v1.KeyRing]. * * [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is - * required. + * required.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createImportJob(CreateImportJobRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createImportJob(KeyRingName parent) *
    • createImportJob(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createImportJobCallable() *
    - * * * * * ImportCryptoKeyVersion - * Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into + *

    Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into * an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the wrapped * key material provided in the request. * * The version ID will be assigned the next sequential id within the - * [CryptoKey][google.cloud.kms.v1.CryptoKey]. + * [CryptoKey][google.cloud.kms.v1.CryptoKey].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • importCryptoKeyVersionCallable() *
    - * * * * * GetPublicKey - * Returns the public key for the given + *

    Returns the public key for the given * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be * [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] * or - * [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT]. + * [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getPublicKey(GetPublicKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getPublicKey(CryptoKeyVersionName name) *
    • getPublicKey(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getPublicKeyCallable() *
    - * * * * * GetLocation - * Gets information about a location. + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLocation(GetLocationRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLocationCallable() *
    - * * * * * TestIamPermissions - * This is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto. + *

    This is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * CreateKeyRing - * Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and - * Location. + *

    Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and + * Location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createKeyRing(CreateKeyRingRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createKeyRing(LocationName parent) *
    • createKeyRing(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createKeyRingCallable() *
    - * * * * * GetKeyRing - * Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing]. + *

    Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getKeyRing(GetKeyRingRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getKeyRing(KeyRingName name) *
    • getKeyRing(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getKeyRingCallable() *
    - * * * * * ListLocations - * Lists information about the supported locations for this service. + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLocations(ListLocationsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLocationsPagedCallable() *
    • listLocationsCallable() *
    - * * * * * CreateCryptoKey - * Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a + *

    Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a * [KeyRing][google.cloud.kms.v1.KeyRing]. * * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] and * [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm] - * are required. + * are required.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createCryptoKey(CreateCryptoKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createCryptoKey(KeyRingName parent) *
    • createCryptoKey(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createCryptoKeyCallable() *
    - * * * * * CreateCryptoKeyVersion - * Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a + *

    Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a * [CryptoKey][google.cloud.kms.v1.CryptoKey]. * * The server will assign the next sequential id. If unset, * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to - * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED]. + * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createCryptoKeyVersion(CreateCryptoKeyVersionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createCryptoKeyVersion(CryptoKeyName parent) *
    • createCryptoKeyVersion(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createCryptoKeyVersionCallable() *
    - * * * * * UpdateCryptoKeyPrimaryVersion - * Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that + *

    Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that * will be used in * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. * - * Returns an error if called on an asymmetric key. + * Returns an error if called on an asymmetric key.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateCryptoKeyPrimaryVersion(CryptoKeyName name) *
    • updateCryptoKeyPrimaryVersion(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateCryptoKeyPrimaryVersionCallable() *
    - * * * * * DestroyCryptoKeyVersion - * Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for + *

    Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for * destruction. * * Upon calling this method, @@ -539,78 +445,62 @@ * [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is * reached, * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] - * may be called to reverse the process. + * may be called to reverse the process.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • destroyCryptoKeyVersion(CryptoKeyVersionName name) *
    • destroyCryptoKeyVersion(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • destroyCryptoKeyVersionCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. ADDED ONLY FOR MIXIN TESTS. + *

    Gets the access control policy for a resource. ADDED ONLY FOR MIXIN TESTS. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * GetCryptoKeyVersion - * Returns metadata for a given - * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. + *

    Returns metadata for a given + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getCryptoKeyVersion(CryptoKeyVersionName name) *
    • getCryptoKeyVersion(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getCryptoKeyVersionCallable() *
    - * * * * * UpdateCryptoKeyVersion - * Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s + *

    Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s * metadata. * * [state][google.cloud.kms.v1.CryptoKeyVersion.state] may be changed between @@ -621,141 +511,111 @@ * [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] * and * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] - * to move between other states. + * to move between other states.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateCryptoKeyVersion(UpdateCryptoKeyVersionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateCryptoKeyVersionCallable() *
    - * * * * * ListCryptoKeyVersions - * Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion]. + *

    Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listCryptoKeyVersions(CryptoKeyName parent) *
    • listCryptoKeyVersions(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listCryptoKeyVersionsPagedCallable() *
    • listCryptoKeyVersionsCallable() *
    - * * * * * AsymmetricSign - * Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] + *

    Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] * ASYMMETRIC_SIGN, producing a signature that can be verified with the public * key retrieved from - * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey]. + * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • asymmetricSign(AsymmetricSignRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • asymmetricSign(CryptoKeyVersionName name) *
    • asymmetricSign(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • asymmetricSignCallable() *
    - * * * * * Encrypt - * Encrypts data, so that it can only be recovered by a call to + *

    Encrypts data, so that it can only be recovered by a call to * [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. The * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT]. + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • encrypt(EncryptRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • encrypt(ResourceName name) *
    • encrypt(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • encryptCallable() *
    - * * * * * GetCryptoKey - * Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as + *

    Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as * well as its [primary][google.cloud.kms.v1.CryptoKey.primary] - * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getCryptoKey(GetCryptoKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getCryptoKey(CryptoKeyName name) *
    • getCryptoKey(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getCryptoKeyCallable() *
    - * * * * * RestoreCryptoKeyVersion - * Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the + *

    Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] * state. * @@ -763,53 +623,41 @@ * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to * [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED], * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will - * be cleared. + * be cleared.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • restoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • restoreCryptoKeyVersion(CryptoKeyVersionName name) *
    • restoreCryptoKeyVersion(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • restoreCryptoKeyVersionCallable() *
    - * * * * * ListCryptoKeys - * Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey]. + *

    Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listCryptoKeys(ListCryptoKeysRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listCryptoKeys(KeyRingName parent) *
    • listCryptoKeys(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listCryptoKeysPagedCallable() *
    • listCryptoKeysCallable() *
    - * * * * diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index bee7d14049..c30e8e20c2 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -87,285 +87,221 @@ * Method Variants * * ListShelves - * Lists shelves. The order is unspecified but deterministic. Newly created - * shelves will not necessarily be added to the end of this list. + *

    Lists shelves. The order is unspecified but deterministic. Newly created + * shelves will not necessarily be added to the end of this list.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listShelves(ListShelvesRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listShelvesPagedCallable() *
    • listShelvesCallable() *
    - * * * * * CreateShelf - * Creates a shelf, and returns the new Shelf. + *

    Creates a shelf, and returns the new Shelf.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createShelf(CreateShelfRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createShelf(Shelf shelf) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createShelfCallable() *
    - * * * * * DeleteShelf - * Deletes a shelf. Returns NOT_FOUND if the shelf does not exist. + *

    Deletes a shelf. Returns NOT_FOUND if the shelf does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteShelf(DeleteShelfRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteShelf(ShelfName name) *
    • deleteShelf(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteShelfCallable() *
    - * * * * * MoveBook - * Moves a book to another shelf, and returns the new book. The book - * id of the new book may not be the same as the original book. + *

    Moves a book to another shelf, and returns the new book. The book + * id of the new book may not be the same as the original book.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • moveBook(MoveBookRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • moveBook(BookName name) *
    • moveBook(BookName name) *
    • moveBook(String name) *
    • moveBook(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • moveBookCallable() *
    - * * * * * CreateBook - * Creates a book, and returns the new Book. + *

    Creates a book, and returns the new Book.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createBook(CreateBookRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createBook(ShelfName parent) *
    • createBook(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createBookCallable() *
    - * * * * * DeleteBook - * Deletes a book. Returns NOT_FOUND if the book does not exist. + *

    Deletes a book. Returns NOT_FOUND if the book does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteBook(DeleteBookRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteBook(BookName name) *
    • deleteBook(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteBookCallable() *
    - * * * * * UpdateBook - * Updates a book. Returns INVALID_ARGUMENT if the name of the book - * is non-empty and does not equal the existing name. + *

    Updates a book. Returns INVALID_ARGUMENT if the name of the book + * is non-empty and does not equal the existing name.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateBook(UpdateBookRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateBook(Book book) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateBookCallable() *
    - * * * * * GetShelf - * Gets a shelf. Returns NOT_FOUND if the shelf does not exist. + *

    Gets a shelf. Returns NOT_FOUND if the shelf does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getShelf(GetShelfRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getShelf(ShelfName name) *
    • getShelf(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getShelfCallable() *
    - * * * * * GetBook - * Gets a book. Returns NOT_FOUND if the book does not exist. + *

    Gets a book. Returns NOT_FOUND if the book does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getBook(GetBookRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getBook(BookName name) *
    • getBook(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getBookCallable() *
    - * * * * * MergeShelves - * Merges two shelves by adding all books from the shelf named + *

    Merges two shelves by adding all books from the shelf named * `other_shelf_name` to shelf `name`, and deletes * `other_shelf_name`. Returns the updated shelf. * The book ids of the moved books may not be the same as the original books. * * Returns NOT_FOUND if either shelf does not exist. - * This call is a no-op if the specified shelves are the same. + * This call is a no-op if the specified shelves are the same.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • mergeShelves(MergeShelvesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • mergeShelves(ShelfName name) *
    • mergeShelves(ShelfName name) *
    • mergeShelves(String name) *
    • mergeShelves(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • mergeShelvesCallable() *
    - * * * * * ListBooks - * Lists books in a shelf. The order is unspecified but deterministic. Newly + *

    Lists books in a shelf. The order is unspecified but deterministic. Newly * created books will not necessarily be added to the end of this list. - * Returns NOT_FOUND if the shelf does not exist. + * Returns NOT_FOUND if the shelf does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listBooks(ListBooksRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listBooks(ShelfName parent) *
    • listBooks(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listBooksPagedCallable() *
    • listBooksCallable() *
    - * * * * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index a51b96dfdb..1133d11ac3 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -121,55 +121,45 @@ * Method Variants * * DeleteSink - * Deletes a sink. If the sink has a unique `writer_identity`, then that - * service account is also deleted. + *

    Deletes a sink. If the sink has a unique `writer_identity`, then that + * service account is also deleted.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteSink(DeleteSinkRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteSink(LogSinkName sinkName) *
    • deleteSink(String sinkName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteSinkCallable() *
    - * * * * * UpdateView - * Updates a view on a log bucket. This method replaces the following fields + *

    Updates a view on a log bucket. This method replaces the following fields * in the existing view with values from the new view: `filter`. * If an `UNAVAILABLE` error is returned, this indicates that system is not in * a state where it can update the view. If this occurs, please try again in a - * few minutes. + * few minutes.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateView(UpdateViewRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateViewCallable() *
    - * * * * * UpdateCmekSettings - * Updates the Log Router CMEK settings for the given resource. + *

    Updates the Log Router CMEK settings for the given resource. * * Note: CMEK for the Log Router can currently only be configured for Google * Cloud organizations. Once configured, it applies to all projects and @@ -183,71 +173,56 @@ * * See [Enabling CMEK for Log * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information. + * for more information.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateCmekSettings(UpdateCmekSettingsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateCmekSettingsCallable() *
    - * * * * * GetView - * Gets a view on a log bucket.. + *

    Gets a view on a log bucket..

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getView(GetViewRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getViewCallable() *
    - * * * * * UndeleteBucket - * Undeletes a log bucket. A bucket that has been deleted can be undeleted - * within the grace period of 7 days. + *

    Undeletes a log bucket. A bucket that has been deleted can be undeleted + * within the grace period of 7 days.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • undeleteBucket(UndeleteBucketRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • undeleteBucketCallable() *
    - * * * * * ListExclusions - * Lists all the exclusions on the _Default sink in a parent resource. + *

    Lists all the exclusions on the _Default sink in a parent resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listExclusions(ListExclusionsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listExclusions(BillingAccountName parent) *
    • listExclusions(FolderName parent) @@ -255,19 +230,16 @@ *
    • listExclusions(ProjectName parent) *
    • listExclusions(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listExclusionsPagedCallable() *
    • listExclusionsCallable() *
    - * * * * * UpdateSettings - * Updates the Log Router settings for the given resource. + *

    Updates the Log Router settings for the given resource. * * Note: Settings for the Log Router can currently only be configured for * Google Cloud organizations. Once configured, it applies to all projects and @@ -282,133 +254,104 @@ * * See [Enabling CMEK for Log * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information. + * for more information.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateSettings(UpdateSettingsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateSettings(Settings settings) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateSettingsCallable() *
    - * * * * * CreateView - * Creates a view over log entries in a log bucket. A bucket may contain a - * maximum of 30 views. + *

    Creates a view over log entries in a log bucket. A bucket may contain a + * maximum of 30 views.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createView(CreateViewRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createViewCallable() *
    - * * * * * DeleteView - * Deletes a view on a log bucket. + *

    Deletes a view on a log bucket. * If an `UNAVAILABLE` error is returned, this indicates that system is not in * a state where it can delete the view. If this occurs, please try again in a - * few minutes. + * few minutes.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteView(DeleteViewRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteViewCallable() *
    - * * * * * UpdateExclusion - * Changes one or more properties of an existing exclusion in the _Default - * sink. + *

    Changes one or more properties of an existing exclusion in the _Default + * sink.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateExclusion(UpdateExclusionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateExclusion(LogExclusionName name) *
    • updateExclusion(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateExclusionCallable() *
    - * * * * * GetSink - * Gets a sink. + *

    Gets a sink.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSink(GetSinkRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getSink(LogSinkName sinkName) *
    • getSink(String sinkName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSinkCallable() *
    - * * * * * CreateExclusion - * Creates a new exclusion in the _Default sink in a specified parent + *

    Creates a new exclusion in the _Default sink in a specified parent * resource. Only log entries belonging to that resource can be excluded. You - * can have up to 10 exclusions in a resource. + * can have up to 10 exclusions in a resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createExclusion(CreateExclusionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createExclusion(BillingAccountName parent) *
    • createExclusion(FolderName parent) @@ -416,49 +359,39 @@ *
    • createExclusion(ProjectName parent) *
    • createExclusion(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createExclusionCallable() *
    - * * * * * DeleteBucket - * Deletes a log bucket. + *

    Deletes a log bucket. * * Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state. * After 7 days, the bucket will be purged and all log entries in the bucket - * will be permanently deleted. + * will be permanently deleted.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteBucket(DeleteBucketRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteBucketCallable() *
    - * * * * * ListBuckets - * Lists log buckets. + *

    Lists log buckets.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listBuckets(ListBucketsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listBuckets(BillingAccountLocationName parent) *
    • listBuckets(FolderLocationName parent) @@ -466,19 +399,16 @@ *
    • listBuckets(OrganizationLocationName parent) *
    • listBuckets(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listBucketsPagedCallable() *
    • listBucketsCallable() *
    - * * * * * GetCmekSettings - * Gets the Logging CMEK settings for the given resource. + *

    Gets the Logging CMEK settings for the given resource. * * Note: CMEK for the Log Router can be configured for Google Cloud projects, * folders, organizations and billing accounts. Once configured for an @@ -487,37 +417,30 @@ * * See [Enabling CMEK for Log * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information. + * for more information.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getCmekSettings(GetCmekSettingsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getCmekSettingsCallable() *
    - * * * * * CreateSink - * Creates a sink that exports specified log entries to a destination. The + *

    Creates a sink that exports specified log entries to a destination. The * export of newly-ingested log entries begins immediately, unless the sink's * `writer_identity` is not permitted to write to the destination. A sink can - * export log entries only from the resource owning the sink. + * export log entries only from the resource owning the sink.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createSink(CreateSinkRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createSink(BillingAccountName parent) *
    • createSink(FolderName parent) @@ -525,70 +448,54 @@ *
    • createSink(ProjectName parent) *
    • createSink(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createSinkCallable() *
    - * * * * * GetBucket - * Gets a log bucket. + *

    Gets a log bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getBucket(GetBucketRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getBucketCallable() *
    - * * * * * ListViews - * Lists views on a log bucket. + *

    Lists views on a log bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listViews(ListViewsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listViews(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listViewsPagedCallable() *
    • listViewsCallable() *
    - * * * * * ListSinks - * Lists sinks. + *

    Lists sinks.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listSinks(ListSinksRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listSinks(BillingAccountName parent) *
    • listSinks(FolderName parent) @@ -596,50 +503,41 @@ *
    • listSinks(ProjectName parent) *
    • listSinks(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listSinksPagedCallable() *
    • listSinksCallable() *
    - * * * * * UpdateSink - * Updates a sink. This method replaces the following fields in the existing + *

    Updates a sink. This method replaces the following fields in the existing * sink with values from the new sink: `destination`, and `filter`. * * The updated sink might also have a new `writer_identity`; see the - * `unique_writer_identity` field. + * `unique_writer_identity` field.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateSink(UpdateSinkRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateSink(LogSinkName sinkName) *
    • updateSink(String sinkName) *
    • updateSink(LogSinkName sinkName) *
    • updateSink(String sinkName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateSinkCallable() *
    - * * * * * UpdateBucket - * Updates a log bucket. This method replaces the following fields in the + *

    Updates a log bucket. This method replaces the following fields in the * existing bucket with values from the new bucket: `retention_period` * * If the retention period is decreased and the bucket is locked, @@ -648,113 +546,89 @@ * If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then * `FAILED_PRECONDITION` will be returned. * - * After a bucket has been created, the bucket's location cannot be changed. + * After a bucket has been created, the bucket's location cannot be changed.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateBucket(UpdateBucketRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateBucketCallable() *
    - * * * * * GetExclusion - * Gets the description of an exclusion in the _Default sink. + *

    Gets the description of an exclusion in the _Default sink.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getExclusion(GetExclusionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getExclusion(LogExclusionName name) *
    • getExclusion(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getExclusionCallable() *
    - * * * * * DeleteExclusion - * Deletes an exclusion in the _Default sink. + *

    Deletes an exclusion in the _Default sink.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteExclusion(DeleteExclusionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteExclusion(LogExclusionName name) *
    • deleteExclusion(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteExclusionCallable() *
    - * * * * * CopyLogEntries - * Copies a set of log entries from a log bucket to a Cloud Storage bucket. + *

    Copies a set of log entries from a log bucket to a Cloud Storage bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • copyLogEntriesAsync(CopyLogEntriesRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • copyLogEntriesOperationCallable() *
    • copyLogEntriesCallable() *
    - * * * * * CreateBucket - * Creates a log bucket that can be used to store log entries. After a bucket - * has been created, the bucket's location cannot be changed. + *

    Creates a log bucket that can be used to store log entries. After a bucket + * has been created, the bucket's location cannot be changed.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createBucket(CreateBucketRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createBucketCallable() *
    - * * * * * GetSettings - * Gets the Log Router settings for the given resource. + *

    Gets the Log Router settings for the given resource. * * Note: Settings for the Log Router can be get for Google Cloud projects, * folders, organizations and billing accounts. Currently it can only be @@ -763,27 +637,21 @@ * * See [Enabling CMEK for Log * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information. + * for more information.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSettings(GetSettingsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getSettings(SettingsName name) *
    • getSettings(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSettingsCallable() *
    - * * * * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index e95e8200ce..3d8c229fe5 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -83,67 +83,54 @@ * Method Variants * * WriteLogEntries - * Writes log entries to Logging. This API method is the + *

    Writes log entries to Logging. This API method is the * only way to send log entries to Logging. This method * is used, directly or indirectly, by the Logging agent * (fluentd) and all logging libraries configured to use Logging. * A single request may contain log entries for a maximum of 1000 * different resources (projects, organizations, billing accounts or - * folders) + * folders)

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • writeLogEntries(WriteLogEntriesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • writeLogEntries(LogName logName) *
    • writeLogEntries(String logName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • writeLogEntriesCallable() *
    - * * * * * ListMonitoredResourceDescriptors - * Lists the descriptors for monitored resource types used by Logging. + *

    Lists the descriptors for monitored resource types used by Logging.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listMonitoredResourceDescriptorsPagedCallable() *
    • listMonitoredResourceDescriptorsCallable() *
    - * * * * * ListLogs - * Lists the logs in projects, organizations, folders, or billing accounts. - * Only logs that have entries are listed. + *

    Lists the logs in projects, organizations, folders, or billing accounts. + * Only logs that have entries are listed.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLogs(ListLogsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listLogs(BillingAccountName parent) *
    • listLogs(FolderName parent) @@ -151,83 +138,66 @@ *
    • listLogs(ProjectName parent) *
    • listLogs(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLogsPagedCallable() *
    • listLogsCallable() *
    - * * * * * DeleteLog - * Deletes all the log entries in a log for the _Default Log Bucket. The log + *

    Deletes all the log entries in a log for the _Default Log Bucket. The log * reappears if it receives new entries. Log entries written shortly before * the delete operation might not be deleted. Entries received after the - * delete operation with a timestamp before the operation will be deleted. + * delete operation with a timestamp before the operation will be deleted.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteLog(DeleteLogRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteLog(LogName logName) *
    • deleteLog(String logName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteLogCallable() *
    - * * * * * ListLogEntries - * Lists log entries. Use this method to retrieve log entries that originated + *

    Lists log entries. Use this method to retrieve log entries that originated * from a project/folder/organization/billing account. For ways to export log * entries, see [Exporting - * Logs](https://cloud.google.com/logging/docs/export). + * Logs](https://cloud.google.com/logging/docs/export).

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLogEntries(ListLogEntriesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listLogEntries(List resourceNames) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLogEntriesPagedCallable() *
    • listLogEntriesCallable() *
    - * * * * * TailLogEntries - * Streaming read of log entries as they are ingested. Until the stream is - * terminated, it will continue reading logs. + *

    Streaming read of log entries as they are ingested. Until the stream is + * terminated, it will continue reading logs.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • tailLogEntriesCallable() *
    - * * * * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index 97f52e98e3..a8eb81defe 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -71,128 +71,98 @@ * Method Variants * * UpdateLogMetric - * Creates or updates a logs-based metric. + *

    Creates or updates a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateLogMetric(UpdateLogMetricRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateLogMetric(LogMetricName metricName) *
    • updateLogMetric(String metricName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateLogMetricCallable() *
    - * * * * * CreateLogMetric - * Creates a logs-based metric. + *

    Creates a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createLogMetric(CreateLogMetricRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createLogMetric(ProjectName parent) *
    • createLogMetric(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createLogMetricCallable() *
    - * * * * * GetLogMetric - * Gets a logs-based metric. + *

    Gets a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLogMetric(GetLogMetricRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getLogMetric(LogMetricName metricName) *
    • getLogMetric(String metricName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLogMetricCallable() *
    - * * * * * DeleteLogMetric - * Deletes a logs-based metric. + *

    Deletes a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteLogMetric(DeleteLogMetricRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteLogMetric(LogMetricName metricName) *
    • deleteLogMetric(String metricName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteLogMetricCallable() *
    - * * * * * ListLogMetrics - * Lists logs-based metrics. + *

    Lists logs-based metrics.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLogMetrics(ListLogMetricsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listLogMetrics(ProjectName parent) *
    • listLogMetrics(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLogMetricsPagedCallable() *
    • listLogMetricsCallable() *
    - * * * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index 74db29642b..471490b25a 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -86,312 +86,242 @@ * Method Variants * * DeleteSchema - * Deletes a schema. + *

    Deletes a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteSchema(DeleteSchemaRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteSchema(SchemaName name) *
    • deleteSchema(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteSchemaCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set. + *

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * ListSchemaRevisions - * Lists all schema revisions for the named schema. + *

    Lists all schema revisions for the named schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listSchemaRevisions(ListSchemaRevisionsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listSchemaRevisions(SchemaName name) *
    • listSchemaRevisions(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listSchemaRevisionsPagedCallable() *
    • listSchemaRevisionsCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces + *

    Sets the access control policy on the specified resource. Replaces * any existing policy. * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors. + * errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * RollbackSchema - * Creates a new schema revision that is a copy of the provided revision_id. + *

    Creates a new schema revision that is a copy of the provided revision_id.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • rollbackSchema(RollbackSchemaRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • rollbackSchema(SchemaName name) *
    • rollbackSchema(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • rollbackSchemaCallable() *
    - * * * * * DeleteSchemaRevision - * Deletes a specific schema revision. + *

    Deletes a specific schema revision.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteSchemaRevision(DeleteSchemaRevisionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteSchemaRevision(SchemaName name) *
    • deleteSchemaRevision(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteSchemaRevisionCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. If the + *

    Returns permissions that a caller has on the specified resource. If the * resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning. + * checking. This operation may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * ValidateMessage - * Validates a message against a schema. + *

    Validates a message against a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • validateMessage(ValidateMessageRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • validateMessageCallable() *
    - * * * * * CreateSchema - * Creates a schema. + *

    Creates a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createSchema(CreateSchemaRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createSchema(ProjectName parent) *
    • createSchema(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createSchemaCallable() *
    - * * * * * ListSchemas - * Lists schemas in a project. + *

    Lists schemas in a project.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listSchemas(ListSchemasRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listSchemas(ProjectName parent) *
    • listSchemas(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listSchemasPagedCallable() *
    • listSchemasCallable() *
    - * * * * * CommitSchema - * Commits a new schema revision to an existing schema. + *

    Commits a new schema revision to an existing schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • commitSchema(CommitSchemaRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • commitSchema(SchemaName name) *
    • commitSchema(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • commitSchemaCallable() *
    - * * * * * GetSchema - * Gets a schema. + *

    Gets a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSchema(GetSchemaRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getSchema(SchemaName name) *
    • getSchema(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSchemaCallable() *
    - * * * * * ValidateSchema - * Validates a schema. + *

    Validates a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • validateSchema(ValidateSchemaRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • validateSchema(ProjectName parent) *
    • validateSchema(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • validateSchemaCallable() *
    - * * * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index e661df812c..84431a78b4 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -102,247 +102,199 @@ * Method Variants * * Pull - * Pulls messages from the server. The server may return `UNAVAILABLE` if + *

    Pulls messages from the server. The server may return `UNAVAILABLE` if * there are too many concurrent pull requests pending for the given - * subscription. + * subscription.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • pull(PullRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • pull(SubscriptionName subscription) *
    • pull(String subscription) *
    • pull(SubscriptionName subscription) *
    • pull(String subscription) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • pullCallable() *
    - * * * * * GetSnapshot - * Gets the configuration details of a snapshot. Snapshots are used in + *

    Gets the configuration details of a snapshot. Snapshots are used in * Seek * operations, which allow you to manage message acknowledgments in bulk. That * is, you can set the acknowledgment state of messages in an existing - * subscription to the state captured by a snapshot. + * subscription to the state captured by a snapshot.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSnapshot(GetSnapshotRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getSnapshot(SnapshotName snapshot) *
    • getSnapshot(String snapshot) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSnapshotCallable() *
    - * * * * * Acknowledge - * Acknowledges the messages associated with the `ack_ids` in the + *

    Acknowledges the messages associated with the `ack_ids` in the * `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages * from the subscription. * * Acknowledging a message whose ack deadline has expired may succeed, * but such a message may be redelivered later. Acknowledging a message more - * than once will not result in an error. + * than once will not result in an error.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • acknowledge(AcknowledgeRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • acknowledge(SubscriptionName subscription) *
    • acknowledge(String subscription) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • acknowledgeCallable() *
    - * * * * * ModifyAckDeadline - * Modifies the ack deadline for a specific message. This method is useful + *

    Modifies the ack deadline for a specific message. This method is useful * to indicate that more time is needed to process a message by the * subscriber, or to make the message available for redelivery if the * processing was interrupted. Note that this does not modify the - * subscription-level `ackDeadlineSeconds` used for subsequent messages. + * subscription-level `ackDeadlineSeconds` used for subsequent messages.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • modifyAckDeadline(ModifyAckDeadlineRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • modifyAckDeadline(SubscriptionName subscription) *
    • modifyAckDeadline(String subscription) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • modifyAckDeadlineCallable() *
    - * * * * * ModifyPushConfig - * Modifies the `PushConfig` for a specified subscription. + *

    Modifies the `PushConfig` for a specified subscription. * * This may be used to change a push subscription to a pull one (signified by * an empty `PushConfig`) or vice versa, or change the endpoint URL and other * attributes of a push subscription. Messages will accumulate for delivery - * continuously through the call regardless of changes to the `PushConfig`. + * continuously through the call regardless of changes to the `PushConfig`.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • modifyPushConfig(ModifyPushConfigRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • modifyPushConfig(SubscriptionName subscription) *
    • modifyPushConfig(String subscription) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • modifyPushConfigCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set. + *

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * GetSubscription - * Gets the configuration details of a subscription. + *

    Gets the configuration details of a subscription.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSubscription(GetSubscriptionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getSubscription(SubscriptionName subscription) *
    • getSubscription(String subscription) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSubscriptionCallable() *
    - * * * * * StreamingPull - * Establishes a stream with the server, which sends messages down to the + *

    Establishes a stream with the server, which sends messages down to the * client. The client streams acknowledgements and ack deadline modifications * back to the server. The server will close the stream and return the status * on any error. The server may close the stream with status `UNAVAILABLE` to * reassign server-side resources, in which case, the client should * re-establish the stream. Flow control can be achieved by configuring the - * underlying RPC channel. + * underlying RPC channel.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • streamingPullCallable() *
    - * * * * * ListSnapshots - * Lists the existing snapshots. Snapshots are used in [Seek]( + *

    Lists the existing snapshots. Snapshots are used in [Seek]( * https://cloud.google.com/pubsub/docs/replay-overview) operations, which * allow you to manage message acknowledgments in bulk. That is, you can set * the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. + * state captured by a snapshot.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listSnapshots(ListSnapshotsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listSnapshots(ProjectName project) *
    • listSnapshots(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listSnapshotsPagedCallable() *
    • listSnapshotsCallable() *
    - * * * * * CreateSubscription - * Creates a subscription to a given topic. See the [resource name rules] + *

    Creates a subscription to a given topic. See the [resource name rules] * (https://cloud.google.com/pubsub/docs/admin#resource_names). * If the subscription already exists, returns `ALREADY_EXISTS`. * If the corresponding topic doesn't exist, returns `NOT_FOUND`. @@ -352,34 +304,28 @@ * to the [resource name format] * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated * name is populated in the returned Subscription object. Note that for REST - * API requests, you must specify a name in the request. + * API requests, you must specify a name in the request.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createSubscription(Subscription request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createSubscription(SubscriptionName name) *
    • createSubscription(SubscriptionName name) *
    • createSubscription(String name) *
    • createSubscription(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createSubscriptionCallable() *
    - * * * * * DeleteSnapshot - * Removes an existing snapshot. Snapshots are used in [Seek] + *

    Removes an existing snapshot. Snapshots are used in [Seek] * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which * allow you to manage message acknowledgments in bulk. That is, you can set * the acknowledgment state of messages in an existing subscription to the @@ -387,175 +333,141 @@ * When the snapshot is deleted, all messages retained in the snapshot * are immediately dropped. After a snapshot is deleted, a new one may be * created with the same name, but the new one has no association with the old - * snapshot or its subscription, unless the same subscription is specified. + * snapshot or its subscription, unless the same subscription is specified.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteSnapshot(DeleteSnapshotRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteSnapshot(SnapshotName snapshot) *
    • deleteSnapshot(String snapshot) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteSnapshotCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces + *

    Sets the access control policy on the specified resource. Replaces * any existing policy. * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors. + * errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * UpdateSnapshot - * Updates an existing snapshot. Snapshots are used in + *

    Updates an existing snapshot. Snapshots are used in * Seek * operations, which allow * you to manage message acknowledgments in bulk. That is, you can set the * acknowledgment state of messages in an existing subscription to the state - * captured by a snapshot. + * captured by a snapshot.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateSnapshot(UpdateSnapshotRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateSnapshotCallable() *
    - * * * * * UpdateSubscription - * Updates an existing subscription. Note that certain properties of a - * subscription, such as its topic, are not modifiable. + *

    Updates an existing subscription. Note that certain properties of a + * subscription, such as its topic, are not modifiable.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateSubscription(UpdateSubscriptionRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateSubscriptionCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. If the + *

    Returns permissions that a caller has on the specified resource. If the * resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning. + * checking. This operation may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * DeleteSubscription - * Deletes an existing subscription. All messages retained in the subscription + *

    Deletes an existing subscription. All messages retained in the subscription * are immediately dropped. Calls to `Pull` after deletion will return * `NOT_FOUND`. After a subscription is deleted, a new one may be created with * the same name, but the new one has no association with the old - * subscription or its topic unless the same topic is specified. + * subscription or its topic unless the same topic is specified.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteSubscription(DeleteSubscriptionRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteSubscription(SubscriptionName subscription) *
    • deleteSubscription(String subscription) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteSubscriptionCallable() *
    - * * * * * ListSubscriptions - * Lists matching subscriptions. + *

    Lists matching subscriptions.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listSubscriptions(ListSubscriptionsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listSubscriptions(ProjectName project) *
    • listSubscriptions(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listSubscriptionsPagedCallable() *
    • listSubscriptionsCallable() *
    - * * * * * CreateSnapshot - * Creates a snapshot from the requested subscription. Snapshots are used in + *

    Creates a snapshot from the requested subscription. Snapshots are used in * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, * which allow you to manage message acknowledgments in bulk. That is, you can * set the acknowledgment state of messages in an existing subscription to the @@ -570,53 +482,43 @@ * to the [resource name format] * (https://cloud.google.com/pubsub/docs/admin#resource_names). The * generated name is populated in the returned Snapshot object. Note that for - * REST API requests, you must specify a name in the request. + * REST API requests, you must specify a name in the request.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createSnapshot(CreateSnapshotRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createSnapshot(SnapshotName name) *
    • createSnapshot(SnapshotName name) *
    • createSnapshot(String name) *
    • createSnapshot(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createSnapshotCallable() *
    - * * * * * Seek - * Seeks an existing subscription to a point in time or to a given snapshot, + *

    Seeks an existing subscription to a point in time or to a given snapshot, * whichever is provided in the request. Snapshots are used in [Seek] * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which * allow you to manage message acknowledgments in bulk. That is, you can set * the acknowledgment state of messages in an existing subscription to the * state captured by a snapshot. Note that both the subscription and the - * snapshot must be on the same topic. + * snapshot must be on the same topic.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • seek(SeekRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • seekCallable() *
    - * * * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index 4ba719782e..ba7ab18b97 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -85,295 +85,233 @@ * Method Variants * * ListTopicSubscriptions - * Lists the names of the attached subscriptions on this topic. + *

    Lists the names of the attached subscriptions on this topic.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listTopicSubscriptions(ListTopicSubscriptionsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listTopicSubscriptions(TopicName topic) *
    • listTopicSubscriptions(String topic) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listTopicSubscriptionsPagedCallable() *
    • listTopicSubscriptionsCallable() *
    - * * * * * DetachSubscription - * Detaches a subscription from this topic. All messages retained in the + *

    Detaches a subscription from this topic. All messages retained in the * subscription are dropped. Subsequent `Pull` and `StreamingPull` requests * will return FAILED_PRECONDITION. If the subscription is a push - * subscription, pushes to the endpoint will stop. + * subscription, pushes to the endpoint will stop.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • detachSubscription(DetachSubscriptionRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • detachSubscriptionCallable() *
    - * * * * * CreateTopic - * Creates the given topic with the given name. See the [resource name rules] - * (https://cloud.google.com/pubsub/docs/admin#resource_names). + *

    Creates the given topic with the given name. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names).

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createTopic(Topic request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createTopic(TopicName name) *
    • createTopic(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createTopicCallable() *
    - * * * * * ListTopics - * Lists matching topics. + *

    Lists matching topics.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listTopics(ListTopicsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listTopics(ProjectName project) *
    • listTopics(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listTopicsPagedCallable() *
    • listTopicsCallable() *
    - * * * * * GetTopic - * Gets the configuration of a topic. + *

    Gets the configuration of a topic.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getTopic(GetTopicRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getTopic(TopicName topic) *
    • getTopic(String topic) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getTopicCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set. + *

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * UpdateTopic - * Updates an existing topic. Note that certain properties of a - * topic are not modifiable. + *

    Updates an existing topic. Note that certain properties of a + * topic are not modifiable.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateTopic(UpdateTopicRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateTopicCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. If the + *

    Returns permissions that a caller has on the specified resource. If the * resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning. + * checking. This operation may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * DeleteTopic - * Deletes the topic with the given name. Returns `NOT_FOUND` if the topic + *

    Deletes the topic with the given name. Returns `NOT_FOUND` if the topic * does not exist. After a topic is deleted, a new topic may be created with * the same name; this is an entirely new topic with none of the old * configuration or subscriptions. Existing subscriptions to this topic are - * not deleted, but their `topic` field is set to `_deleted-topic_`. + * not deleted, but their `topic` field is set to `_deleted-topic_`.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteTopic(DeleteTopicRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteTopic(TopicName topic) *
    • deleteTopic(String topic) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteTopicCallable() *
    - * * * * * ListTopicSnapshots - * Lists the names of the snapshots on this topic. Snapshots are used in + *

    Lists the names of the snapshots on this topic. Snapshots are used in * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, * which allow you to manage message acknowledgments in bulk. That is, you can * set the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. + * state captured by a snapshot.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listTopicSnapshots(ListTopicSnapshotsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listTopicSnapshots(TopicName topic) *
    • listTopicSnapshots(String topic) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listTopicSnapshotsPagedCallable() *
    • listTopicSnapshotsCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces + *

    Sets the access control policy on the specified resource. Replaces * any existing policy. * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors. + * errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * Publish - * Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic - * does not exist. + *

    Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic + * does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • publish(PublishRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • publish(TopicName topic) *
    • publish(String topic) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • publishCallable() *
    - * * * * diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index 30fa378208..2b5c7631a1 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -89,62 +89,50 @@ * Method Variants * * GetInstance - * Gets the details of a specific Redis instance. + *

    Gets the details of a specific Redis instance.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getInstance(GetInstanceRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getInstance(InstanceName name) *
    • getInstance(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getInstanceCallable() *
    - * * * * * ExportInstance - * Export Redis instance data into a Redis RDB format file in Cloud Storage. + *

    Export Redis instance data into a Redis RDB format file in Cloud Storage. * * Redis will continue serving during this operation. * * The returned operation is automatically deleted after a few hours, so - * there is no need to call DeleteOperation. + * there is no need to call DeleteOperation.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • exportInstanceAsync(ExportInstanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • exportInstanceAsync(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • exportInstanceOperationCallable() *
    • exportInstanceCallable() *
    - * * * * * ListInstances - * Lists all Redis instances owned by a project in either the specified + *

    Lists all Redis instances owned by a project in either the specified * location (region) or all locations. * * The location should have the following format: @@ -152,116 +140,92 @@ * * `projects/{project_id}/locations/{location_id}` * * If `location_id` is specified as `-` (wildcard), then all regions - * available to the project are queried, and the results are aggregated. + * available to the project are queried, and the results are aggregated.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listInstances(ListInstancesRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listInstances(LocationName parent) *
    • listInstances(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listInstancesPagedCallable() *
    • listInstancesCallable() *
    - * * * * * UpdateInstance - * Updates the metadata and configuration of a specific Redis instance. + *

    Updates the metadata and configuration of a specific Redis instance. * * Completed longrunning.Operation will contain the new instance object * in the response field. The returned operation is automatically deleted - * after a few hours, so there is no need to call DeleteOperation. + * after a few hours, so there is no need to call DeleteOperation.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateInstanceAsync(UpdateInstanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • updateInstanceAsync(FieldMask updateMask) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateInstanceOperationCallable() *
    • updateInstanceCallable() *
    - * * * * * GetInstanceAuthString - * Gets the AUTH string for a Redis instance. If AUTH is not enabled for the + *

    Gets the AUTH string for a Redis instance. If AUTH is not enabled for the * instance the response will be empty. This information is not included in - * the details returned to GetInstance. + * the details returned to GetInstance.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getInstanceAuthString(GetInstanceAuthStringRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getInstanceAuthString(InstanceName name) *
    • getInstanceAuthString(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getInstanceAuthStringCallable() *
    - * * * * * RescheduleMaintenance - * Reschedule maintenance for a given instance in a given project and - * location. + *

    Reschedule maintenance for a given instance in a given project and + * location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • rescheduleMaintenanceAsync(InstanceName name) *
    • rescheduleMaintenanceAsync(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • rescheduleMaintenanceOperationCallable() *
    • rescheduleMaintenanceCallable() *
    - * * * * * CreateInstance - * Creates a Redis instance based on the specified tier and memory size. + *

    Creates a Redis instance based on the specified tier and memory size. * * By default, the instance is accessible from the project's * [default network](https://cloud.google.com/vpc/docs/vpc). @@ -272,141 +236,111 @@ * contain the new instance object in the response field. * * The returned operation is automatically deleted after a few hours, so there - * is no need to call DeleteOperation. + * is no need to call DeleteOperation.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createInstanceAsync(CreateInstanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • createInstanceAsync(LocationName parent) *
    • createInstanceAsync(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createInstanceOperationCallable() *
    • createInstanceCallable() *
    - * * * * * ImportInstance - * Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. + *

    Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. * * Redis may stop serving during this operation. Instance state will be * IMPORTING for entire operation. When complete, the instance will contain * only data from the imported file. * * The returned operation is automatically deleted after a few hours, so - * there is no need to call DeleteOperation. + * there is no need to call DeleteOperation.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • importInstanceAsync(ImportInstanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • importInstanceAsync(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • importInstanceOperationCallable() *
    • importInstanceCallable() *
    - * * * * * FailoverInstance - * Initiates a failover of the primary node to current replica node for a - * specific STANDARD tier Cloud Memorystore for Redis instance. + *

    Initiates a failover of the primary node to current replica node for a + * specific STANDARD tier Cloud Memorystore for Redis instance.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • failoverInstanceAsync(FailoverInstanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • failoverInstanceAsync(InstanceName name) *
    • failoverInstanceAsync(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • failoverInstanceOperationCallable() *
    • failoverInstanceCallable() *
    - * * * * * UpgradeInstance - * Upgrades Redis instance to the newer Redis version specified in the - * request. + *

    Upgrades Redis instance to the newer Redis version specified in the + * request.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • upgradeInstanceAsync(UpgradeInstanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • upgradeInstanceAsync(InstanceName name) *
    • upgradeInstanceAsync(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • upgradeInstanceOperationCallable() *
    • upgradeInstanceCallable() *
    - * * * * * DeleteInstance - * Deletes a specific Redis instance. Instance stops serving and data is - * deleted. + *

    Deletes a specific Redis instance. Instance stops serving and data is + * deleted.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteInstanceAsync(DeleteInstanceRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • deleteInstanceAsync(InstanceName name) *
    • deleteInstanceAsync(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteInstanceOperationCallable() *
    • deleteInstanceCallable() *
    - * * * * diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index 729c820658..1377677719 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -85,365 +85,283 @@ * Method Variants * * DeleteNotification - * Permanently deletes a notification subscription. + *

    Permanently deletes a notification subscription.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteNotification(DeleteNotificationRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteNotification(NotificationName name) *
    • deleteNotification(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteNotificationCallable() *
    - * * * * * DeleteObject - * Deletes an object and its metadata. Deletions are permanent if versioning - * is not enabled for the bucket, or if the `generation` parameter is used. + *

    Deletes an object and its metadata. Deletions are permanent if versioning + * is not enabled for the bucket, or if the `generation` parameter is used.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteObject(DeleteObjectRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteObject(String bucket) *
    • deleteObject(String bucket) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteObjectCallable() *
    - * * * * * StartResumableWrite - * Starts a resumable write. How long the write operation remains valid, and + *

    Starts a resumable write. How long the write operation remains valid, and * what happens when the write operation becomes invalid, are - * service-dependent. + * service-dependent.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • startResumableWrite(StartResumableWriteRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • startResumableWriteCallable() *
    - * * * * * SetIamPolicy - * Updates an IAM policy for the specified bucket or object. + *

    Updates an IAM policy for the specified bucket or object. * The `resource` field in the request should be * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object. + * projects/_/buckets//objects/ for an object.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • setIamPolicy(ResourceName resource) *
    • setIamPolicy(String resource) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * ListNotifications - * Retrieves a list of notification subscriptions for a given bucket. + *

    Retrieves a list of notification subscriptions for a given bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listNotifications(ListNotificationsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listNotifications(ProjectName parent) *
    • listNotifications(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listNotificationsPagedCallable() *
    • listNotificationsCallable() *
    - * * * * * UpdateHmacKey - * Updates a given HMAC key state between ACTIVE and INACTIVE. + *

    Updates a given HMAC key state between ACTIVE and INACTIVE.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateHmacKey(UpdateHmacKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateHmacKey(HmacKeyMetadata hmacKey) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateHmacKeyCallable() *
    - * * * * * GetHmacKey - * Gets an existing HMAC key metadata for the given id. + *

    Gets an existing HMAC key metadata for the given id.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getHmacKey(GetHmacKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getHmacKey(String accessId) *
    • getHmacKey(String accessId) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getHmacKeyCallable() *
    - * * * * * DeleteBucket - * Permanently deletes an empty bucket. + *

    Permanently deletes an empty bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteBucket(DeleteBucketRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteBucket(BucketName name) *
    • deleteBucket(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteBucketCallable() *
    - * * * * * TestIamPermissions - * Tests a set of permissions on the given bucket or object to see which, if + *

    Tests a set of permissions on the given bucket or object to see which, if * any, are held by the caller. * The `resource` field in the request should be * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object. + * projects/_/buckets//objects/ for an object.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • testIamPermissions(ResourceName resource) *
    • testIamPermissions(String resource) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * ListBuckets - * Retrieves a list of buckets for a given project. + *

    Retrieves a list of buckets for a given project.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listBuckets(ListBucketsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listBuckets(ProjectName parent) *
    • listBuckets(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listBucketsPagedCallable() *
    • listBucketsCallable() *
    - * * * * * DeleteHmacKey - * Deletes a given HMAC key. Key must be in an INACTIVE state. + *

    Deletes a given HMAC key. Key must be in an INACTIVE state.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteHmacKey(DeleteHmacKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteHmacKey(String accessId) *
    • deleteHmacKey(String accessId) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteHmacKeyCallable() *
    - * * * * * ListHmacKeys - * Lists HMAC keys under a given project with the additional filters provided. + *

    Lists HMAC keys under a given project with the additional filters provided.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listHmacKeys(ListHmacKeysRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listHmacKeys(ProjectName project) *
    • listHmacKeys(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listHmacKeysPagedCallable() *
    • listHmacKeysCallable() *
    - * * * * * GetObject - * Retrieves an object's metadata. + *

    Retrieves an object's metadata.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getObject(GetObjectRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getObject(String bucket) *
    • getObject(String bucket) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getObjectCallable() *
    - * * * * * CreateNotification - * Creates a notification subscription for a given bucket. + *

    Creates a notification subscription for a given bucket. * These notifications, when triggered, publish messages to the specified * Pub/Sub topics. - * See https://cloud.google.com/storage/docs/pubsub-notifications. + * See https://cloud.google.com/storage/docs/pubsub-notifications.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createNotification(CreateNotificationRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createNotification(ProjectName parent) *
    • createNotification(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createNotificationCallable() *
    - * * * * * WriteObject - * Stores a new object and metadata. + *

    Stores a new object and metadata. * * An object can be written either in a single message stream or in a * resumable sequence of message streams. To write using a single stream, @@ -494,148 +412,116 @@ * * Attempting to resume an already finalized object will result in an OK * status, with a WriteObjectResponse containing the finalized object's - * metadata. + * metadata.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • writeObjectCallable() *
    - * * * * * GetServiceAccount - * Retrieves the name of a project's Google Cloud Storage service account. + *

    Retrieves the name of a project's Google Cloud Storage service account.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getServiceAccount(GetServiceAccountRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getServiceAccount(ProjectName project) *
    • getServiceAccount(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getServiceAccountCallable() *
    - * * * * * ListObjects - * Retrieves a list of objects matching the criteria. + *

    Retrieves a list of objects matching the criteria.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listObjects(ListObjectsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listObjects(ProjectName parent) *
    • listObjects(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listObjectsPagedCallable() *
    • listObjectsCallable() *
    - * * * * * GetBucket - * Returns metadata for the specified bucket. + *

    Returns metadata for the specified bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getBucket(GetBucketRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getBucket(BucketName name) *
    • getBucket(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getBucketCallable() *
    - * * * * * UpdateObject - * Updates an object's metadata. - * Equivalent to JSON API's storage.objects.patch. + *

    Updates an object's metadata. + * Equivalent to JSON API's storage.objects.patch.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateObject(UpdateObjectRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateObject(Object object) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateObjectCallable() *
    - * * * * * GetIamPolicy - * Gets the IAM policy for a specified bucket or object. + *

    Gets the IAM policy for a specified bucket or object. * The `resource` field in the request should be * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object. + * projects/_/buckets//objects/ for an object.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getIamPolicy(ResourceName resource) *
    • getIamPolicy(String resource) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * QueryWriteStatus - * Determines the `persisted_size` for an object that is being written, which + *

    Determines the `persisted_size` for an object that is being written, which * can then be used as the `write_offset` for the next `Write()` call. * * If the object does not exist (i.e., the object has been deleted, or the @@ -647,224 +533,172 @@ * client is buffering data and needs to know which data can be safely * evicted. For any sequence of `QueryWriteStatus()` calls for a given * object name, the sequence of returned `persisted_size` values will be - * non-decreasing. + * non-decreasing.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • queryWriteStatus(QueryWriteStatusRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • queryWriteStatus(String uploadId) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • queryWriteStatusCallable() *
    - * * * * * RewriteObject - * Rewrites a source object to a destination object. Optionally overrides - * metadata. + *

    Rewrites a source object to a destination object. Optionally overrides + * metadata.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • rewriteObject(RewriteObjectRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • rewriteObjectCallable() *
    - * * * * * LockBucketRetentionPolicy - * Locks retention policy on a bucket. + *

    Locks retention policy on a bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • lockBucketRetentionPolicy(BucketName bucket) *
    • lockBucketRetentionPolicy(String bucket) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • lockBucketRetentionPolicyCallable() *
    - * * * * * CreateHmacKey - * Creates a new HMAC key for the given service account. + *

    Creates a new HMAC key for the given service account.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createHmacKey(CreateHmacKeyRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createHmacKey(ProjectName project) *
    • createHmacKey(String project) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createHmacKeyCallable() *
    - * * * * * ComposeObject - * Concatenates a list of existing objects into a new object in the same - * bucket. + *

    Concatenates a list of existing objects into a new object in the same + * bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • composeObject(ComposeObjectRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • composeObjectCallable() *
    - * * * * * CancelResumableWrite - * Cancels an in-progress resumable upload. + *

    Cancels an in-progress resumable upload.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • cancelResumableWrite(CancelResumableWriteRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • cancelResumableWrite(String uploadId) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • cancelResumableWriteCallable() *
    - * * * * * UpdateBucket - * Updates a bucket. Equivalent to JSON API's storage.buckets.patch method. + *

    Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateBucket(UpdateBucketRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • updateBucket(Bucket bucket) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateBucketCallable() *
    - * * * * * ReadObject - * Reads an object's data. + *

    Reads an object's data.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • readObjectCallable() *
    - * * * * * CreateBucket - * Creates a new bucket. + *

    Creates a new bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createBucket(CreateBucketRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createBucket(ProjectName parent) *
    • createBucket(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createBucketCallable() *
    - * * * * * GetNotification - * View a notification config. + *

    View a notification config.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getNotification(GetNotificationRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getNotification(BucketName name) *
    • getNotification(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getNotificationCallable() *
    - * * * * From 83f4743c60e1a71f2dfc7c8aad81fe41e9416406 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 13 Oct 2023 16:02:00 -0400 Subject: [PATCH 05/21] fix lint --- .../gapic/composer/comment/ServiceClientCommentComposer.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index 7e305b0c87..3e6c519e77 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -250,7 +250,7 @@ private static String createTableOfMethods(List methodAndVari .append(method.method) .append("\n") .append(" ") - .append("

    "+ method.description + "

    ") + .append("

    " + method.description + "

    ") .append("\n") .append(" \n"); if (method.hasRequestObjectVariants) { From a4abe4e20dd323f610ce753cbc1a6308770a0169 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 13 Oct 2023 22:02:52 -0400 Subject: [PATCH 06/21] update showcase goldens --- .../showcase/v1beta1/ComplianceClient.java | 108 +++---------- .../google/showcase/v1beta1/EchoClient.java | 100 +++--------- .../showcase/v1beta1/IdentityClient.java | 72 ++------- .../showcase/v1beta1/MessagingClient.java | 142 ++++-------------- .../v1beta1/SequenceServiceClient.java | 80 ++-------- .../showcase/v1beta1/TestingClient.java | 90 +++-------- 6 files changed, 123 insertions(+), 469 deletions(-) diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java index aa57e88c80..ea0b20f52e 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java @@ -86,300 +86,240 @@ * Method Variants * * GetEnum - * This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the + *

    This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the * response from this RPC as the request to VerifyEnum() * * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for - * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs. + * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getEnum(EnumRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getEnumCallable() *
    - * * * * * RepeatDataPathTrailingResource - * Same as RepeatDataSimplePath, but with a trailing resource. + *

    Same as RepeatDataSimplePath, but with a trailing resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataPathTrailingResource(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataPathTrailingResourceCallable() *
    - * * * * * VerifyEnum - * This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum() + *

    This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum() * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds * with the same EnumResponse; otherwise, the RPC errors. * * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run, - * although they are not guaranteed to be the same across separate Showcase server runs. + * although they are not guaranteed to be the same across separate Showcase server runs.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • verifyEnum(EnumResponse request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • verifyEnumCallable() *
    - * * * * * RepeatDataQuery - * This method echoes the ComplianceData request. This method exercises - * sending all request fields as query parameters. + *

    This method echoes the ComplianceData request. This method exercises + * sending all request fields as query parameters.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataQuery(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataQueryCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. + *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces any + *

    Sets the access control policy on the specified resource. Replaces any * existing policy. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * RepeatDataSimplePath - * This method echoes the ComplianceData request. This method exercises + *

    This method echoes the ComplianceData request. This method exercises * sending some parameters as "simple" path variables (i.e., of the form - * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters. + * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataSimplePath(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataSimplePathCallable() *
    - * * * * * RepeatDataBodyPut - * This method echoes the ComplianceData request, using the HTTP PUT method. + *

    This method echoes the ComplianceData request, using the HTTP PUT method.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataBodyPut(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataBodyPutCallable() *
    - * * * * * RepeatDataBodyPatch - * This method echoes the ComplianceData request, using the HTTP PATCH method. + *

    This method echoes the ComplianceData request, using the HTTP PATCH method.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataBodyPatch(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataBodyPatchCallable() *
    - * * * * * GetLocation - * Gets information about a location. + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLocation(GetLocationRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLocationCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. + *

    Returns permissions that a caller has on the specified resource. * If the resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building permission-aware * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning. + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * RepeatDataPathResource - * Same as RepeatDataSimplePath, but with a path resource. + *

    Same as RepeatDataSimplePath, but with a path resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataPathResource(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataPathResourceCallable() *
    - * * * * * ListLocations - * Lists information about the supported locations for this service. + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLocations(ListLocationsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLocationsPagedCallable() *
    • listLocationsCallable() *
    - * * * * * RepeatDataBody - * This method echoes the ComplianceData request. This method exercises - * sending the entire request object in the REST body. + *

    This method echoes the ComplianceData request. This method exercises + * sending the entire request object in the REST body.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataBody(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataBodyCallable() *
    - * * * * * RepeatDataBodyInfo - * This method echoes the ComplianceData request. This method exercises + *

    This method echoes the ComplianceData request. This method exercises * sending the a message-type field in the REST body. Per AIP-127, only - * top-level, non-repeated fields can be sent this way. + * top-level, non-repeated fields can be sent this way.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • repeatDataBodyInfo(RepeatRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • repeatDataBodyInfoCallable() *
    - * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java index 89a511692a..28d8b11732 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java @@ -89,266 +89,216 @@ * Method Variants * * PagedExpandLegacyMapped - * This method returns a map containing lists of words that appear in the input, keyed by their + *

    This method returns a map containing lists of words that appear in the input, keyed by their * initial character. The only words returned are the ones included in the current page, * as determined by page_token and page_size, which both refer to the word indices in the * input. This paging result consisting of a map of lists is a pattern used by some legacy - * APIs. New APIs should NOT use this pattern. + * APIs. New APIs should NOT use this pattern.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • pagedExpandLegacyMapped(PagedExpandRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • pagedExpandLegacyMappedPagedCallable() *
    • pagedExpandLegacyMappedCallable() *
    - * * * * * Echo - * This method simply echoes the request. This method showcases unary RPCs. + *

    This method simply echoes the request. This method showcases unary RPCs.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • echo(EchoRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • echoCallable() *
    - * * * * * Collect - * This method will collect the words given to it. When the stream is closed + *

    This method will collect the words given to it. When the stream is closed * by the client, this method will return the a concatenation of the strings - * passed to it. This method showcases client-side streaming RPCs. + * passed to it. This method showcases client-side streaming RPCs.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • collectCallable() *
    - * * * * * PagedExpand - * This is similar to the Expand method but instead of returning a stream of - * expanded words, this method returns a paged list of expanded words. + *

    This is similar to the Expand method but instead of returning a stream of + * expanded words, this method returns a paged list of expanded words.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • pagedExpand(PagedExpandRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • pagedExpandPagedCallable() *
    • pagedExpandCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. + *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces any + *

    Sets the access control policy on the specified resource. Replaces any * existing policy. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * PagedExpandLegacy - * This is similar to the PagedExpand except that it uses + *

    This is similar to the PagedExpand except that it uses * max_results instead of page_size, as some legacy APIs still - * do. New APIs should NOT use this pattern. + * do. New APIs should NOT use this pattern.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • pagedExpandLegacy(PagedExpandLegacyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • pagedExpandLegacyCallable() *
    - * * * * * Expand - * This method splits the given content into words and will pass each word back - * through the stream. This method showcases server-side streaming RPCs. + *

    This method splits the given content into words and will pass each word back + * through the stream. This method showcases server-side streaming RPCs.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • expandCallable() *
    - * * * * * Chat - * This method, upon receiving a request on the stream, will pass the same + *

    This method, upon receiving a request on the stream, will pass the same * content back on the stream. This method showcases bidirectional - * streaming RPCs. + * streaming RPCs.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • chatCallable() *
    - * * * * * GetLocation - * Gets information about a location. + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLocation(GetLocationRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLocationCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. + *

    Returns permissions that a caller has on the specified resource. * If the resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building permission-aware * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning. + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * Block - * This method will block (wait) for the requested amount of time + *

    This method will block (wait) for the requested amount of time * and then return the response or error. - * This method showcases how a client handles delays or retries. + * This method showcases how a client handles delays or retries.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • block(BlockRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • blockCallable() *
    - * * * * * Wait - * This method will wait for the requested amount of time and then return. - * This method showcases how a client handles a request timeout. + *

    This method will wait for the requested amount of time and then return. + * This method showcases how a client handles a request timeout.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • waitAsync(WaitRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • waitOperationCallable() *
    • waitCallable() *
    - * * * * * ListLocations - * Lists information about the supported locations for this service. + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLocations(ListLocationsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLocationsPagedCallable() *
    • listLocationsCallable() *
    - * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java index ee2d7df654..66b88219a5 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java @@ -73,216 +73,170 @@ * Method Variants * * ListUsers - * Lists all users. + *

    Lists all users.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listUsers(ListUsersRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listUsersPagedCallable() *
    • listUsersCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. + *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * GetLocation - * Gets information about a location. + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLocation(GetLocationRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLocationCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. + *

    Returns permissions that a caller has on the specified resource. * If the resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building permission-aware * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning. + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * CreateUser - * Creates a user. + *

    Creates a user.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createUser(CreateUserRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createUser(String displayName) *
    • createUser(String displayName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createUserCallable() *
    - * * * * * DeleteUser - * Deletes a user, their profile, and all of their authored messages. + *

    Deletes a user, their profile, and all of their authored messages.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteUser(DeleteUserRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteUser(UserName name) *
    • deleteUser(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteUserCallable() *
    - * * * * * UpdateUser - * Updates a user. + *

    Updates a user.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateUser(UpdateUserRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateUserCallable() *
    - * * * * * ListLocations - * Lists information about the supported locations for this service. + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLocations(ListLocationsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLocationsPagedCallable() *
    • listLocationsCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces any + *

    Sets the access control policy on the specified resource. Replaces any * existing policy. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * GetUser - * Retrieves the User with the given uri. + *

    Retrieves the User with the given uri.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getUser(GetUserRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getUser(UserName name) *
    • getUser(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getUserCallable() *
    - * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java index bd7efedd9e..826ec2f117 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java @@ -84,372 +84,295 @@ * Method Variants * * SearchBlurbs - * This method searches through all blurbs across all rooms and profiles + *

    This method searches through all blurbs across all rooms and profiles * for blurbs containing to words found in the query. Only posts that - * contain an exact match of a queried word will be returned. + * contain an exact match of a queried word will be returned.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • searchBlurbsAsync(SearchBlurbsRequest request) *
    - * *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - * *
      *
    • searchBlurbsAsync(ProfileName parent) *
    • searchBlurbsAsync(RoomName parent) *
    • searchBlurbsAsync(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • searchBlurbsOperationCallable() *
    • searchBlurbsCallable() *
    - * * * * * Connect - * This method starts a bidirectional stream that receives all blurbs that + *

    This method starts a bidirectional stream that receives all blurbs that * are being created after the stream has started and sends requests to create * blurbs. If an invalid blurb is requested to be created, the stream will - * close with an error. + * close with an error.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • connectCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. + *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * SendBlurbs - * This is a stream to create multiple blurbs. If an invalid blurb is - * requested to be created, the stream will close with an error. + *

    This is a stream to create multiple blurbs. If an invalid blurb is + * requested to be created, the stream will close with an error.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • sendBlurbsCallable() *
    - * * * * * UpdateRoom - * Updates a room. + *

    Updates a room.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateRoom(UpdateRoomRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateRoomCallable() *
    - * * * * * GetBlurb - * Retrieves the Blurb with the given resource name. + *

    Retrieves the Blurb with the given resource name.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getBlurb(GetBlurbRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getBlurb(BlurbName name) *
    • getBlurb(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getBlurbCallable() *
    - * * * * * GetRoom - * Retrieves the Room with the given resource name. + *

    Retrieves the Room with the given resource name.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getRoom(GetRoomRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getRoom(RoomName name) *
    • getRoom(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getRoomCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces any + *

    Sets the access control policy on the specified resource. Replaces any * existing policy. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * UpdateBlurb - * Updates a blurb. + *

    Updates a blurb.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • updateBlurb(UpdateBlurbRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • updateBlurbCallable() *
    - * * * * * ListBlurbs - * Lists blurbs for a specific chat room or user profile depending on the - * parent resource name. + *

    Lists blurbs for a specific chat room or user profile depending on the + * parent resource name.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listBlurbs(ListBlurbsRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • listBlurbs(ProfileName parent) *
    • listBlurbs(RoomName parent) *
    • listBlurbs(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listBlurbsPagedCallable() *
    • listBlurbsCallable() *
    - * * * * * StreamBlurbs - * This returns a stream that emits the blurbs that are created for a - * particular chat room or user profile. + *

    This returns a stream that emits the blurbs that are created for a + * particular chat room or user profile.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • streamBlurbsCallable() *
    - * * * * * DeleteRoom - * Deletes a room and all of its blurbs. + *

    Deletes a room and all of its blurbs.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteRoom(DeleteRoomRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteRoom(RoomName name) *
    • deleteRoom(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteRoomCallable() *
    - * * * * * ListRooms - * Lists all chat rooms. + *

    Lists all chat rooms.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listRooms(ListRoomsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listRoomsPagedCallable() *
    • listRoomsCallable() *
    - * * * * * GetLocation - * Gets information about a location. + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLocation(GetLocationRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLocationCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. + *

    Returns permissions that a caller has on the specified resource. * If the resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building permission-aware * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning. + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * CreateRoom - * Creates a room. + *

    Creates a room.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createRoom(CreateRoomRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createRoom(String displayName) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createRoomCallable() *
    - * * * * * ListLocations - * Lists information about the supported locations for this service. + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLocations(ListLocationsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLocationsPagedCallable() *
    • listLocationsCallable() *
    - * * * * * CreateBlurb - * Creates a blurb. If the parent is a room, the blurb is understood to be a + *

    Creates a blurb. If the parent is a room, the blurb is understood to be a * message in that room. If the parent is a profile, the blurb is understood - * to be a post on the profile. + * to be a post on the profile.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createBlurb(CreateBlurbRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createBlurb(ProfileName parent) *
    • createBlurb(ProfileName parent) @@ -464,38 +387,29 @@ *
    • createBlurb(String parent) *
    • createBlurb(String parent) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createBlurbCallable() *
    - * * * * * DeleteBlurb - * Deletes a blurb. + *

    Deletes a blurb.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteBlurb(DeleteBlurbRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • deleteBlurb(BlurbName name) *
    • deleteBlurb(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteBlurbCallable() *
    - * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java index 152b63db82..9b6f0220f2 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java @@ -72,239 +72,187 @@ * Method Variants * * GetSequenceReport - * Retrieves a sequence. + *

    Retrieves a sequence.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSequenceReport(GetSequenceReportRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getSequenceReport(SequenceReportName name) *
    • getSequenceReport(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSequenceReportCallable() *
    - * * * * * GetStreamingSequenceReport - * Retrieves a sequence. + *

    Retrieves a sequence.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getStreamingSequenceReport(GetStreamingSequenceReportRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • getStreamingSequenceReport(StreamingSequenceReportName name) *
    • getStreamingSequenceReport(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getStreamingSequenceReportCallable() *
    - * * * * * AttemptStreamingSequence - * Attempts a streaming sequence. + *

    Attempts a streaming sequence.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • attemptStreamingSequenceCallable() *
    - * * * * * AttemptSequence - * Attempts a sequence. + *

    Attempts a sequence.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • attemptSequence(AttemptSequenceRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • attemptSequence(SequenceName name) *
    • attemptSequence(String name) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • attemptSequenceCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. + *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * CreateStreamingSequence - * Creates a sequence. + *

    Creates a sequence.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createStreamingSequence(CreateStreamingSequenceRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createStreamingSequence(StreamingSequence streamingSequence) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createStreamingSequenceCallable() *
    - * * * * * GetLocation - * Gets information about a location. + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLocation(GetLocationRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLocationCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. + *

    Returns permissions that a caller has on the specified resource. * If the resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building permission-aware * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning. + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * CreateSequence - * Creates a sequence. + *

    Creates a sequence.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createSequence(CreateSequenceRequest request) *
    - * *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - * *
      *
    • createSequence(Sequence sequence) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createSequenceCallable() *
    - * * * * * ListLocations - * Lists information about the supported locations for this service. + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLocations(ListLocationsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLocationsPagedCallable() *
    • listLocationsCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces any + *

    Sets the access control policy on the specified resource. Replaces any * existing policy. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java index 65c6728bbf..b4046ff2be 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java @@ -73,260 +73,208 @@ * Method Variants * * DeleteTest - * Explicitly decline to implement a test. + *

    Explicitly decline to implement a test. * * This removes the test from subsequent `ListTests` calls, and * attempting to do the test will error. * - * This method will error if attempting to delete a required test. + * This method will error if attempting to delete a required test.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteTest(DeleteTestRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteTestCallable() *
    - * * * * * GetIamPolicy - * Gets the access control policy for a resource. + *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy - * set. + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getIamPolicy(GetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getIamPolicyCallable() *
    - * * * * * CreateSession - * Creates a new testing session. + *

    Creates a new testing session.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • createSession(CreateSessionRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • createSessionCallable() *
    - * * * * * SetIamPolicy - * Sets the access control policy on the specified resource. Replaces any + *

    Sets the access control policy on the specified resource. Replaces any * existing policy. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • setIamPolicy(SetIamPolicyRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • setIamPolicyCallable() *
    - * * * * * GetSession - * Gets a testing session. + *

    Gets a testing session.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getSession(GetSessionRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getSessionCallable() *
    - * * * * * DeleteSession - * Delete a test session. + *

    Delete a test session.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • deleteSession(DeleteSessionRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • deleteSessionCallable() *
    - * * * * * VerifyTest - * Register a response to a test. + *

    Register a response to a test. * * In cases where a test involves registering a final answer at the - * end of the test, this method provides the means to do so. + * end of the test, this method provides the means to do so.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • verifyTest(VerifyTestRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • verifyTestCallable() *
    - * * * * * GetLocation - * Gets information about a location. + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • getLocation(GetLocationRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • getLocationCallable() *
    - * * * * * TestIamPermissions - * Returns permissions that a caller has on the specified resource. + *

    Returns permissions that a caller has on the specified resource. * If the resource does not exist, this will return an empty set of * permissions, not a `NOT_FOUND` error. * * Note: This operation is designed to be used for building permission-aware * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning. + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • testIamPermissions(TestIamPermissionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • testIamPermissionsCallable() *
    - * * * * * ListTests - * List the tests of a sessesion. + *

    List the tests of a sessesion.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listTests(ListTestsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listTestsPagedCallable() *
    • listTestsCallable() *
    - * * * * * ListLocations - * Lists information about the supported locations for this service. + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listLocations(ListLocationsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listLocationsPagedCallable() *
    • listLocationsCallable() *
    - * * * * * ReportSession - * Report on the status of a session. + *

    Report on the status of a session. * This generates a report detailing which tests have been completed, - * and an overall rollup. + * and an overall rollup.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • reportSession(ReportSessionRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • reportSessionCallable() *
    - * * * * * ListSessions - * Lists the current test sessions. + *

    Lists the current test sessions.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - * *
      *
    • listSessions(ListSessionsRequest request) *
    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - * *
      *
    • listSessionsPagedCallable() *
    • listSessionsCallable() *
    - * * * * From cae754e301443865cb51ed9e489969bd1a509510 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Thu, 9 Nov 2023 14:50:33 -0500 Subject: [PATCH 07/21] test remove cache for golden test --- .github/workflows/ci.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 4b86e4b5d3..dadad974b9 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -59,7 +59,7 @@ jobs: with: java-version: 8 distribution: temurin - cache: maven +# cache: maven - run: echo "JAVA8_HOME=${JAVA_HOME}" >> $GITHUB_ENV - uses: actions/setup-java@v3 with: @@ -86,7 +86,7 @@ jobs: with: java-version: 11 distribution: temurin - cache: maven +# cache: maven - name: Install all modules using Java 11 shell: bash run: | From 07e6e518a9eac19062370d7f0808c927c3dabcbc Mon Sep 17 00:00:00 2001 From: Alice Li Date: Thu, 9 Nov 2023 15:46:50 -0500 Subject: [PATCH 08/21] update integration goldens --- .../v1/ConnectionServiceClient.java | 40 +- .../cloud/apigeeconnect/v1/TetherClient.java | 35 +- .../cloud/asset/v1/AssetServiceClient.java | 415 +----------- .../data/v2/BaseBigtableDataClient.java | 148 +--- .../compute/v1small/AddressesClient.java | 95 +-- .../v1small/RegionOperationsClient.java | 57 +- .../credentials/v1/IamCredentialsClient.java | 95 +-- .../com/google/iam/v1/IAMPolicyClient.java | 70 +- .../kms/v1/KeyManagementServiceClient.java | 592 +--------------- .../library/v1/LibraryServiceClient.java | 236 +------ .../google/cloud/logging/v2/ConfigClient.java | 552 +-------------- .../cloud/logging/v2/LoggingClient.java | 138 +--- .../cloud/logging/v2/MetricsClient.java | 115 +--- .../cloud/pubsub/v1/SchemaServiceClient.java | 257 +------ .../pubsub/v1/SubscriptionAdminClient.java | 438 +----------- .../cloud/pubsub/v1/TopicAdminClient.java | 248 +------ .../cloud/redis/v1beta1/CloudRedisClient.java | 273 +------- .../com/google/storage/v2/StorageClient.java | 635 +----------------- 18 files changed, 223 insertions(+), 4216 deletions(-) diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java index d41dc4399f..0254061ebe 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java @@ -57,33 +57,19 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    ListConnections

    Lists connections that are currently active for the given Apigee Connect - * endpoint.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listConnections(ListConnectionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listConnections(EndpointName parent) - *
    • listConnections(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listConnectionsPagedCallable() - *
    • listConnectionsCallable() - *
    - *
    + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java index fbb28f87c3..d085337c32 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java @@ -61,28 +61,19 @@ *

    Note: close() needs to be called on the TetherClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    Egress

    Egress streams egress requests and responses. Logically, this is not - * actually a streaming request, but uses streaming as a mechanism to flip - * the client-server relationship of gRPC so that the server can act as a - * client. - * The listener, the RPC server, accepts connections from the dialer, - * the RPC client. - * The listener streams http requests and the dialer streams http responses.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • egressCallable() - *
    - *
    + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index 07eb2dab2c..bea5e6251a 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -69,410 +69,19 @@ *

    Note: close() needs to be called on the AssetServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    UpdateFeed

    Updates an asset feed configuration.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateFeed(UpdateFeedRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateFeed(Feed feed) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateFeedCallable() - *
    - *
    ListFeeds

    Lists all asset feeds in a parent project/folder/organization.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listFeeds(ListFeedsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listFeeds(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listFeedsCallable() - *
    - *
    GetFeed

    Gets details about an asset feed.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getFeed(GetFeedRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getFeed(FeedName name) - *
    • getFeed(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getFeedCallable() - *
    - *
    BatchGetAssetsHistory

    Batch gets the update history of assets that overlap a time window. - * For IAM_POLICY content, this API outputs history when the asset and its - * attached IAM POLICY both exist. This can create gaps in the output history. - * Otherwise, this API outputs history with asset in both non-delete or - * deleted status. - * If a specified asset does not exist, this API returns an INVALID_ARGUMENT - * error.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • batchGetAssetsHistoryCallable() - *
    - *
    AnalyzeIamPolicy

    Analyzes IAM policies to answer which identities have what accesses on - * which resources.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • analyzeIamPolicy(AnalyzeIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • analyzeIamPolicyCallable() - *
    - *
    ExportAssets

    Exports assets with time and resource types to a given Cloud Storage - * location/BigQuery table. For Cloud Storage location destinations, the - * output format is newline-delimited JSON. Each line represents a - * [google.cloud.asset.v1.Asset][google.cloud.asset.v1.Asset] in the JSON format; for BigQuery table - * destinations, the output table stores the fields in asset Protobuf as - * columns. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API, - * which allows you to keep track of the export. We recommend intervals of at - * least 2 seconds with exponential retry to poll the export operation result. - * For regular-size resource parent, the export operation usually finishes - * within 5 minutes.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • exportAssetsAsync(ExportAssetsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • exportAssetsOperationCallable() - *
    • exportAssetsCallable() - *
    - *
    GetSavedQuery

    Gets details about a saved query.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getSavedQuery(GetSavedQueryRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getSavedQuery(SavedQueryName name) - *
    • getSavedQuery(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getSavedQueryCallable() - *
    - *
    CreateSavedQuery

    Creates a saved query in a parent project/folder/organization.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createSavedQuery(CreateSavedQueryRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createSavedQuery(FolderName parent) - *
    • createSavedQuery(OrganizationName parent) - *
    • createSavedQuery(ProjectName parent) - *
    • createSavedQuery(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createSavedQueryCallable() - *
    - *
    ListAssets

    Lists assets with time and resource types and returns paged results in - * response.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listAssets(ListAssetsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listAssets(ResourceName parent) - *
    • listAssets(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listAssetsPagedCallable() - *
    • listAssetsCallable() - *
    - *
    DeleteFeed

    Deletes an asset feed.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteFeed(DeleteFeedRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteFeed(FeedName name) - *
    • deleteFeed(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteFeedCallable() - *
    - *
    QueryAssets

    Issue a job that queries assets using a SQL statement compatible with - * [BigQuery Standard - * SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql). + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * If the query execution finishes within timeout and there's no pagination, - * the full query results will be returned in the `QueryAssetsResponse`. - * - * Otherwise, full query results can be obtained by issuing extra requests - * with the `job_reference` from the a previous `QueryAssets` call. - * - * Note, the query result has approximately 10 GB limitation enforced by - * BigQuery - * https://cloud.google.com/bigquery/docs/best-practices-performance-output, - * queries return larger results will result in errors.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • queryAssets(QueryAssetsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • queryAssetsCallable() - *
    - *
    DeleteSavedQuery

    Deletes a saved query.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteSavedQuery(DeleteSavedQueryRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSavedQuery(SavedQueryName name) - *
    • deleteSavedQuery(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteSavedQueryCallable() - *
    - *
    SearchAllResources

    Searches all Cloud resources within the specified scope, such as a project, - * folder, or organization. The caller must be granted the - * `cloudasset.assets.searchAllResources` permission on the desired scope, - * otherwise the request will be rejected.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • searchAllResources(SearchAllResourcesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • searchAllResources(String scope) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • searchAllResourcesPagedCallable() - *
    • searchAllResourcesCallable() - *
    - *
    UpdateSavedQuery

    Updates a saved query.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateSavedQuery(UpdateSavedQueryRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateSavedQuery(SavedQuery savedQuery) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateSavedQueryCallable() - *
    - *
    AnalyzeIamPolicyLongrunning

    Analyzes IAM policies asynchronously to answer which identities have what - * accesses on which resources, and writes the analysis results to a Google - * Cloud Storage or a BigQuery destination. For Cloud Storage destination, the - * output format is the JSON format that represents a - * [AnalyzeIamPolicyResponse][google.cloud.asset.v1.AnalyzeIamPolicyResponse]. This method implements the - * [google.longrunning.Operation][google.longrunning.Operation], which allows you to track the operation - * status. We recommend intervals of at least 2 seconds with exponential - * backoff retry to poll the operation result. The metadata contains the - * metadata for the long-running operation.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • analyzeIamPolicyLongrunningOperationCallable() - *
    • analyzeIamPolicyLongrunningCallable() - *
    - *
    ListSavedQueries

    Lists all saved queries in a parent project/folder/organization.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listSavedQueries(ListSavedQueriesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSavedQueries(FolderName parent) - *
    • listSavedQueries(OrganizationName parent) - *
    • listSavedQueries(ProjectName parent) - *
    • listSavedQueries(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listSavedQueriesPagedCallable() - *
    • listSavedQueriesCallable() - *
    - *
    CreateFeed

    Creates a feed in a parent project/folder/organization to listen to its - * asset updates.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createFeed(CreateFeedRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createFeed(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createFeedCallable() - *
    - *
    BatchGetEffectiveIamPolicies

    Gets effective IAM policies for a batch of resources.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • batchGetEffectiveIamPoliciesCallable() - *
    - *
    SearchAllIamPolicies

    Searches all IAM policies within the specified scope, such as a project, - * folder, or organization. The caller must be granted the - * `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, - * otherwise the request will be rejected.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • searchAllIamPolicies(SearchAllIamPoliciesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • searchAllIamPolicies(String scope) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • searchAllIamPoliciesPagedCallable() - *
    • searchAllIamPoliciesCallable() - *
    - *
    AnalyzeMove

    Analyze moving a resource to a specified destination without kicking off - * the actual move. The analysis is best effort depending on the user's - * permissions of viewing different hierarchical policies and configurations. - * The policies and configuration are subject to change before the actual - * resource migration takes place.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • analyzeMove(AnalyzeMoveRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • analyzeMoveCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index d01885145f..34257fb4cd 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -71,141 +71,19 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    MutateRows

    Mutates multiple rows in a batch. Each individual row is mutated - * atomically as in MutateRow, but the entire batch is not executed - * atomically.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • mutateRowsCallable() - *
    - *
    PingAndWarm

    Warm up associated instance metadata for this connection. - * This call is not required but may be useful for connection keep-alive.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • pingAndWarm(PingAndWarmRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • pingAndWarm(InstanceName name) - *
    • pingAndWarm(String name) - *
    • pingAndWarm(InstanceName name) - *
    • pingAndWarm(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • pingAndWarmCallable() - *
    - *
    ReadRows

    Streams back the contents of all requested rows in key order, optionally - * applying the same Reader filter to each. Depending on their size, - * rows and cells may be broken up across multiple responses, but - * atomicity of each row will still be preserved. See the - * ReadRowsResponse documentation for details.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • readRowsCallable() - *
    - *
    ReadModifyWriteRow

    Modifies a row atomically on the server. The method reads the latest - * existing timestamp and value from the specified columns and writes a new - * entry based on pre-defined read/modify/write rules. The new value for the - * timestamp is the greater of the existing timestamp or the current server - * time. The method returns the new contents of all modified cells.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • readModifyWriteRow(ReadModifyWriteRowRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • readModifyWriteRow(TableName tableName) - *
    • readModifyWriteRow(String tableName) - *
    • readModifyWriteRow(TableName tableName) - *
    • readModifyWriteRow(String tableName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • readModifyWriteRowCallable() - *
    - *
    MutateRow

    Mutates a row atomically. Cells already present in the row are left - * unchanged unless explicitly changed by `mutation`.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • mutateRow(MutateRowRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • mutateRow(TableName tableName) - *
    • mutateRow(String tableName) - *
    • mutateRow(TableName tableName) - *
    • mutateRow(String tableName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • mutateRowCallable() - *
    - *
    SampleRowKeys

    Returns a sample of row keys in the table. The returned row keys will - * delimit contiguous sections of the table of approximately equal size, - * which can be used to break up the data for distributed tasks like - * mapreduces.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • sampleRowKeysCallable() - *
    - *
    CheckAndMutateRow

    Mutates a row atomically based on the output of a predicate Reader filter.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • checkAndMutateRow(CheckAndMutateRowRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • checkAndMutateRow(TableName tableName) - *
    • checkAndMutateRow(String tableName) - *
    • checkAndMutateRow(TableName tableName) - *
    • checkAndMutateRow(String tableName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • checkAndMutateRowCallable() - *
    - *
    + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index 4aec80ab53..7da6db9b67 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -63,88 +63,19 @@ *

    Note: close() needs to be called on the AddressesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    Delete

    Deletes the specified address resource.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteAsync(DeleteAddressRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • deleteAsync(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteOperationCallable() - *
    • deleteCallable() - *
    - *
    List

    Retrieves a list of addresses contained within the specified region.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • list(ListAddressesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • list(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listPagedCallable() - *
    • listCallable() - *
    - *
    Insert

    Creates an address resource in the specified project by using the data included in the request.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • insertAsync(InsertAddressRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • insertAsync(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • insertOperationCallable() - *
    • insertCallable() - *
    - *
    AggregatedList

    Retrieves an aggregated list of addresses.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • aggregatedList(AggregatedListAddressesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • aggregatedList(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • aggregatedListPagedCallable() - *
    • aggregatedListCallable() - *
    - *
    + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java index ff43ff31a1..d74718729f 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java @@ -49,52 +49,19 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    Get

    Retrieves the specified region-specific Operations resource.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • get(GetRegionOperationRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • get(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getCallable() - *
    - *
    Wait

    Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * This method is called on a best-effort basis. Specifically: - * - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. - * - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • wait(WaitRegionOperationRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • wait(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • waitCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java index 2c573b309a..aa18c91623 100644 --- a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java +++ b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java @@ -60,88 +60,19 @@ *

    Note: close() needs to be called on the IamCredentialsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    GenerateAccessToken

    Generates an OAuth 2.0 access token for a service account.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • generateAccessToken(GenerateAccessTokenRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • generateAccessToken(ServiceAccountName name) - *
    • generateAccessToken(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • generateAccessTokenCallable() - *
    - *
    GenerateIdToken

    Generates an OpenID Connect ID token for a service account.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • generateIdToken(GenerateIdTokenRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • generateIdToken(ServiceAccountName name) - *
    • generateIdToken(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • generateIdTokenCallable() - *
    - *
    SignBlob

    Signs a blob using a service account's system-managed private key.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • signBlob(SignBlobRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • signBlob(ServiceAccountName name) - *
    • signBlob(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • signBlobCallable() - *
    - *
    SignJwt

    Signs a JWT using a service account's system-managed private key.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • signJwt(SignJwtRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • signJwt(ServiceAccountName name) - *
    • signJwt(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • signJwtCallable() - *
    - *
    + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java index 89a94e6fa2..43009b89f4 100644 --- a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java +++ b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java @@ -72,65 +72,19 @@ *

    Note: close() needs to be called on the IAMPolicyClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    GetIamPolicy

    Gets the access control policy for a resource. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getIamPolicyCallable() - *
    - *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. - * If the resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * Note: This operation is designed to be used for building permission-aware - * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() - *
    - *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces any - * existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • setIamPolicy(SetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • setIamPolicyCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index 228cd0f025..23f83c2389 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -80,587 +80,19 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    UpdateCryptoKey

    Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateCryptoKey(UpdateCryptoKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateCryptoKey(CryptoKey cryptoKey) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateCryptoKeyCallable() - *
    - *
    Decrypt

    Decrypts data that was protected by - * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The - * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • decrypt(DecryptRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • decrypt(CryptoKeyName name) - *
    • decrypt(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • decryptCallable() - *
    - *
    ListKeyRings

    Lists [KeyRings][google.cloud.kms.v1.KeyRing].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listKeyRings(ListKeyRingsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listKeyRings(LocationName parent) - *
    • listKeyRings(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listKeyRingsPagedCallable() - *
    • listKeyRingsCallable() - *
    - *
    AsymmetricDecrypt

    Decrypts data that was encrypted with a public key retrieved from - * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] - * corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] - * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] - * ASYMMETRIC_DECRYPT.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • asymmetricDecrypt(AsymmetricDecryptRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • asymmetricDecrypt(CryptoKeyVersionName name) - *
    • asymmetricDecrypt(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • asymmetricDecryptCallable() - *
    - *
    ListImportJobs

    Lists [ImportJobs][google.cloud.kms.v1.ImportJob].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listImportJobs(ListImportJobsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listImportJobs(KeyRingName parent) - *
    • listImportJobs(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listImportJobsPagedCallable() - *
    • listImportJobsCallable() - *
    - *
    GetImportJob

    Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getImportJob(GetImportJobRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getImportJob(ImportJobName name) - *
    • getImportJob(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getImportJobCallable() - *
    - *
    CreateImportJob

    Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a - * [KeyRing][google.cloud.kms.v1.KeyRing]. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is - * required.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createImportJob(CreateImportJobRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createImportJob(KeyRingName parent) - *
    • createImportJob(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createImportJobCallable() - *
    - *
    ImportCryptoKeyVersion

    Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into - * an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the wrapped - * key material provided in the request. - * - * The version ID will be assigned the next sequential id within the - * [CryptoKey][google.cloud.kms.v1.CryptoKey].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • importCryptoKeyVersionCallable() - *
    - *
    GetPublicKey

    Returns the public key for the given - * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The - * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - * [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] - * or - * [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getPublicKey(GetPublicKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getPublicKey(CryptoKeyVersionName name) - *
    • getPublicKey(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getPublicKeyCallable() - *
    - *
    GetLocation

    Gets information about a location.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getLocation(GetLocationRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getLocationCallable() - *
    - *
    TestIamPermissions

    This is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() - *
    - *
    CreateKeyRing

    Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and - * Location.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createKeyRing(CreateKeyRingRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createKeyRing(LocationName parent) - *
    • createKeyRing(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createKeyRingCallable() - *
    - *
    GetKeyRing

    Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getKeyRing(GetKeyRingRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getKeyRing(KeyRingName name) - *
    • getKeyRing(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getKeyRingCallable() - *
    - *
    ListLocations

    Lists information about the supported locations for this service.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listLocations(ListLocationsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listLocationsPagedCallable() - *
    • listLocationsCallable() - *
    - *
    CreateCryptoKey

    Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a - * [KeyRing][google.cloud.kms.v1.KeyRing]. - * - * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] and - * [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm] - * are required.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createCryptoKey(CreateCryptoKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createCryptoKey(KeyRingName parent) - *
    • createCryptoKey(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createCryptoKeyCallable() - *
    - *
    CreateCryptoKeyVersion

    Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a - * [CryptoKey][google.cloud.kms.v1.CryptoKey]. - * - * The server will assign the next sequential id. If unset, - * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to - * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createCryptoKeyVersion(CreateCryptoKeyVersionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createCryptoKeyVersion(CryptoKeyName parent) - *
    • createCryptoKeyVersion(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createCryptoKeyVersionCallable() - *
    - *
    UpdateCryptoKeyPrimaryVersion

    Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that - * will be used in - * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. - * - * Returns an error if called on an asymmetric key.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateCryptoKeyPrimaryVersion(CryptoKeyName name) - *
    • updateCryptoKeyPrimaryVersion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateCryptoKeyPrimaryVersionCallable() - *
    - *
    DestroyCryptoKeyVersion

    Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for - * destruction. - * - * Upon calling this method, - * [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will - * be set to - * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] - * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will - * be set to a time 24 hours in the future, at which point the - * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be changed to - * [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], - * and the key material will be irrevocably destroyed. - * - * Before the - * [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is - * reached, - * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] - * may be called to reverse the process.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • destroyCryptoKeyVersion(CryptoKeyVersionName name) - *
    • destroyCryptoKeyVersion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • destroyCryptoKeyVersionCallable() - *
    - *
    GetIamPolicy

    Gets the access control policy for a resource. ADDED ONLY FOR MIXIN TESTS. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getIamPolicyCallable() - *
    - *
    GetCryptoKeyVersion

    Returns metadata for a given - * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getCryptoKeyVersion(CryptoKeyVersionName name) - *
    • getCryptoKeyVersion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getCryptoKeyVersionCallable() - *
    - *
    UpdateCryptoKeyVersion

    Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s - * metadata. - * - * [state][google.cloud.kms.v1.CryptoKeyVersion.state] may be changed between - * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] - * and - * [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] - * using this method. See - * [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] - * and - * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] - * to move between other states.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateCryptoKeyVersion(UpdateCryptoKeyVersionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateCryptoKeyVersionCallable() - *
    - *
    ListCryptoKeyVersions

    Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listCryptoKeyVersions(CryptoKeyName parent) - *
    • listCryptoKeyVersions(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listCryptoKeyVersionsPagedCallable() - *
    • listCryptoKeyVersionsCallable() - *
    - *
    AsymmetricSign

    Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] - * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] - * ASYMMETRIC_SIGN, producing a signature that can be verified with the public - * key retrieved from - * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • asymmetricSign(AsymmetricSignRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • asymmetricSign(CryptoKeyVersionName name) - *
    • asymmetricSign(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • asymmetricSignCallable() - *
    - *
    Encrypt

    Encrypts data, so that it can only be recovered by a call to - * [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. The - * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • encrypt(EncryptRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • encrypt(ResourceName name) - *
    • encrypt(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • encryptCallable() - *
    - *
    GetCryptoKey

    Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as - * well as its [primary][google.cloud.kms.v1.CryptoKey.primary] - * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getCryptoKey(GetCryptoKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getCryptoKey(CryptoKeyName name) - *
    • getCryptoKey(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getCryptoKeyCallable() - *
    - *
    RestoreCryptoKeyVersion

    Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the - * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] - * state. - * - * Upon restoration of the CryptoKeyVersion, - * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to - * [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED], - * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will - * be cleared.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • restoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • restoreCryptoKeyVersion(CryptoKeyVersionName name) - *
    • restoreCryptoKeyVersion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • restoreCryptoKeyVersionCallable() - *
    - *
    ListCryptoKeys

    Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listCryptoKeys(ListCryptoKeysRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listCryptoKeys(KeyRingName parent) - *
    • listCryptoKeys(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listCryptoKeysPagedCallable() - *
    • listCryptoKeysCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index c30e8e20c2..0796286c2e 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -80,231 +80,19 @@ *

    Note: close() needs to be called on the LibraryServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    ListShelves

    Lists shelves. The order is unspecified but deterministic. Newly created - * shelves will not necessarily be added to the end of this list.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listShelves(ListShelvesRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listShelvesPagedCallable() - *
    • listShelvesCallable() - *
    - *
    CreateShelf

    Creates a shelf, and returns the new Shelf.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createShelf(CreateShelfRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createShelf(Shelf shelf) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createShelfCallable() - *
    - *
    DeleteShelf

    Deletes a shelf. Returns NOT_FOUND if the shelf does not exist.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteShelf(DeleteShelfRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteShelf(ShelfName name) - *
    • deleteShelf(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteShelfCallable() - *
    - *
    MoveBook

    Moves a book to another shelf, and returns the new book. The book - * id of the new book may not be the same as the original book.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • moveBook(MoveBookRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • moveBook(BookName name) - *
    • moveBook(BookName name) - *
    • moveBook(String name) - *
    • moveBook(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • moveBookCallable() - *
    - *
    CreateBook

    Creates a book, and returns the new Book.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createBook(CreateBookRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createBook(ShelfName parent) - *
    • createBook(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createBookCallable() - *
    - *
    DeleteBook

    Deletes a book. Returns NOT_FOUND if the book does not exist.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteBook(DeleteBookRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteBook(BookName name) - *
    • deleteBook(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteBookCallable() - *
    - *
    UpdateBook

    Updates a book. Returns INVALID_ARGUMENT if the name of the book - * is non-empty and does not equal the existing name.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateBook(UpdateBookRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateBook(Book book) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateBookCallable() - *
    - *
    GetShelf

    Gets a shelf. Returns NOT_FOUND if the shelf does not exist.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getShelf(GetShelfRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getShelf(ShelfName name) - *
    • getShelf(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getShelfCallable() - *
    - *
    GetBook

    Gets a book. Returns NOT_FOUND if the book does not exist.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getBook(GetBookRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getBook(BookName name) - *
    • getBook(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getBookCallable() - *
    - *
    MergeShelves

    Merges two shelves by adding all books from the shelf named - * `other_shelf_name` to shelf `name`, and deletes - * `other_shelf_name`. Returns the updated shelf. - * The book ids of the moved books may not be the same as the original books. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * Returns NOT_FOUND if either shelf does not exist. - * This call is a no-op if the specified shelves are the same.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • mergeShelves(MergeShelvesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • mergeShelves(ShelfName name) - *
    • mergeShelves(ShelfName name) - *
    • mergeShelves(String name) - *
    • mergeShelves(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • mergeShelvesCallable() - *
    - *
    ListBooks

    Lists books in a shelf. The order is unspecified but deterministic. Newly - * created books will not necessarily be added to the end of this list. - * Returns NOT_FOUND if the shelf does not exist.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listBooks(ListBooksRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listBooks(ShelfName parent) - *
    • listBooks(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listBooksPagedCallable() - *
    • listBooksCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index 1133d11ac3..72aa8590aa 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -114,547 +114,19 @@ *

    Note: close() needs to be called on the ConfigClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    DeleteSink

    Deletes a sink. If the sink has a unique `writer_identity`, then that - * service account is also deleted.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteSink(DeleteSinkRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSink(LogSinkName sinkName) - *
    • deleteSink(String sinkName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteSinkCallable() - *
    - *
    UpdateView

    Updates a view on a log bucket. This method replaces the following fields - * in the existing view with values from the new view: `filter`. - * If an `UNAVAILABLE` error is returned, this indicates that system is not in - * a state where it can update the view. If this occurs, please try again in a - * few minutes.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateView(UpdateViewRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateViewCallable() - *
    - *
    UpdateCmekSettings

    Updates the Log Router CMEK settings for the given resource. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * Note: CMEK for the Log Router can currently only be configured for Google - * Cloud organizations. Once configured, it applies to all projects and - * folders in the Google Cloud organization. - * - * [UpdateCmekSettings][google.logging.v2.ConfigServiceV2.UpdateCmekSettings] - * will fail if 1) `kms_key_name` is invalid, or 2) the associated service - * account does not have the required - * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or - * 3) access to the key is disabled. - * - * See [Enabling CMEK for Log - * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateCmekSettings(UpdateCmekSettingsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateCmekSettingsCallable() - *
    - *
    GetView

    Gets a view on a log bucket..

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getView(GetViewRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getViewCallable() - *
    - *
    UndeleteBucket

    Undeletes a log bucket. A bucket that has been deleted can be undeleted - * within the grace period of 7 days.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • undeleteBucket(UndeleteBucketRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • undeleteBucketCallable() - *
    - *
    ListExclusions

    Lists all the exclusions on the _Default sink in a parent resource.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listExclusions(ListExclusionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listExclusions(BillingAccountName parent) - *
    • listExclusions(FolderName parent) - *
    • listExclusions(OrganizationName parent) - *
    • listExclusions(ProjectName parent) - *
    • listExclusions(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listExclusionsPagedCallable() - *
    • listExclusionsCallable() - *
    - *
    UpdateSettings

    Updates the Log Router settings for the given resource. - * - * Note: Settings for the Log Router can currently only be configured for - * Google Cloud organizations. Once configured, it applies to all projects and - * folders in the Google Cloud organization. - * - * [UpdateSettings][google.logging.v2.ConfigServiceV2.UpdateSettings] - * will fail if 1) `kms_key_name` is invalid, or 2) the associated service - * account does not have the required - * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or - * 3) access to the key is disabled. 4) `location_id` is not supported by - * Logging. 5) `location_id` violate OrgPolicy. - * - * See [Enabling CMEK for Log - * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateSettings(UpdateSettingsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateSettings(Settings settings) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateSettingsCallable() - *
    - *
    CreateView

    Creates a view over log entries in a log bucket. A bucket may contain a - * maximum of 30 views.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createView(CreateViewRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createViewCallable() - *
    - *
    DeleteView

    Deletes a view on a log bucket. - * If an `UNAVAILABLE` error is returned, this indicates that system is not in - * a state where it can delete the view. If this occurs, please try again in a - * few minutes.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteView(DeleteViewRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteViewCallable() - *
    - *
    UpdateExclusion

    Changes one or more properties of an existing exclusion in the _Default - * sink.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateExclusion(UpdateExclusionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateExclusion(LogExclusionName name) - *
    • updateExclusion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateExclusionCallable() - *
    - *
    GetSink

    Gets a sink.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getSink(GetSinkRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getSink(LogSinkName sinkName) - *
    • getSink(String sinkName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getSinkCallable() - *
    - *
    CreateExclusion

    Creates a new exclusion in the _Default sink in a specified parent - * resource. Only log entries belonging to that resource can be excluded. You - * can have up to 10 exclusions in a resource.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createExclusion(CreateExclusionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createExclusion(BillingAccountName parent) - *
    • createExclusion(FolderName parent) - *
    • createExclusion(OrganizationName parent) - *
    • createExclusion(ProjectName parent) - *
    • createExclusion(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createExclusionCallable() - *
    - *
    DeleteBucket

    Deletes a log bucket. - * - * Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state. - * After 7 days, the bucket will be purged and all log entries in the bucket - * will be permanently deleted.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteBucket(DeleteBucketRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteBucketCallable() - *
    - *
    ListBuckets

    Lists log buckets.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listBuckets(ListBucketsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listBuckets(BillingAccountLocationName parent) - *
    • listBuckets(FolderLocationName parent) - *
    • listBuckets(LocationName parent) - *
    • listBuckets(OrganizationLocationName parent) - *
    • listBuckets(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listBucketsPagedCallable() - *
    • listBucketsCallable() - *
    - *
    GetCmekSettings

    Gets the Logging CMEK settings for the given resource. - * - * Note: CMEK for the Log Router can be configured for Google Cloud projects, - * folders, organizations and billing accounts. Once configured for an - * organization, it applies to all projects and folders in the Google Cloud - * organization. - * - * See [Enabling CMEK for Log - * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getCmekSettings(GetCmekSettingsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getCmekSettingsCallable() - *
    - *
    CreateSink

    Creates a sink that exports specified log entries to a destination. The - * export of newly-ingested log entries begins immediately, unless the sink's - * `writer_identity` is not permitted to write to the destination. A sink can - * export log entries only from the resource owning the sink.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createSink(CreateSinkRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createSink(BillingAccountName parent) - *
    • createSink(FolderName parent) - *
    • createSink(OrganizationName parent) - *
    • createSink(ProjectName parent) - *
    • createSink(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createSinkCallable() - *
    - *
    GetBucket

    Gets a log bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getBucket(GetBucketRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getBucketCallable() - *
    - *
    ListViews

    Lists views on a log bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listViews(ListViewsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listViews(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listViewsPagedCallable() - *
    • listViewsCallable() - *
    - *
    ListSinks

    Lists sinks.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listSinks(ListSinksRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSinks(BillingAccountName parent) - *
    • listSinks(FolderName parent) - *
    • listSinks(OrganizationName parent) - *
    • listSinks(ProjectName parent) - *
    • listSinks(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listSinksPagedCallable() - *
    • listSinksCallable() - *
    - *
    UpdateSink

    Updates a sink. This method replaces the following fields in the existing - * sink with values from the new sink: `destination`, and `filter`. - * - * The updated sink might also have a new `writer_identity`; see the - * `unique_writer_identity` field.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateSink(UpdateSinkRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateSink(LogSinkName sinkName) - *
    • updateSink(String sinkName) - *
    • updateSink(LogSinkName sinkName) - *
    • updateSink(String sinkName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateSinkCallable() - *
    - *
    UpdateBucket

    Updates a log bucket. This method replaces the following fields in the - * existing bucket with values from the new bucket: `retention_period` - * - * If the retention period is decreased and the bucket is locked, - * `FAILED_PRECONDITION` will be returned. - * - * If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then - * `FAILED_PRECONDITION` will be returned. - * - * After a bucket has been created, the bucket's location cannot be changed.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateBucket(UpdateBucketRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateBucketCallable() - *
    - *
    GetExclusion

    Gets the description of an exclusion in the _Default sink.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getExclusion(GetExclusionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getExclusion(LogExclusionName name) - *
    • getExclusion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getExclusionCallable() - *
    - *
    DeleteExclusion

    Deletes an exclusion in the _Default sink.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteExclusion(DeleteExclusionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteExclusion(LogExclusionName name) - *
    • deleteExclusion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteExclusionCallable() - *
    - *
    CopyLogEntries

    Copies a set of log entries from a log bucket to a Cloud Storage bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • copyLogEntriesAsync(CopyLogEntriesRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • copyLogEntriesOperationCallable() - *
    • copyLogEntriesCallable() - *
    - *
    CreateBucket

    Creates a log bucket that can be used to store log entries. After a bucket - * has been created, the bucket's location cannot be changed.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createBucket(CreateBucketRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createBucketCallable() - *
    - *
    GetSettings

    Gets the Log Router settings for the given resource. - * - * Note: Settings for the Log Router can be get for Google Cloud projects, - * folders, organizations and billing accounts. Currently it can only be - * configured for organizations. Once configured for an organization, it - * applies to all projects and folders in the Google Cloud organization. - * - * See [Enabling CMEK for Log - * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getSettings(GetSettingsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getSettings(SettingsName name) - *
    • getSettings(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getSettingsCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index 3d8c229fe5..642d2947a5 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -76,131 +76,19 @@ *

    Note: close() needs to be called on the LoggingClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    WriteLogEntries

    Writes log entries to Logging. This API method is the - * only way to send log entries to Logging. This method - * is used, directly or indirectly, by the Logging agent - * (fluentd) and all logging libraries configured to use Logging. - * A single request may contain log entries for a maximum of 1000 - * different resources (projects, organizations, billing accounts or - * folders)

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • writeLogEntries(WriteLogEntriesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • writeLogEntries(LogName logName) - *
    • writeLogEntries(String logName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • writeLogEntriesCallable() - *
    - *
    ListMonitoredResourceDescriptors

    Lists the descriptors for monitored resource types used by Logging.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listMonitoredResourceDescriptorsPagedCallable() - *
    • listMonitoredResourceDescriptorsCallable() - *
    - *
    ListLogs

    Lists the logs in projects, organizations, folders, or billing accounts. - * Only logs that have entries are listed.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listLogs(ListLogsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listLogs(BillingAccountName parent) - *
    • listLogs(FolderName parent) - *
    • listLogs(OrganizationName parent) - *
    • listLogs(ProjectName parent) - *
    • listLogs(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listLogsPagedCallable() - *
    • listLogsCallable() - *
    - *
    DeleteLog

    Deletes all the log entries in a log for the _Default Log Bucket. The log - * reappears if it receives new entries. Log entries written shortly before - * the delete operation might not be deleted. Entries received after the - * delete operation with a timestamp before the operation will be deleted.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteLog(DeleteLogRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteLog(LogName logName) - *
    • deleteLog(String logName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteLogCallable() - *
    - *
    ListLogEntries

    Lists log entries. Use this method to retrieve log entries that originated - * from a project/folder/organization/billing account. For ways to export log - * entries, see [Exporting - * Logs](https://cloud.google.com/logging/docs/export).

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listLogEntries(ListLogEntriesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listLogEntries(List resourceNames) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listLogEntriesPagedCallable() - *
    • listLogEntriesCallable() - *
    - *
    TailLogEntries

    Streaming read of log entries as they are ingested. Until the stream is - * terminated, it will continue reading logs.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • tailLogEntriesCallable() - *
    - *
    + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index a8eb81defe..a0306451a1 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -64,108 +64,19 @@ *

    Note: close() needs to be called on the MetricsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    UpdateLogMetric

    Creates or updates a logs-based metric.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateLogMetric(UpdateLogMetricRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateLogMetric(LogMetricName metricName) - *
    • updateLogMetric(String metricName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateLogMetricCallable() - *
    - *
    CreateLogMetric

    Creates a logs-based metric.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createLogMetric(CreateLogMetricRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createLogMetric(ProjectName parent) - *
    • createLogMetric(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createLogMetricCallable() - *
    - *
    GetLogMetric

    Gets a logs-based metric.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getLogMetric(GetLogMetricRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getLogMetric(LogMetricName metricName) - *
    • getLogMetric(String metricName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getLogMetricCallable() - *
    - *
    DeleteLogMetric

    Deletes a logs-based metric.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteLogMetric(DeleteLogMetricRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteLogMetric(LogMetricName metricName) - *
    • deleteLogMetric(String metricName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteLogMetricCallable() - *
    - *
    ListLogMetrics

    Lists logs-based metrics.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listLogMetrics(ListLogMetricsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listLogMetrics(ProjectName parent) - *
    • listLogMetrics(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listLogMetricsPagedCallable() - *
    • listLogMetricsCallable() - *
    - *
    + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: + * + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index 471490b25a..fd82725ee7 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -79,252 +79,19 @@ *

    Note: close() needs to be called on the SchemaServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    DeleteSchema

    Deletes a schema.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteSchema(DeleteSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSchema(SchemaName name) - *
    • deleteSchema(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteSchemaCallable() - *
    - *
    GetIamPolicy

    Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getIamPolicyCallable() - *
    - *
    ListSchemaRevisions

    Lists all schema revisions for the named schema.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listSchemaRevisions(ListSchemaRevisionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSchemaRevisions(SchemaName name) - *
    • listSchemaRevisions(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listSchemaRevisionsPagedCallable() - *
    • listSchemaRevisionsCallable() - *
    - *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces - * any existing policy. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • setIamPolicy(SetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • setIamPolicyCallable() - *
    - *
    RollbackSchema

    Creates a new schema revision that is a copy of the provided revision_id.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • rollbackSchema(RollbackSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • rollbackSchema(SchemaName name) - *
    • rollbackSchema(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • rollbackSchemaCallable() - *
    - *
    DeleteSchemaRevision

    Deletes a specific schema revision.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteSchemaRevision(DeleteSchemaRevisionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSchemaRevision(SchemaName name) - *
    • deleteSchemaRevision(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteSchemaRevisionCallable() - *
    - *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. If the - * resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building - * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() - *
    - *
    ValidateMessage

    Validates a message against a schema.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • validateMessage(ValidateMessageRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • validateMessageCallable() - *
    - *
    CreateSchema

    Creates a schema.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createSchema(CreateSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createSchema(ProjectName parent) - *
    • createSchema(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createSchemaCallable() - *
    - *
    ListSchemas

    Lists schemas in a project.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listSchemas(ListSchemasRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSchemas(ProjectName parent) - *
    • listSchemas(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listSchemasPagedCallable() - *
    • listSchemasCallable() - *
    - *
    CommitSchema

    Commits a new schema revision to an existing schema.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • commitSchema(CommitSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • commitSchema(SchemaName name) - *
    • commitSchema(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • commitSchemaCallable() - *
    - *
    GetSchema

    Gets a schema.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getSchema(GetSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getSchema(SchemaName name) - *
    • getSchema(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getSchemaCallable() - *
    - *
    ValidateSchema

    Validates a schema.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • validateSchema(ValidateSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • validateSchema(ProjectName parent) - *
    • validateSchema(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • validateSchemaCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 84431a78b4..87b846e1c8 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -95,433 +95,19 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    Pull

    Pulls messages from the server. The server may return `UNAVAILABLE` if - * there are too many concurrent pull requests pending for the given - * subscription.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • pull(PullRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • pull(SubscriptionName subscription) - *
    • pull(String subscription) - *
    • pull(SubscriptionName subscription) - *
    • pull(String subscription) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • pullCallable() - *
    - *
    GetSnapshot

    Gets the configuration details of a snapshot. Snapshots are used in - * Seek - * operations, which allow you to manage message acknowledgments in bulk. That - * is, you can set the acknowledgment state of messages in an existing - * subscription to the state captured by a snapshot.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getSnapshot(GetSnapshotRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getSnapshot(SnapshotName snapshot) - *
    • getSnapshot(String snapshot) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getSnapshotCallable() - *
    - *
    Acknowledge

    Acknowledges the messages associated with the `ack_ids` in the - * `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages - * from the subscription. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * Acknowledging a message whose ack deadline has expired may succeed, - * but such a message may be redelivered later. Acknowledging a message more - * than once will not result in an error.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • acknowledge(AcknowledgeRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • acknowledge(SubscriptionName subscription) - *
    • acknowledge(String subscription) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • acknowledgeCallable() - *
    - *
    ModifyAckDeadline

    Modifies the ack deadline for a specific message. This method is useful - * to indicate that more time is needed to process a message by the - * subscriber, or to make the message available for redelivery if the - * processing was interrupted. Note that this does not modify the - * subscription-level `ackDeadlineSeconds` used for subsequent messages.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • modifyAckDeadline(ModifyAckDeadlineRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • modifyAckDeadline(SubscriptionName subscription) - *
    • modifyAckDeadline(String subscription) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • modifyAckDeadlineCallable() - *
    - *
    ModifyPushConfig

    Modifies the `PushConfig` for a specified subscription. - * - * This may be used to change a push subscription to a pull one (signified by - * an empty `PushConfig`) or vice versa, or change the endpoint URL and other - * attributes of a push subscription. Messages will accumulate for delivery - * continuously through the call regardless of changes to the `PushConfig`.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • modifyPushConfig(ModifyPushConfigRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • modifyPushConfig(SubscriptionName subscription) - *
    • modifyPushConfig(String subscription) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • modifyPushConfigCallable() - *
    - *
    GetIamPolicy

    Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getIamPolicyCallable() - *
    - *
    GetSubscription

    Gets the configuration details of a subscription.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getSubscription(GetSubscriptionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getSubscription(SubscriptionName subscription) - *
    • getSubscription(String subscription) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getSubscriptionCallable() - *
    - *
    StreamingPull

    Establishes a stream with the server, which sends messages down to the - * client. The client streams acknowledgements and ack deadline modifications - * back to the server. The server will close the stream and return the status - * on any error. The server may close the stream with status `UNAVAILABLE` to - * reassign server-side resources, in which case, the client should - * re-establish the stream. Flow control can be achieved by configuring the - * underlying RPC channel.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • streamingPullCallable() - *
    - *
    ListSnapshots

    Lists the existing snapshots. Snapshots are used in [Seek]( - * https://cloud.google.com/pubsub/docs/replay-overview) operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set - * the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listSnapshots(ListSnapshotsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSnapshots(ProjectName project) - *
    • listSnapshots(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listSnapshotsPagedCallable() - *
    • listSnapshotsCallable() - *
    - *
    CreateSubscription

    Creates a subscription to a given topic. See the [resource name rules] - * (https://cloud.google.com/pubsub/docs/admin#resource_names). - * If the subscription already exists, returns `ALREADY_EXISTS`. - * If the corresponding topic doesn't exist, returns `NOT_FOUND`. - * - * If the name is not provided in the request, the server will assign a random - * name for this subscription on the same project as the topic, conforming - * to the [resource name format] - * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated - * name is populated in the returned Subscription object. Note that for REST - * API requests, you must specify a name in the request.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createSubscription(Subscription request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createSubscription(SubscriptionName name) - *
    • createSubscription(SubscriptionName name) - *
    • createSubscription(String name) - *
    • createSubscription(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createSubscriptionCallable() - *
    - *
    DeleteSnapshot

    Removes an existing snapshot. Snapshots are used in [Seek] - * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set - * the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. - * When the snapshot is deleted, all messages retained in the snapshot - * are immediately dropped. After a snapshot is deleted, a new one may be - * created with the same name, but the new one has no association with the old - * snapshot or its subscription, unless the same subscription is specified.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteSnapshot(DeleteSnapshotRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSnapshot(SnapshotName snapshot) - *
    • deleteSnapshot(String snapshot) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteSnapshotCallable() - *
    - *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces - * any existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • setIamPolicy(SetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • setIamPolicyCallable() - *
    - *
    UpdateSnapshot

    Updates an existing snapshot. Snapshots are used in - * Seek - * operations, which allow - * you to manage message acknowledgments in bulk. That is, you can set the - * acknowledgment state of messages in an existing subscription to the state - * captured by a snapshot.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateSnapshot(UpdateSnapshotRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateSnapshotCallable() - *
    - *
    UpdateSubscription

    Updates an existing subscription. Note that certain properties of a - * subscription, such as its topic, are not modifiable.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateSubscription(UpdateSubscriptionRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateSubscriptionCallable() - *
    - *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. If the - * resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building - * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() - *
    - *
    DeleteSubscription

    Deletes an existing subscription. All messages retained in the subscription - * are immediately dropped. Calls to `Pull` after deletion will return - * `NOT_FOUND`. After a subscription is deleted, a new one may be created with - * the same name, but the new one has no association with the old - * subscription or its topic unless the same topic is specified.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteSubscription(DeleteSubscriptionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSubscription(SubscriptionName subscription) - *
    • deleteSubscription(String subscription) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteSubscriptionCallable() - *
    - *
    ListSubscriptions

    Lists matching subscriptions.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listSubscriptions(ListSubscriptionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSubscriptions(ProjectName project) - *
    • listSubscriptions(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listSubscriptionsPagedCallable() - *
    • listSubscriptionsCallable() - *
    - *
    CreateSnapshot

    Creates a snapshot from the requested subscription. Snapshots are used in - * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, - * which allow you to manage message acknowledgments in bulk. That is, you can - * set the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. - * If the snapshot already exists, returns `ALREADY_EXISTS`. - * If the requested subscription doesn't exist, returns `NOT_FOUND`. - * If the backlog in the subscription is too old -- and the resulting snapshot - * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. - * See also the `Snapshot.expire_time` field. If the name is not provided in - * the request, the server will assign a random - * name for this snapshot on the same project as the subscription, conforming - * to the [resource name format] - * (https://cloud.google.com/pubsub/docs/admin#resource_names). The - * generated name is populated in the returned Snapshot object. Note that for - * REST API requests, you must specify a name in the request.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createSnapshot(CreateSnapshotRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createSnapshot(SnapshotName name) - *
    • createSnapshot(SnapshotName name) - *
    • createSnapshot(String name) - *
    • createSnapshot(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createSnapshotCallable() - *
    - *
    Seek

    Seeks an existing subscription to a point in time or to a given snapshot, - * whichever is provided in the request. Snapshots are used in [Seek] - * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set - * the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. Note that both the subscription and the - * snapshot must be on the same topic.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • seek(SeekRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • seekCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index ba7ab18b97..bb74a760d4 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -78,243 +78,19 @@ *

    Note: close() needs to be called on the TopicAdminClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    ListTopicSubscriptions

    Lists the names of the attached subscriptions on this topic.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listTopicSubscriptions(ListTopicSubscriptionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listTopicSubscriptions(TopicName topic) - *
    • listTopicSubscriptions(String topic) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listTopicSubscriptionsPagedCallable() - *
    • listTopicSubscriptionsCallable() - *
    - *
    DetachSubscription

    Detaches a subscription from this topic. All messages retained in the - * subscription are dropped. Subsequent `Pull` and `StreamingPull` requests - * will return FAILED_PRECONDITION. If the subscription is a push - * subscription, pushes to the endpoint will stop.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • detachSubscription(DetachSubscriptionRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • detachSubscriptionCallable() - *
    - *
    CreateTopic

    Creates the given topic with the given name. See the [resource name rules] - * (https://cloud.google.com/pubsub/docs/admin#resource_names).

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createTopic(Topic request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createTopic(TopicName name) - *
    • createTopic(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createTopicCallable() - *
    - *
    ListTopics

    Lists matching topics.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listTopics(ListTopicsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listTopics(ProjectName project) - *
    • listTopics(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listTopicsPagedCallable() - *
    • listTopicsCallable() - *
    - *
    GetTopic

    Gets the configuration of a topic.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getTopic(GetTopicRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getTopic(TopicName topic) - *
    • getTopic(String topic) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getTopicCallable() - *
    - *
    GetIamPolicy

    Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getIamPolicyCallable() - *
    - *
    UpdateTopic

    Updates an existing topic. Note that certain properties of a - * topic are not modifiable.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateTopic(UpdateTopicRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateTopicCallable() - *
    - *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. If the - * resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * Note: This operation is designed to be used for building - * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() - *
    - *
    DeleteTopic

    Deletes the topic with the given name. Returns `NOT_FOUND` if the topic - * does not exist. After a topic is deleted, a new topic may be created with - * the same name; this is an entirely new topic with none of the old - * configuration or subscriptions. Existing subscriptions to this topic are - * not deleted, but their `topic` field is set to `_deleted-topic_`.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteTopic(DeleteTopicRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteTopic(TopicName topic) - *
    • deleteTopic(String topic) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteTopicCallable() - *
    - *
    ListTopicSnapshots

    Lists the names of the snapshots on this topic. Snapshots are used in - * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, - * which allow you to manage message acknowledgments in bulk. That is, you can - * set the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listTopicSnapshots(ListTopicSnapshotsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listTopicSnapshots(TopicName topic) - *
    • listTopicSnapshots(String topic) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listTopicSnapshotsPagedCallable() - *
    • listTopicSnapshotsCallable() - *
    - *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces - * any existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • setIamPolicy(SetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • setIamPolicyCallable() - *
    - *
    Publish

    Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic - * does not exist.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • publish(PublishRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • publish(TopicName topic) - *
    • publish(String topic) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • publishCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index 2b5c7631a1..fb9a41852b 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -82,268 +82,19 @@ *

    Note: close() needs to be called on the CloudRedisClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    GetInstance

    Gets the details of a specific Redis instance.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getInstance(GetInstanceRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getInstance(InstanceName name) - *
    • getInstance(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getInstanceCallable() - *
    - *
    ExportInstance

    Export Redis instance data into a Redis RDB format file in Cloud Storage. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * Redis will continue serving during this operation. - * - * The returned operation is automatically deleted after a few hours, so - * there is no need to call DeleteOperation.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • exportInstanceAsync(ExportInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • exportInstanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • exportInstanceOperationCallable() - *
    • exportInstanceCallable() - *
    - *
    ListInstances

    Lists all Redis instances owned by a project in either the specified - * location (region) or all locations. - * - * The location should have the following format: - * - * * `projects/{project_id}/locations/{location_id}` - * - * If `location_id` is specified as `-` (wildcard), then all regions - * available to the project are queried, and the results are aggregated.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listInstances(ListInstancesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listInstances(LocationName parent) - *
    • listInstances(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listInstancesPagedCallable() - *
    • listInstancesCallable() - *
    - *
    UpdateInstance

    Updates the metadata and configuration of a specific Redis instance. - * - * Completed longrunning.Operation will contain the new instance object - * in the response field. The returned operation is automatically deleted - * after a few hours, so there is no need to call DeleteOperation.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateInstanceAsync(UpdateInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • updateInstanceAsync(FieldMask updateMask) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateInstanceOperationCallable() - *
    • updateInstanceCallable() - *
    - *
    GetInstanceAuthString

    Gets the AUTH string for a Redis instance. If AUTH is not enabled for the - * instance the response will be empty. This information is not included in - * the details returned to GetInstance.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getInstanceAuthString(GetInstanceAuthStringRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getInstanceAuthString(InstanceName name) - *
    • getInstanceAuthString(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getInstanceAuthStringCallable() - *
    - *
    RescheduleMaintenance

    Reschedule maintenance for a given instance in a given project and - * location.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • rescheduleMaintenanceAsync(InstanceName name) - *
    • rescheduleMaintenanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • rescheduleMaintenanceOperationCallable() - *
    • rescheduleMaintenanceCallable() - *
    - *
    CreateInstance

    Creates a Redis instance based on the specified tier and memory size. - * - * By default, the instance is accessible from the project's - * [default network](https://cloud.google.com/vpc/docs/vpc). - * - * The creation is executed asynchronously and callers may check the returned - * operation to track its progress. Once the operation is completed the Redis - * instance will be fully functional. The completed longrunning.Operation will - * contain the new instance object in the response field. - * - * The returned operation is automatically deleted after a few hours, so there - * is no need to call DeleteOperation.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createInstanceAsync(CreateInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • createInstanceAsync(LocationName parent) - *
    • createInstanceAsync(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createInstanceOperationCallable() - *
    • createInstanceCallable() - *
    - *
    ImportInstance

    Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. - * - * Redis may stop serving during this operation. Instance state will be - * IMPORTING for entire operation. When complete, the instance will contain - * only data from the imported file. - * - * The returned operation is automatically deleted after a few hours, so - * there is no need to call DeleteOperation.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • importInstanceAsync(ImportInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • importInstanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • importInstanceOperationCallable() - *
    • importInstanceCallable() - *
    - *
    FailoverInstance

    Initiates a failover of the primary node to current replica node for a - * specific STANDARD tier Cloud Memorystore for Redis instance.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • failoverInstanceAsync(FailoverInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • failoverInstanceAsync(InstanceName name) - *
    • failoverInstanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • failoverInstanceOperationCallable() - *
    • failoverInstanceCallable() - *
    - *
    UpgradeInstance

    Upgrades Redis instance to the newer Redis version specified in the - * request.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • upgradeInstanceAsync(UpgradeInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • upgradeInstanceAsync(InstanceName name) - *
    • upgradeInstanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • upgradeInstanceOperationCallable() - *
    • upgradeInstanceCallable() - *
    - *
    DeleteInstance

    Deletes a specific Redis instance. Instance stops serving and data is - * deleted.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteInstanceAsync(DeleteInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • deleteInstanceAsync(InstanceName name) - *
    • deleteInstanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteInstanceOperationCallable() - *
    • deleteInstanceCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index 1377677719..650dafb7a8 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -78,630 +78,19 @@ *

    Note: close() needs to be called on the StorageClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
    MethodDescriptionMethod Variants
    DeleteNotification

    Permanently deletes a notification subscription.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteNotification(DeleteNotificationRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteNotification(NotificationName name) - *
    • deleteNotification(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteNotificationCallable() - *
    - *
    DeleteObject

    Deletes an object and its metadata. Deletions are permanent if versioning - * is not enabled for the bucket, or if the `generation` parameter is used.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteObject(DeleteObjectRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteObject(String bucket) - *
    • deleteObject(String bucket) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteObjectCallable() - *
    - *
    StartResumableWrite

    Starts a resumable write. How long the write operation remains valid, and - * what happens when the write operation becomes invalid, are - * service-dependent.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • startResumableWrite(StartResumableWriteRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • startResumableWriteCallable() - *
    - *
    SetIamPolicy

    Updates an IAM policy for the specified bucket or object. - * The `resource` field in the request should be - * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • setIamPolicy(SetIamPolicyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • setIamPolicy(ResourceName resource) - *
    • setIamPolicy(String resource) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • setIamPolicyCallable() - *
    - *
    ListNotifications

    Retrieves a list of notification subscriptions for a given bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listNotifications(ListNotificationsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listNotifications(ProjectName parent) - *
    • listNotifications(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listNotificationsPagedCallable() - *
    • listNotificationsCallable() - *
    - *
    UpdateHmacKey

    Updates a given HMAC key state between ACTIVE and INACTIVE.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateHmacKey(UpdateHmacKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateHmacKey(HmacKeyMetadata hmacKey) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateHmacKeyCallable() - *
    - *
    GetHmacKey

    Gets an existing HMAC key metadata for the given id.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getHmacKey(GetHmacKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getHmacKey(String accessId) - *
    • getHmacKey(String accessId) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getHmacKeyCallable() - *
    - *
    DeleteBucket

    Permanently deletes an empty bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteBucket(DeleteBucketRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteBucket(BucketName name) - *
    • deleteBucket(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteBucketCallable() - *
    - *
    TestIamPermissions

    Tests a set of permissions on the given bucket or object to see which, if - * any, are held by the caller. - * The `resource` field in the request should be - * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • testIamPermissions(ResourceName resource) - *
    • testIamPermissions(String resource) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() - *
    - *
    ListBuckets

    Retrieves a list of buckets for a given project.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listBuckets(ListBucketsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listBuckets(ProjectName parent) - *
    • listBuckets(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listBucketsPagedCallable() - *
    • listBucketsCallable() - *
    - *
    DeleteHmacKey

    Deletes a given HMAC key. Key must be in an INACTIVE state.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteHmacKey(DeleteHmacKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteHmacKey(String accessId) - *
    • deleteHmacKey(String accessId) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteHmacKeyCallable() - *
    - *
    ListHmacKeys

    Lists HMAC keys under a given project with the additional filters provided.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listHmacKeys(ListHmacKeysRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listHmacKeys(ProjectName project) - *
    • listHmacKeys(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listHmacKeysPagedCallable() - *
    • listHmacKeysCallable() - *
    - *
    GetObject

    Retrieves an object's metadata.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getObject(GetObjectRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getObject(String bucket) - *
    • getObject(String bucket) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getObjectCallable() - *
    - *
    CreateNotification

    Creates a notification subscription for a given bucket. - * These notifications, when triggered, publish messages to the specified - * Pub/Sub topics. - * See https://cloud.google.com/storage/docs/pubsub-notifications.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createNotification(CreateNotificationRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createNotification(ProjectName parent) - *
    • createNotification(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createNotificationCallable() - *
    - *
    WriteObject

    Stores a new object and metadata. + *

    The surface of this class includes several types of Java methods for each of the API's + * methods: * - * An object can be written either in a single message stream or in a - * resumable sequence of message streams. To write using a single stream, - * the client should include in the first message of the stream an - * `WriteObjectSpec` describing the destination bucket, object, and any - * preconditions. Additionally, the final message must set 'finish_write' to - * true, or else it is an error. - * - * For a resumable write, the client should instead call - * `StartResumableWrite()`, populating a `WriteObjectSpec` into that request. - * They should then attach the returned `upload_id` to the first message of - * each following call to `WriteObject`. If the stream is closed before - * finishing the upload (either explicitly by the client or due to a network - * error or an error response from the server), the client should do as - * follows: - * - Check the result Status of the stream, to determine if writing can be - * resumed on this stream or must be restarted from scratch (by calling - * `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED, - * INTERNAL, and UNAVAILABLE. For each case, the client should use binary - * exponential backoff before retrying. Additionally, writes can be - * resumed after RESOURCE_EXHAUSTED errors, but only after taking - * appropriate measures, which may include reducing aggregate send rate - * across clients and/or requesting a quota increase for your project. - * - If the call to `WriteObject` returns `ABORTED`, that indicates - * concurrent attempts to update the resumable write, caused either by - * multiple racing clients or by a single client where the previous - * request was timed out on the client side but nonetheless reached the - * server. In this case the client should take steps to prevent further - * concurrent writes (e.g., increase the timeouts, stop using more than - * one process to perform the upload, etc.), and then should follow the - * steps below for resuming the upload. - * - For resumable errors, the client should call `QueryWriteStatus()` and - * then continue writing from the returned `persisted_size`. This may be - * less than the amount of data the client previously sent. Note also that - * it is acceptable to send data starting at an offset earlier than the - * returned `persisted_size`; in this case, the service will skip data at - * offsets that were already persisted (without checking that it matches - * the previously written data), and write only the data starting from the - * persisted offset. This behavior can make client-side handling simpler - * in some cases. - * - * The service will not view the object as complete until the client has - * sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any - * requests on a stream after sending a request with `finish_write` set to - * `true` will cause an error. The client **should** check the response it - * receives to determine how much data the service was able to commit and - * whether the service views the object as complete. - * - * Attempting to resume an already finalized object will result in an OK - * status, with a WriteObjectResponse containing the finalized object's - * metadata.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • writeObjectCallable() - *
    - *
    GetServiceAccount

    Retrieves the name of a project's Google Cloud Storage service account.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getServiceAccount(GetServiceAccountRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getServiceAccount(ProjectName project) - *
    • getServiceAccount(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getServiceAccountCallable() - *
    - *
    ListObjects

    Retrieves a list of objects matching the criteria.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listObjects(ListObjectsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listObjects(ProjectName parent) - *
    • listObjects(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listObjectsPagedCallable() - *
    • listObjectsCallable() - *
    - *
    GetBucket

    Returns metadata for the specified bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getBucket(GetBucketRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getBucket(BucketName name) - *
    • getBucket(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getBucketCallable() - *
    - *
    UpdateObject

    Updates an object's metadata. - * Equivalent to JSON API's storage.objects.patch.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateObject(UpdateObjectRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateObject(Object object) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateObjectCallable() - *
    - *
    GetIamPolicy

    Gets the IAM policy for a specified bucket or object. - * The `resource` field in the request should be - * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getIamPolicy(ResourceName resource) - *
    • getIamPolicy(String resource) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getIamPolicyCallable() - *
    - *
    QueryWriteStatus

    Determines the `persisted_size` for an object that is being written, which - * can then be used as the `write_offset` for the next `Write()` call. - * - * If the object does not exist (i.e., the object has been deleted, or the - * first `Write()` has not yet reached the service), this method returns the - * error `NOT_FOUND`. - * - * The client **may** call `QueryWriteStatus()` at any time to determine how - * much data has been processed for this object. This is useful if the - * client is buffering data and needs to know which data can be safely - * evicted. For any sequence of `QueryWriteStatus()` calls for a given - * object name, the sequence of returned `persisted_size` values will be - * non-decreasing.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • queryWriteStatus(QueryWriteStatusRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • queryWriteStatus(String uploadId) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • queryWriteStatusCallable() - *
    - *
    RewriteObject

    Rewrites a source object to a destination object. Optionally overrides - * metadata.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • rewriteObject(RewriteObjectRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • rewriteObjectCallable() - *
    - *
    LockBucketRetentionPolicy

    Locks retention policy on a bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • lockBucketRetentionPolicy(BucketName bucket) - *
    • lockBucketRetentionPolicy(String bucket) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • lockBucketRetentionPolicyCallable() - *
    - *
    CreateHmacKey

    Creates a new HMAC key for the given service account.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createHmacKey(CreateHmacKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createHmacKey(ProjectName project) - *
    • createHmacKey(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createHmacKeyCallable() - *
    - *
    ComposeObject

    Concatenates a list of existing objects into a new object in the same - * bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • composeObject(ComposeObjectRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • composeObjectCallable() - *
    - *
    CancelResumableWrite

    Cancels an in-progress resumable upload.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • cancelResumableWrite(CancelResumableWriteRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • cancelResumableWrite(String uploadId) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • cancelResumableWriteCallable() - *
    - *
    UpdateBucket

    Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateBucket(UpdateBucketRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateBucket(Bucket bucket) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateBucketCallable() - *
    - *
    ReadObject

    Reads an object's data.

    		 - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • readObjectCallable() - *
    - *
    CreateBucket

    Creates a new bucket.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createBucket(CreateBucketRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createBucket(ProjectName parent) - *
    • createBucket(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createBucketCallable() - *
    - *
    GetNotification

    View a notification config.

    		 - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getNotification(GetNotificationRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getNotification(BucketName name) - *
    • getNotification(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getNotificationCallable() - *
    - *
    + *

      + *
    1. A "flattened" method. With this type of method, the fields of the request type have been + * converted into function parameters. It may be the case that not all fields are available as + * parameters, and not every API method will have a flattened method entry point. + *
    2. A "request object" method. This type of method only takes one parameter, a request object, + * which must be constructed before the call. Not every API method will have a request object + * method. + *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API + * callable object, which can be used to initiate calls to the service. + *
    * *

    See the individual methods for example code. * From c2c5914a285bb096b856a34a6daaae64a30434db Mon Sep 17 00:00:00 2001 From: Alice Li Date: Thu, 9 Nov 2023 17:02:11 -0500 Subject: [PATCH 09/21] adding back in cache --- .github/workflows/ci.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index dadad974b9..4b86e4b5d3 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -59,7 +59,7 @@ jobs: with: java-version: 8 distribution: temurin -# cache: maven + cache: maven - run: echo "JAVA8_HOME=${JAVA_HOME}" >> $GITHUB_ENV - uses: actions/setup-java@v3 with: @@ -86,7 +86,7 @@ jobs: with: java-version: 11 distribution: temurin -# cache: maven + cache: maven - name: Install all modules using Java 11 shell: bash run: | From c982b157b45b01c8ac004625905e8051a3564851 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 10 Nov 2023 08:53:55 -0500 Subject: [PATCH 10/21] update integration goldens --- .../v1/ConnectionServiceClient.java | 40 +- .../cloud/apigeeconnect/v1/TetherClient.java | 35 +- .../cloud/asset/v1/AssetServiceClient.java | 415 +++++++++++- .../data/v2/BaseBigtableDataClient.java | 148 +++- .../compute/v1small/AddressesClient.java | 95 ++- .../v1small/RegionOperationsClient.java | 57 +- .../credentials/v1/IamCredentialsClient.java | 95 ++- .../com/google/iam/v1/IAMPolicyClient.java | 70 +- .../kms/v1/KeyManagementServiceClient.java | 592 +++++++++++++++- .../library/v1/LibraryServiceClient.java | 236 ++++++- .../google/cloud/logging/v2/ConfigClient.java | 552 ++++++++++++++- .../cloud/logging/v2/LoggingClient.java | 138 +++- .../cloud/logging/v2/MetricsClient.java | 115 +++- .../cloud/pubsub/v1/SchemaServiceClient.java | 257 ++++++- .../pubsub/v1/SubscriptionAdminClient.java | 438 +++++++++++- .../cloud/pubsub/v1/TopicAdminClient.java | 248 ++++++- .../cloud/redis/v1beta1/CloudRedisClient.java | 273 +++++++- .../com/google/storage/v2/StorageClient.java | 635 +++++++++++++++++- 18 files changed, 4216 insertions(+), 223 deletions(-) diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java index 0254061ebe..d41dc4399f 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java @@ -57,19 +57,33 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    ListConnections

    Lists connections that are currently active for the given Apigee Connect + * endpoint.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listConnections(ListConnectionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listConnections(EndpointName parent) + *
    • listConnections(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listConnectionsPagedCallable() + *
    • listConnectionsCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java index d085337c32..fbb28f87c3 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java @@ -61,19 +61,28 @@ *

    Note: close() needs to be called on the TetherClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    Egress

    Egress streams egress requests and responses. Logically, this is not + * actually a streaming request, but uses streaming as a mechanism to flip + * the client-server relationship of gRPC so that the server can act as a + * client. + * The listener, the RPC server, accepts connections from the dialer, + * the RPC client. + * The listener streams http requests and the dialer streams http responses.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • egressCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index bea5e6251a..07eb2dab2c 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -69,19 +69,410 @@ *

    Note: close() needs to be called on the AssetServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    UpdateFeed

    Updates an asset feed configuration.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateFeed(UpdateFeedRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateFeed(Feed feed) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateFeedCallable() + *
    + *
    ListFeeds

    Lists all asset feeds in a parent project/folder/organization.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listFeeds(ListFeedsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listFeeds(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listFeedsCallable() + *
    + *
    GetFeed

    Gets details about an asset feed.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getFeed(GetFeedRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getFeed(FeedName name) + *
    • getFeed(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getFeedCallable() + *
    + *
    BatchGetAssetsHistory

    Batch gets the update history of assets that overlap a time window. + * For IAM_POLICY content, this API outputs history when the asset and its + * attached IAM POLICY both exist. This can create gaps in the output history. + * Otherwise, this API outputs history with asset in both non-delete or + * deleted status. + * If a specified asset does not exist, this API returns an INVALID_ARGUMENT + * error.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • batchGetAssetsHistoryCallable() + *
    + *
    AnalyzeIamPolicy

    Analyzes IAM policies to answer which identities have what accesses on + * which resources.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • analyzeIamPolicy(AnalyzeIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • analyzeIamPolicyCallable() + *
    + *
    ExportAssets

    Exports assets with time and resource types to a given Cloud Storage + * location/BigQuery table. For Cloud Storage location destinations, the + * output format is newline-delimited JSON. Each line represents a + * [google.cloud.asset.v1.Asset][google.cloud.asset.v1.Asset] in the JSON format; for BigQuery table + * destinations, the output table stores the fields in asset Protobuf as + * columns. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API, + * which allows you to keep track of the export. We recommend intervals of at + * least 2 seconds with exponential retry to poll the export operation result. + * For regular-size resource parent, the export operation usually finishes + * within 5 minutes.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • exportAssetsAsync(ExportAssetsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • exportAssetsOperationCallable() + *
    • exportAssetsCallable() + *
    + *
    GetSavedQuery

    Gets details about a saved query.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getSavedQuery(GetSavedQueryRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getSavedQuery(SavedQueryName name) + *
    • getSavedQuery(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getSavedQueryCallable() + *
    + *
    CreateSavedQuery

    Creates a saved query in a parent project/folder/organization.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createSavedQuery(CreateSavedQueryRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createSavedQuery(FolderName parent) + *
    • createSavedQuery(OrganizationName parent) + *
    • createSavedQuery(ProjectName parent) + *
    • createSavedQuery(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createSavedQueryCallable() + *
    + *
    ListAssets

    Lists assets with time and resource types and returns paged results in + * response.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listAssets(ListAssetsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listAssets(ResourceName parent) + *
    • listAssets(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listAssetsPagedCallable() + *
    • listAssetsCallable() + *
    + *
    DeleteFeed

    Deletes an asset feed.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteFeed(DeleteFeedRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteFeed(FeedName name) + *
    • deleteFeed(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteFeedCallable() + *
    + *
    QueryAssets

    Issue a job that queries assets using a SQL statement compatible with + * [BigQuery Standard + * SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql). * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * If the query execution finishes within timeout and there's no pagination, + * the full query results will be returned in the `QueryAssetsResponse`. + * + * Otherwise, full query results can be obtained by issuing extra requests + * with the `job_reference` from the a previous `QueryAssets` call. + * + * Note, the query result has approximately 10 GB limitation enforced by + * BigQuery + * https://cloud.google.com/bigquery/docs/best-practices-performance-output, + * queries return larger results will result in errors.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • queryAssets(QueryAssetsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • queryAssetsCallable() + *
    + *
    DeleteSavedQuery

    Deletes a saved query.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteSavedQuery(DeleteSavedQueryRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteSavedQuery(SavedQueryName name) + *
    • deleteSavedQuery(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteSavedQueryCallable() + *
    + *
    SearchAllResources

    Searches all Cloud resources within the specified scope, such as a project, + * folder, or organization. The caller must be granted the + * `cloudasset.assets.searchAllResources` permission on the desired scope, + * otherwise the request will be rejected.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • searchAllResources(SearchAllResourcesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • searchAllResources(String scope) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • searchAllResourcesPagedCallable() + *
    • searchAllResourcesCallable() + *
    + *
    UpdateSavedQuery

    Updates a saved query.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateSavedQuery(UpdateSavedQueryRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateSavedQuery(SavedQuery savedQuery) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateSavedQueryCallable() + *
    + *
    AnalyzeIamPolicyLongrunning

    Analyzes IAM policies asynchronously to answer which identities have what + * accesses on which resources, and writes the analysis results to a Google + * Cloud Storage or a BigQuery destination. For Cloud Storage destination, the + * output format is the JSON format that represents a + * [AnalyzeIamPolicyResponse][google.cloud.asset.v1.AnalyzeIamPolicyResponse]. This method implements the + * [google.longrunning.Operation][google.longrunning.Operation], which allows you to track the operation + * status. We recommend intervals of at least 2 seconds with exponential + * backoff retry to poll the operation result. The metadata contains the + * metadata for the long-running operation.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • analyzeIamPolicyLongrunningOperationCallable() + *
    • analyzeIamPolicyLongrunningCallable() + *
    + *
    ListSavedQueries

    Lists all saved queries in a parent project/folder/organization.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSavedQueries(ListSavedQueriesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listSavedQueries(FolderName parent) + *
    • listSavedQueries(OrganizationName parent) + *
    • listSavedQueries(ProjectName parent) + *
    • listSavedQueries(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listSavedQueriesPagedCallable() + *
    • listSavedQueriesCallable() + *
    + *
    CreateFeed

    Creates a feed in a parent project/folder/organization to listen to its + * asset updates.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createFeed(CreateFeedRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createFeed(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createFeedCallable() + *
    + *
    BatchGetEffectiveIamPolicies

    Gets effective IAM policies for a batch of resources.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • batchGetEffectiveIamPoliciesCallable() + *
    + *
    SearchAllIamPolicies

    Searches all IAM policies within the specified scope, such as a project, + * folder, or organization. The caller must be granted the + * `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, + * otherwise the request will be rejected.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • searchAllIamPolicies(SearchAllIamPoliciesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • searchAllIamPolicies(String scope) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • searchAllIamPoliciesPagedCallable() + *
    • searchAllIamPoliciesCallable() + *
    + *
    AnalyzeMove

    Analyze moving a resource to a specified destination without kicking off + * the actual move. The analysis is best effort depending on the user's + * permissions of viewing different hierarchical policies and configurations. + * The policies and configuration are subject to change before the actual + * resource migration takes place.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • analyzeMove(AnalyzeMoveRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • analyzeMoveCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index 34257fb4cd..d01885145f 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -71,19 +71,141 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    MutateRows

    Mutates multiple rows in a batch. Each individual row is mutated + * atomically as in MutateRow, but the entire batch is not executed + * atomically.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • mutateRowsCallable() + *
    + *
    PingAndWarm

    Warm up associated instance metadata for this connection. + * This call is not required but may be useful for connection keep-alive.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • pingAndWarm(PingAndWarmRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • pingAndWarm(InstanceName name) + *
    • pingAndWarm(String name) + *
    • pingAndWarm(InstanceName name) + *
    • pingAndWarm(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • pingAndWarmCallable() + *
    + *
    ReadRows

    Streams back the contents of all requested rows in key order, optionally + * applying the same Reader filter to each. Depending on their size, + * rows and cells may be broken up across multiple responses, but + * atomicity of each row will still be preserved. See the + * ReadRowsResponse documentation for details.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • readRowsCallable() + *
    + *
    ReadModifyWriteRow

    Modifies a row atomically on the server. The method reads the latest + * existing timestamp and value from the specified columns and writes a new + * entry based on pre-defined read/modify/write rules. The new value for the + * timestamp is the greater of the existing timestamp or the current server + * time. The method returns the new contents of all modified cells.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • readModifyWriteRow(ReadModifyWriteRowRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • readModifyWriteRow(TableName tableName) + *
    • readModifyWriteRow(String tableName) + *
    • readModifyWriteRow(TableName tableName) + *
    • readModifyWriteRow(String tableName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • readModifyWriteRowCallable() + *
    + *
    MutateRow

    Mutates a row atomically. Cells already present in the row are left + * unchanged unless explicitly changed by `mutation`.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • mutateRow(MutateRowRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • mutateRow(TableName tableName) + *
    • mutateRow(String tableName) + *
    • mutateRow(TableName tableName) + *
    • mutateRow(String tableName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • mutateRowCallable() + *
    + *
    SampleRowKeys

    Returns a sample of row keys in the table. The returned row keys will + * delimit contiguous sections of the table of approximately equal size, + * which can be used to break up the data for distributed tasks like + * mapreduces.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • sampleRowKeysCallable() + *
    + *
    CheckAndMutateRow

    Mutates a row atomically based on the output of a predicate Reader filter.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • checkAndMutateRow(CheckAndMutateRowRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • checkAndMutateRow(TableName tableName) + *
    • checkAndMutateRow(String tableName) + *
    • checkAndMutateRow(TableName tableName) + *
    • checkAndMutateRow(String tableName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • checkAndMutateRowCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index 7da6db9b67..4aec80ab53 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -63,19 +63,88 @@ *

    Note: close() needs to be called on the AddressesClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    Delete

    Deletes the specified address resource.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteAsync(DeleteAddressRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • deleteAsync(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteOperationCallable() + *
    • deleteCallable() + *
    + *
    List

    Retrieves a list of addresses contained within the specified region.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • list(ListAddressesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • list(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listPagedCallable() + *
    • listCallable() + *
    + *
    Insert

    Creates an address resource in the specified project by using the data included in the request.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • insertAsync(InsertAddressRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • insertAsync(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • insertOperationCallable() + *
    • insertCallable() + *
    + *
    AggregatedList

    Retrieves an aggregated list of addresses.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • aggregatedList(AggregatedListAddressesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • aggregatedList(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • aggregatedListPagedCallable() + *
    • aggregatedListCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java index d74718729f..ff43ff31a1 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java @@ -49,19 +49,52 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    Get

    Retrieves the specified region-specific Operations resource.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • get(GetRegionOperationRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • get(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getCallable() + *
    + *
    Wait

    Waits for the specified Operation resource to return as `DONE` or for the request to approach the 2 minute deadline, and retrieves the specified Operation resource. This method differs from the `GET` method in that it waits for no more than the default deadline (2 minutes) and then returns the current state of the operation, which might be `DONE` or still in progress. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * This method is called on a best-effort basis. Specifically: + * - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. + * - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • wait(WaitRegionOperationRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • wait(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • waitCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java index aa18c91623..2c573b309a 100644 --- a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java +++ b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java @@ -60,19 +60,88 @@ *

    Note: close() needs to be called on the IamCredentialsClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    GenerateAccessToken

    Generates an OAuth 2.0 access token for a service account.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • generateAccessToken(GenerateAccessTokenRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • generateAccessToken(ServiceAccountName name) + *
    • generateAccessToken(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • generateAccessTokenCallable() + *
    + *
    GenerateIdToken

    Generates an OpenID Connect ID token for a service account.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • generateIdToken(GenerateIdTokenRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • generateIdToken(ServiceAccountName name) + *
    • generateIdToken(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • generateIdTokenCallable() + *
    + *
    SignBlob

    Signs a blob using a service account's system-managed private key.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • signBlob(SignBlobRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • signBlob(ServiceAccountName name) + *
    • signBlob(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • signBlobCallable() + *
    + *
    SignJwt

    Signs a JWT using a service account's system-managed private key.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • signJwt(SignJwtRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • signJwt(ServiceAccountName name) + *
    • signJwt(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • signJwtCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java index 43009b89f4..89a94e6fa2 100644 --- a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java +++ b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java @@ -72,19 +72,65 @@ *

    Note: close() needs to be called on the IAMPolicyClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    GetIamPolicy

    Gets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getIamPolicy(GetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getIamPolicyCallable() + *
    + *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() + *
    + *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • setIamPolicy(SetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • setIamPolicyCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index 23f83c2389..228cd0f025 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -80,19 +80,587 @@ * resources such as threads. In the example above, try-with-resources is used, which automatically * calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    UpdateCryptoKey

    Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateCryptoKey(UpdateCryptoKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateCryptoKey(CryptoKey cryptoKey) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateCryptoKeyCallable() + *
    + *
    Decrypt

    Decrypts data that was protected by + * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • decrypt(DecryptRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • decrypt(CryptoKeyName name) + *
    • decrypt(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • decryptCallable() + *
    + *
    ListKeyRings

    Lists [KeyRings][google.cloud.kms.v1.KeyRing].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listKeyRings(ListKeyRingsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listKeyRings(LocationName parent) + *
    • listKeyRings(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listKeyRingsPagedCallable() + *
    • listKeyRingsCallable() + *
    + *
    AsymmetricDecrypt

    Decrypts data that was encrypted with a public key retrieved from + * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] + * corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] + * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] + * ASYMMETRIC_DECRYPT.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • asymmetricDecrypt(AsymmetricDecryptRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • asymmetricDecrypt(CryptoKeyVersionName name) + *
    • asymmetricDecrypt(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • asymmetricDecryptCallable() + *
    + *
    ListImportJobs

    Lists [ImportJobs][google.cloud.kms.v1.ImportJob].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listImportJobs(ListImportJobsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listImportJobs(KeyRingName parent) + *
    • listImportJobs(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listImportJobsPagedCallable() + *
    • listImportJobsCallable() + *
    + *
    GetImportJob

    Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getImportJob(GetImportJobRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getImportJob(ImportJobName name) + *
    • getImportJob(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getImportJobCallable() + *
    + *
    CreateImportJob

    Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a + * [KeyRing][google.cloud.kms.v1.KeyRing]. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is + * required.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createImportJob(CreateImportJobRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createImportJob(KeyRingName parent) + *
    • createImportJob(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createImportJobCallable() + *
    + *
    ImportCryptoKeyVersion

    Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into + * an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the wrapped + * key material provided in the request. + * + * The version ID will be assigned the next sequential id within the + * [CryptoKey][google.cloud.kms.v1.CryptoKey].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • importCryptoKeyVersionCallable() + *
    + *
    GetPublicKey

    Returns the public key for the given + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ASYMMETRIC_SIGN][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_SIGN] + * or + * [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getPublicKey(GetPublicKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getPublicKey(CryptoKeyVersionName name) + *
    • getPublicKey(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getPublicKeyCallable() + *
    + *
    GetLocation

    Gets information about a location.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getLocation(GetLocationRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getLocationCallable() + *
    + *
    TestIamPermissions

    This is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() + *
    + *
    CreateKeyRing

    Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and + * Location.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createKeyRing(CreateKeyRingRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createKeyRing(LocationName parent) + *
    • createKeyRing(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createKeyRingCallable() + *
    + *
    GetKeyRing

    Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getKeyRing(GetKeyRingRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getKeyRing(KeyRingName name) + *
    • getKeyRing(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getKeyRingCallable() + *
    + *
    ListLocations

    Lists information about the supported locations for this service.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listLocations(ListLocationsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listLocationsPagedCallable() + *
    • listLocationsCallable() + *
    + *
    CreateCryptoKey

    Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a + * [KeyRing][google.cloud.kms.v1.KeyRing]. + * + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] and + * [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm] + * are required.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createCryptoKey(CreateCryptoKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createCryptoKey(KeyRingName parent) + *
    • createCryptoKey(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createCryptoKeyCallable() + *
    + *
    CreateCryptoKeyVersion

    Create a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in a + * [CryptoKey][google.cloud.kms.v1.CryptoKey]. + * + * The server will assign the next sequential id. If unset, + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to + * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createCryptoKeyVersion(CreateCryptoKeyVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createCryptoKeyVersion(CryptoKeyName parent) + *
    • createCryptoKeyVersion(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createCryptoKeyVersionCallable() + *
    + *
    UpdateCryptoKeyPrimaryVersion

    Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that + * will be used in + * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. + * + * Returns an error if called on an asymmetric key.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateCryptoKeyPrimaryVersion(CryptoKeyName name) + *
    • updateCryptoKeyPrimaryVersion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateCryptoKeyPrimaryVersionCallable() + *
    + *
    DestroyCryptoKeyVersion

    Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for + * destruction. + * + * Upon calling this method, + * [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will + * be set to + * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] + * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will + * be set to a time 24 hours in the future, at which point the + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be changed to + * [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], + * and the key material will be irrevocably destroyed. + * + * Before the + * [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is + * reached, + * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] + * may be called to reverse the process.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • destroyCryptoKeyVersion(CryptoKeyVersionName name) + *
    • destroyCryptoKeyVersion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • destroyCryptoKeyVersionCallable() + *
    + *
    GetIamPolicy

    Gets the access control policy for a resource. ADDED ONLY FOR MIXIN TESTS. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getIamPolicy(GetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getIamPolicyCallable() + *
    + *
    GetCryptoKeyVersion

    Returns metadata for a given + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getCryptoKeyVersion(CryptoKeyVersionName name) + *
    • getCryptoKeyVersion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getCryptoKeyVersionCallable() + *
    + *
    UpdateCryptoKeyVersion

    Update a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion]'s + * metadata. + * + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] may be changed between + * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED] + * and + * [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED] + * using this method. See + * [DestroyCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.DestroyCryptoKeyVersion] + * and + * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] + * to move between other states.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateCryptoKeyVersion(UpdateCryptoKeyVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateCryptoKeyVersionCallable() + *
    + *
    ListCryptoKeyVersions

    Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listCryptoKeyVersions(CryptoKeyName parent) + *
    • listCryptoKeyVersions(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listCryptoKeyVersionsPagedCallable() + *
    • listCryptoKeyVersionsCallable() + *
    + *
    AsymmetricSign

    Signs data using a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] + * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] + * ASYMMETRIC_SIGN, producing a signature that can be verified with the public + * key retrieved from + * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • asymmetricSign(AsymmetricSignRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • asymmetricSign(CryptoKeyVersionName name) + *
    • asymmetricSign(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • asymmetricSignCallable() + *
    + *
    Encrypt

    Encrypts data, so that it can only be recovered by a call to + * [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • encrypt(EncryptRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • encrypt(ResourceName name) + *
    • encrypt(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • encryptCallable() + *
    + *
    GetCryptoKey

    Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as + * well as its [primary][google.cloud.kms.v1.CryptoKey.primary] + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getCryptoKey(GetCryptoKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getCryptoKey(CryptoKeyName name) + *
    • getCryptoKey(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getCryptoKeyCallable() + *
    + *
    RestoreCryptoKeyVersion

    Restore a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] in the + * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] + * state. + * + * Upon restoration of the CryptoKeyVersion, + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to + * [DISABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DISABLED], + * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will + * be cleared.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • restoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • restoreCryptoKeyVersion(CryptoKeyVersionName name) + *
    • restoreCryptoKeyVersion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • restoreCryptoKeyVersionCallable() + *
    + *
    ListCryptoKeys

    Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listCryptoKeys(ListCryptoKeysRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listCryptoKeys(KeyRingName parent) + *
    • listCryptoKeys(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listCryptoKeysPagedCallable() + *
    • listCryptoKeysCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index 0796286c2e..c30e8e20c2 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -80,19 +80,231 @@ *

    Note: close() needs to be called on the LibraryServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    ListShelves

    Lists shelves. The order is unspecified but deterministic. Newly created + * shelves will not necessarily be added to the end of this list.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listShelves(ListShelvesRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listShelvesPagedCallable() + *
    • listShelvesCallable() + *
    + *
    CreateShelf

    Creates a shelf, and returns the new Shelf.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createShelf(CreateShelfRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createShelf(Shelf shelf) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createShelfCallable() + *
    + *
    DeleteShelf

    Deletes a shelf. Returns NOT_FOUND if the shelf does not exist.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteShelf(DeleteShelfRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteShelf(ShelfName name) + *
    • deleteShelf(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteShelfCallable() + *
    + *
    MoveBook

    Moves a book to another shelf, and returns the new book. The book + * id of the new book may not be the same as the original book.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • moveBook(MoveBookRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • moveBook(BookName name) + *
    • moveBook(BookName name) + *
    • moveBook(String name) + *
    • moveBook(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • moveBookCallable() + *
    + *
    CreateBook

    Creates a book, and returns the new Book.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createBook(CreateBookRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createBook(ShelfName parent) + *
    • createBook(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createBookCallable() + *
    + *
    DeleteBook

    Deletes a book. Returns NOT_FOUND if the book does not exist.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteBook(DeleteBookRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteBook(BookName name) + *
    • deleteBook(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteBookCallable() + *
    + *
    UpdateBook

    Updates a book. Returns INVALID_ARGUMENT if the name of the book + * is non-empty and does not equal the existing name.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateBook(UpdateBookRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateBook(Book book) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateBookCallable() + *
    + *
    GetShelf

    Gets a shelf. Returns NOT_FOUND if the shelf does not exist.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getShelf(GetShelfRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getShelf(ShelfName name) + *
    • getShelf(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getShelfCallable() + *
    + *
    GetBook

    Gets a book. Returns NOT_FOUND if the book does not exist.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getBook(GetBookRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getBook(BookName name) + *
    • getBook(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getBookCallable() + *
    + *
    MergeShelves

    Merges two shelves by adding all books from the shelf named + * `other_shelf_name` to shelf `name`, and deletes + * `other_shelf_name`. Returns the updated shelf. + * The book ids of the moved books may not be the same as the original books. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * Returns NOT_FOUND if either shelf does not exist. + * This call is a no-op if the specified shelves are the same.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • mergeShelves(MergeShelvesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • mergeShelves(ShelfName name) + *
    • mergeShelves(ShelfName name) + *
    • mergeShelves(String name) + *
    • mergeShelves(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • mergeShelvesCallable() + *
    + *
    ListBooks

    Lists books in a shelf. The order is unspecified but deterministic. Newly + * created books will not necessarily be added to the end of this list. + * Returns NOT_FOUND if the shelf does not exist.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listBooks(ListBooksRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listBooks(ShelfName parent) + *
    • listBooks(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listBooksPagedCallable() + *
    • listBooksCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index 72aa8590aa..1133d11ac3 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -114,19 +114,547 @@ *

    Note: close() needs to be called on the ConfigClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    DeleteSink

    Deletes a sink. If the sink has a unique `writer_identity`, then that + * service account is also deleted.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteSink(DeleteSinkRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteSink(LogSinkName sinkName) + *
    • deleteSink(String sinkName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteSinkCallable() + *
    + *
    UpdateView

    Updates a view on a log bucket. This method replaces the following fields + * in the existing view with values from the new view: `filter`. + * If an `UNAVAILABLE` error is returned, this indicates that system is not in + * a state where it can update the view. If this occurs, please try again in a + * few minutes.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateView(UpdateViewRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateViewCallable() + *
    + *
    UpdateCmekSettings

    Updates the Log Router CMEK settings for the given resource. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * Note: CMEK for the Log Router can currently only be configured for Google + * Cloud organizations. Once configured, it applies to all projects and + * folders in the Google Cloud organization. + * + * [UpdateCmekSettings][google.logging.v2.ConfigServiceV2.UpdateCmekSettings] + * will fail if 1) `kms_key_name` is invalid, or 2) the associated service + * account does not have the required + * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or + * 3) access to the key is disabled. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateCmekSettings(UpdateCmekSettingsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateCmekSettingsCallable() + *
    + *
    GetView

    Gets a view on a log bucket..

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getView(GetViewRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getViewCallable() + *
    + *
    UndeleteBucket

    Undeletes a log bucket. A bucket that has been deleted can be undeleted + * within the grace period of 7 days.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • undeleteBucket(UndeleteBucketRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • undeleteBucketCallable() + *
    + *
    ListExclusions

    Lists all the exclusions on the _Default sink in a parent resource.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listExclusions(ListExclusionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listExclusions(BillingAccountName parent) + *
    • listExclusions(FolderName parent) + *
    • listExclusions(OrganizationName parent) + *
    • listExclusions(ProjectName parent) + *
    • listExclusions(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listExclusionsPagedCallable() + *
    • listExclusionsCallable() + *
    + *
    UpdateSettings

    Updates the Log Router settings for the given resource. + * + * Note: Settings for the Log Router can currently only be configured for + * Google Cloud organizations. Once configured, it applies to all projects and + * folders in the Google Cloud organization. + * + * [UpdateSettings][google.logging.v2.ConfigServiceV2.UpdateSettings] + * will fail if 1) `kms_key_name` is invalid, or 2) the associated service + * account does not have the required + * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or + * 3) access to the key is disabled. 4) `location_id` is not supported by + * Logging. 5) `location_id` violate OrgPolicy. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateSettings(UpdateSettingsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateSettings(Settings settings) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateSettingsCallable() + *
    + *
    CreateView

    Creates a view over log entries in a log bucket. A bucket may contain a + * maximum of 30 views.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createView(CreateViewRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createViewCallable() + *
    + *
    DeleteView

    Deletes a view on a log bucket. + * If an `UNAVAILABLE` error is returned, this indicates that system is not in + * a state where it can delete the view. If this occurs, please try again in a + * few minutes.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteView(DeleteViewRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteViewCallable() + *
    + *
    UpdateExclusion

    Changes one or more properties of an existing exclusion in the _Default + * sink.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateExclusion(UpdateExclusionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateExclusion(LogExclusionName name) + *
    • updateExclusion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateExclusionCallable() + *
    + *
    GetSink

    Gets a sink.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getSink(GetSinkRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getSink(LogSinkName sinkName) + *
    • getSink(String sinkName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getSinkCallable() + *
    + *
    CreateExclusion

    Creates a new exclusion in the _Default sink in a specified parent + * resource. Only log entries belonging to that resource can be excluded. You + * can have up to 10 exclusions in a resource.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createExclusion(CreateExclusionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createExclusion(BillingAccountName parent) + *
    • createExclusion(FolderName parent) + *
    • createExclusion(OrganizationName parent) + *
    • createExclusion(ProjectName parent) + *
    • createExclusion(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createExclusionCallable() + *
    + *
    DeleteBucket

    Deletes a log bucket. + * + * Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state. + * After 7 days, the bucket will be purged and all log entries in the bucket + * will be permanently deleted.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteBucket(DeleteBucketRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteBucketCallable() + *
    + *
    ListBuckets

    Lists log buckets.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listBuckets(ListBucketsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listBuckets(BillingAccountLocationName parent) + *
    • listBuckets(FolderLocationName parent) + *
    • listBuckets(LocationName parent) + *
    • listBuckets(OrganizationLocationName parent) + *
    • listBuckets(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listBucketsPagedCallable() + *
    • listBucketsCallable() + *
    + *
    GetCmekSettings

    Gets the Logging CMEK settings for the given resource. + * + * Note: CMEK for the Log Router can be configured for Google Cloud projects, + * folders, organizations and billing accounts. Once configured for an + * organization, it applies to all projects and folders in the Google Cloud + * organization. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getCmekSettings(GetCmekSettingsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getCmekSettingsCallable() + *
    + *
    CreateSink

    Creates a sink that exports specified log entries to a destination. The + * export of newly-ingested log entries begins immediately, unless the sink's + * `writer_identity` is not permitted to write to the destination. A sink can + * export log entries only from the resource owning the sink.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createSink(CreateSinkRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createSink(BillingAccountName parent) + *
    • createSink(FolderName parent) + *
    • createSink(OrganizationName parent) + *
    • createSink(ProjectName parent) + *
    • createSink(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createSinkCallable() + *
    + *
    GetBucket

    Gets a log bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getBucket(GetBucketRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getBucketCallable() + *
    + *
    ListViews

    Lists views on a log bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listViews(ListViewsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listViews(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listViewsPagedCallable() + *
    • listViewsCallable() + *
    + *
    ListSinks

    Lists sinks.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSinks(ListSinksRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listSinks(BillingAccountName parent) + *
    • listSinks(FolderName parent) + *
    • listSinks(OrganizationName parent) + *
    • listSinks(ProjectName parent) + *
    • listSinks(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listSinksPagedCallable() + *
    • listSinksCallable() + *
    + *
    UpdateSink

    Updates a sink. This method replaces the following fields in the existing + * sink with values from the new sink: `destination`, and `filter`. + * + * The updated sink might also have a new `writer_identity`; see the + * `unique_writer_identity` field.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateSink(UpdateSinkRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateSink(LogSinkName sinkName) + *
    • updateSink(String sinkName) + *
    • updateSink(LogSinkName sinkName) + *
    • updateSink(String sinkName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateSinkCallable() + *
    + *
    UpdateBucket

    Updates a log bucket. This method replaces the following fields in the + * existing bucket with values from the new bucket: `retention_period` + * + * If the retention period is decreased and the bucket is locked, + * `FAILED_PRECONDITION` will be returned. + * + * If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then + * `FAILED_PRECONDITION` will be returned. + * + * After a bucket has been created, the bucket's location cannot be changed.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateBucket(UpdateBucketRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateBucketCallable() + *
    + *
    GetExclusion

    Gets the description of an exclusion in the _Default sink.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getExclusion(GetExclusionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getExclusion(LogExclusionName name) + *
    • getExclusion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getExclusionCallable() + *
    + *
    DeleteExclusion

    Deletes an exclusion in the _Default sink.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteExclusion(DeleteExclusionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteExclusion(LogExclusionName name) + *
    • deleteExclusion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteExclusionCallable() + *
    + *
    CopyLogEntries

    Copies a set of log entries from a log bucket to a Cloud Storage bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • copyLogEntriesAsync(CopyLogEntriesRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • copyLogEntriesOperationCallable() + *
    • copyLogEntriesCallable() + *
    + *
    CreateBucket

    Creates a log bucket that can be used to store log entries. After a bucket + * has been created, the bucket's location cannot be changed.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createBucket(CreateBucketRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createBucketCallable() + *
    + *
    GetSettings

    Gets the Log Router settings for the given resource. + * + * Note: Settings for the Log Router can be get for Google Cloud projects, + * folders, organizations and billing accounts. Currently it can only be + * configured for organizations. Once configured for an organization, it + * applies to all projects and folders in the Google Cloud organization. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getSettings(GetSettingsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getSettings(SettingsName name) + *
    • getSettings(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getSettingsCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index 642d2947a5..3d8c229fe5 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -76,19 +76,131 @@ *

    Note: close() needs to be called on the LoggingClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    WriteLogEntries

    Writes log entries to Logging. This API method is the + * only way to send log entries to Logging. This method + * is used, directly or indirectly, by the Logging agent + * (fluentd) and all logging libraries configured to use Logging. + * A single request may contain log entries for a maximum of 1000 + * different resources (projects, organizations, billing accounts or + * folders)

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • writeLogEntries(WriteLogEntriesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • writeLogEntries(LogName logName) + *
    • writeLogEntries(String logName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • writeLogEntriesCallable() + *
    + *
    ListMonitoredResourceDescriptors

    Lists the descriptors for monitored resource types used by Logging.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listMonitoredResourceDescriptorsPagedCallable() + *
    • listMonitoredResourceDescriptorsCallable() + *
    + *
    ListLogs

    Lists the logs in projects, organizations, folders, or billing accounts. + * Only logs that have entries are listed.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listLogs(ListLogsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listLogs(BillingAccountName parent) + *
    • listLogs(FolderName parent) + *
    • listLogs(OrganizationName parent) + *
    • listLogs(ProjectName parent) + *
    • listLogs(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listLogsPagedCallable() + *
    • listLogsCallable() + *
    + *
    DeleteLog

    Deletes all the log entries in a log for the _Default Log Bucket. The log + * reappears if it receives new entries. Log entries written shortly before + * the delete operation might not be deleted. Entries received after the + * delete operation with a timestamp before the operation will be deleted.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteLog(DeleteLogRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteLog(LogName logName) + *
    • deleteLog(String logName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteLogCallable() + *
    + *
    ListLogEntries

    Lists log entries. Use this method to retrieve log entries that originated + * from a project/folder/organization/billing account. For ways to export log + * entries, see [Exporting + * Logs](https://cloud.google.com/logging/docs/export).

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listLogEntries(ListLogEntriesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listLogEntries(List resourceNames) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listLogEntriesPagedCallable() + *
    • listLogEntriesCallable() + *
    + *
    TailLogEntries

    Streaming read of log entries as they are ingested. Until the stream is + * terminated, it will continue reading logs.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • tailLogEntriesCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index a0306451a1..a8eb81defe 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -64,19 +64,108 @@ *

    Note: close() needs to be called on the MetricsClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: - * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    UpdateLogMetric

    Creates or updates a logs-based metric.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateLogMetric(UpdateLogMetricRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateLogMetric(LogMetricName metricName) + *
    • updateLogMetric(String metricName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateLogMetricCallable() + *
    + *
    CreateLogMetric

    Creates a logs-based metric.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createLogMetric(CreateLogMetricRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createLogMetric(ProjectName parent) + *
    • createLogMetric(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createLogMetricCallable() + *
    + *
    GetLogMetric

    Gets a logs-based metric.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getLogMetric(GetLogMetricRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getLogMetric(LogMetricName metricName) + *
    • getLogMetric(String metricName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getLogMetricCallable() + *
    + *
    DeleteLogMetric

    Deletes a logs-based metric.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteLogMetric(DeleteLogMetricRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteLogMetric(LogMetricName metricName) + *
    • deleteLogMetric(String metricName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteLogMetricCallable() + *
    + *
    ListLogMetrics

    Lists logs-based metrics.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listLogMetrics(ListLogMetricsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listLogMetrics(ProjectName parent) + *
    • listLogMetrics(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listLogMetricsPagedCallable() + *
    • listLogMetricsCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index fd82725ee7..471490b25a 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -79,19 +79,252 @@ *

    Note: close() needs to be called on the SchemaServiceClient object to clean up resources such * as threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    DeleteSchema

    Deletes a schema.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteSchema(DeleteSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteSchema(SchemaName name) + *
    • deleteSchema(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteSchemaCallable() + *
    + *
    GetIamPolicy

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getIamPolicy(GetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getIamPolicyCallable() + *
    + *
    ListSchemaRevisions

    Lists all schema revisions for the named schema.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSchemaRevisions(ListSchemaRevisionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listSchemaRevisions(SchemaName name) + *
    • listSchemaRevisions(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listSchemaRevisionsPagedCallable() + *
    • listSchemaRevisionsCallable() + *
    + *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces + * any existing policy. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • setIamPolicy(SetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • setIamPolicyCallable() + *
    + *
    RollbackSchema

    Creates a new schema revision that is a copy of the provided revision_id.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • rollbackSchema(RollbackSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • rollbackSchema(SchemaName name) + *
    • rollbackSchema(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • rollbackSchemaCallable() + *
    + *
    DeleteSchemaRevision

    Deletes a specific schema revision.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteSchemaRevision(DeleteSchemaRevisionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteSchemaRevision(SchemaName name) + *
    • deleteSchemaRevision(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteSchemaRevisionCallable() + *
    + *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() + *
    + *
    ValidateMessage

    Validates a message against a schema.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • validateMessage(ValidateMessageRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • validateMessageCallable() + *
    + *
    CreateSchema

    Creates a schema.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createSchema(CreateSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createSchema(ProjectName parent) + *
    • createSchema(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createSchemaCallable() + *
    + *
    ListSchemas

    Lists schemas in a project.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSchemas(ListSchemasRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listSchemas(ProjectName parent) + *
    • listSchemas(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listSchemasPagedCallable() + *
    • listSchemasCallable() + *
    + *
    CommitSchema

    Commits a new schema revision to an existing schema.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • commitSchema(CommitSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • commitSchema(SchemaName name) + *
    • commitSchema(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • commitSchemaCallable() + *
    + *
    GetSchema

    Gets a schema.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getSchema(GetSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getSchema(SchemaName name) + *
    • getSchema(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getSchemaCallable() + *
    + *
    ValidateSchema

    Validates a schema.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • validateSchema(ValidateSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • validateSchema(ProjectName parent) + *
    • validateSchema(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • validateSchemaCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 87b846e1c8..84431a78b4 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -95,19 +95,433 @@ * such as threads. In the example above, try-with-resources is used, which automatically calls * close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    Pull

    Pulls messages from the server. The server may return `UNAVAILABLE` if + * there are too many concurrent pull requests pending for the given + * subscription.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • pull(PullRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • pull(SubscriptionName subscription) + *
    • pull(String subscription) + *
    • pull(SubscriptionName subscription) + *
    • pull(String subscription) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • pullCallable() + *
    + *
    GetSnapshot

    Gets the configuration details of a snapshot. Snapshots are used in + * Seek + * operations, which allow you to manage message acknowledgments in bulk. That + * is, you can set the acknowledgment state of messages in an existing + * subscription to the state captured by a snapshot.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getSnapshot(GetSnapshotRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getSnapshot(SnapshotName snapshot) + *
    • getSnapshot(String snapshot) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getSnapshotCallable() + *
    + *
    Acknowledge

    Acknowledges the messages associated with the `ack_ids` in the + * `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages + * from the subscription. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * Acknowledging a message whose ack deadline has expired may succeed, + * but such a message may be redelivered later. Acknowledging a message more + * than once will not result in an error.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • acknowledge(AcknowledgeRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • acknowledge(SubscriptionName subscription) + *
    • acknowledge(String subscription) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • acknowledgeCallable() + *
    + *
    ModifyAckDeadline

    Modifies the ack deadline for a specific message. This method is useful + * to indicate that more time is needed to process a message by the + * subscriber, or to make the message available for redelivery if the + * processing was interrupted. Note that this does not modify the + * subscription-level `ackDeadlineSeconds` used for subsequent messages.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • modifyAckDeadline(ModifyAckDeadlineRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • modifyAckDeadline(SubscriptionName subscription) + *
    • modifyAckDeadline(String subscription) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • modifyAckDeadlineCallable() + *
    + *
    ModifyPushConfig

    Modifies the `PushConfig` for a specified subscription. + * + * This may be used to change a push subscription to a pull one (signified by + * an empty `PushConfig`) or vice versa, or change the endpoint URL and other + * attributes of a push subscription. Messages will accumulate for delivery + * continuously through the call regardless of changes to the `PushConfig`.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • modifyPushConfig(ModifyPushConfigRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • modifyPushConfig(SubscriptionName subscription) + *
    • modifyPushConfig(String subscription) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • modifyPushConfigCallable() + *
    + *
    GetIamPolicy

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getIamPolicy(GetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getIamPolicyCallable() + *
    + *
    GetSubscription

    Gets the configuration details of a subscription.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getSubscription(GetSubscriptionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getSubscription(SubscriptionName subscription) + *
    • getSubscription(String subscription) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getSubscriptionCallable() + *
    + *
    StreamingPull

    Establishes a stream with the server, which sends messages down to the + * client. The client streams acknowledgements and ack deadline modifications + * back to the server. The server will close the stream and return the status + * on any error. The server may close the stream with status `UNAVAILABLE` to + * reassign server-side resources, in which case, the client should + * re-establish the stream. Flow control can be achieved by configuring the + * underlying RPC channel.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • streamingPullCallable() + *
    + *
    ListSnapshots

    Lists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSnapshots(ListSnapshotsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listSnapshots(ProjectName project) + *
    • listSnapshots(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listSnapshotsPagedCallable() + *
    • listSnapshotsCallable() + *
    + *
    CreateSubscription

    Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). + * If the subscription already exists, returns `ALREADY_EXISTS`. + * If the corresponding topic doesn't exist, returns `NOT_FOUND`. + * + * If the name is not provided in the request, the server will assign a random + * name for this subscription on the same project as the topic, conforming + * to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated + * name is populated in the returned Subscription object. Note that for REST + * API requests, you must specify a name in the request.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createSubscription(Subscription request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createSubscription(SubscriptionName name) + *
    • createSubscription(SubscriptionName name) + *
    • createSubscription(String name) + *
    • createSubscription(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createSubscriptionCallable() + *
    + *
    DeleteSnapshot

    Removes an existing snapshot. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + * When the snapshot is deleted, all messages retained in the snapshot + * are immediately dropped. After a snapshot is deleted, a new one may be + * created with the same name, but the new one has no association with the old + * snapshot or its subscription, unless the same subscription is specified.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteSnapshot(DeleteSnapshotRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteSnapshot(SnapshotName snapshot) + *
    • deleteSnapshot(String snapshot) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteSnapshotCallable() + *
    + *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces + * any existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • setIamPolicy(SetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • setIamPolicyCallable() + *
    + *
    UpdateSnapshot

    Updates an existing snapshot. Snapshots are used in + * Seek + * operations, which allow + * you to manage message acknowledgments in bulk. That is, you can set the + * acknowledgment state of messages in an existing subscription to the state + * captured by a snapshot.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateSnapshot(UpdateSnapshotRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateSnapshotCallable() + *
    + *
    UpdateSubscription

    Updates an existing subscription. Note that certain properties of a + * subscription, such as its topic, are not modifiable.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateSubscription(UpdateSubscriptionRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateSubscriptionCallable() + *
    + *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() + *
    + *
    DeleteSubscription

    Deletes an existing subscription. All messages retained in the subscription + * are immediately dropped. Calls to `Pull` after deletion will return + * `NOT_FOUND`. After a subscription is deleted, a new one may be created with + * the same name, but the new one has no association with the old + * subscription or its topic unless the same topic is specified.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteSubscription(DeleteSubscriptionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteSubscription(SubscriptionName subscription) + *
    • deleteSubscription(String subscription) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteSubscriptionCallable() + *
    + *
    ListSubscriptions

    Lists matching subscriptions.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSubscriptions(ListSubscriptionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listSubscriptions(ProjectName project) + *
    • listSubscriptions(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listSubscriptionsPagedCallable() + *
    • listSubscriptionsCallable() + *
    + *
    CreateSnapshot

    Creates a snapshot from the requested subscription. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + * which allow you to manage message acknowledgments in bulk. That is, you can + * set the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + * If the snapshot already exists, returns `ALREADY_EXISTS`. + * If the requested subscription doesn't exist, returns `NOT_FOUND`. + * If the backlog in the subscription is too old -- and the resulting snapshot + * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. + * See also the `Snapshot.expire_time` field. If the name is not provided in + * the request, the server will assign a random + * name for this snapshot on the same project as the subscription, conforming + * to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The + * generated name is populated in the returned Snapshot object. Note that for + * REST API requests, you must specify a name in the request.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createSnapshot(CreateSnapshotRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createSnapshot(SnapshotName name) + *
    • createSnapshot(SnapshotName name) + *
    • createSnapshot(String name) + *
    • createSnapshot(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createSnapshotCallable() + *
    + *
    Seek

    Seeks an existing subscription to a point in time or to a given snapshot, + * whichever is provided in the request. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. Note that both the subscription and the + * snapshot must be on the same topic.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • seek(SeekRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • seekCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index bb74a760d4..ba7ab18b97 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -78,19 +78,243 @@ *

    Note: close() needs to be called on the TopicAdminClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    ListTopicSubscriptions

    Lists the names of the attached subscriptions on this topic.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listTopicSubscriptions(ListTopicSubscriptionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listTopicSubscriptions(TopicName topic) + *
    • listTopicSubscriptions(String topic) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listTopicSubscriptionsPagedCallable() + *
    • listTopicSubscriptionsCallable() + *
    + *
    DetachSubscription

    Detaches a subscription from this topic. All messages retained in the + * subscription are dropped. Subsequent `Pull` and `StreamingPull` requests + * will return FAILED_PRECONDITION. If the subscription is a push + * subscription, pushes to the endpoint will stop.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • detachSubscription(DetachSubscriptionRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • detachSubscriptionCallable() + *
    + *
    CreateTopic

    Creates the given topic with the given name. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names).

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createTopic(Topic request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createTopic(TopicName name) + *
    • createTopic(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createTopicCallable() + *
    + *
    ListTopics

    Lists matching topics.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listTopics(ListTopicsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listTopics(ProjectName project) + *
    • listTopics(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listTopicsPagedCallable() + *
    • listTopicsCallable() + *
    + *
    GetTopic

    Gets the configuration of a topic.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getTopic(GetTopicRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getTopic(TopicName topic) + *
    • getTopic(String topic) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getTopicCallable() + *
    + *
    GetIamPolicy

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getIamPolicy(GetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getIamPolicyCallable() + *
    + *
    UpdateTopic

    Updates an existing topic. Note that certain properties of a + * topic are not modifiable.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateTopic(UpdateTopicRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateTopicCallable() + *
    + *
    TestIamPermissions

    Returns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() + *
    + *
    DeleteTopic

    Deletes the topic with the given name. Returns `NOT_FOUND` if the topic + * does not exist. After a topic is deleted, a new topic may be created with + * the same name; this is an entirely new topic with none of the old + * configuration or subscriptions. Existing subscriptions to this topic are + * not deleted, but their `topic` field is set to `_deleted-topic_`.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteTopic(DeleteTopicRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteTopic(TopicName topic) + *
    • deleteTopic(String topic) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteTopicCallable() + *
    + *
    ListTopicSnapshots

    Lists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + * which allow you to manage message acknowledgments in bulk. That is, you can + * set the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listTopicSnapshots(ListTopicSnapshotsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listTopicSnapshots(TopicName topic) + *
    • listTopicSnapshots(String topic) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listTopicSnapshotsPagedCallable() + *
    • listTopicSnapshotsCallable() + *
    + *
    SetIamPolicy

    Sets the access control policy on the specified resource. Replaces + * any existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • setIamPolicy(SetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • setIamPolicyCallable() + *
    + *
    Publish

    Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic + * does not exist.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • publish(PublishRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • publish(TopicName topic) + *
    • publish(String topic) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • publishCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index fb9a41852b..2b5c7631a1 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -82,19 +82,268 @@ *

    Note: close() needs to be called on the CloudRedisClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    GetInstance

    Gets the details of a specific Redis instance.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getInstance(GetInstanceRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getInstance(InstanceName name) + *
    • getInstance(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getInstanceCallable() + *
    + *
    ExportInstance

    Export Redis instance data into a Redis RDB format file in Cloud Storage. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * Redis will continue serving during this operation. + * + * The returned operation is automatically deleted after a few hours, so + * there is no need to call DeleteOperation.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • exportInstanceAsync(ExportInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • exportInstanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • exportInstanceOperationCallable() + *
    • exportInstanceCallable() + *
    + *
    ListInstances

    Lists all Redis instances owned by a project in either the specified + * location (region) or all locations. + * + * The location should have the following format: + * + * * `projects/{project_id}/locations/{location_id}` + * + * If `location_id` is specified as `-` (wildcard), then all regions + * available to the project are queried, and the results are aggregated.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listInstances(ListInstancesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listInstances(LocationName parent) + *
    • listInstances(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listInstancesPagedCallable() + *
    • listInstancesCallable() + *
    + *
    UpdateInstance

    Updates the metadata and configuration of a specific Redis instance. + * + * Completed longrunning.Operation will contain the new instance object + * in the response field. The returned operation is automatically deleted + * after a few hours, so there is no need to call DeleteOperation.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateInstanceAsync(UpdateInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • updateInstanceAsync(FieldMask updateMask) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateInstanceOperationCallable() + *
    • updateInstanceCallable() + *
    + *
    GetInstanceAuthString

    Gets the AUTH string for a Redis instance. If AUTH is not enabled for the + * instance the response will be empty. This information is not included in + * the details returned to GetInstance.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getInstanceAuthString(GetInstanceAuthStringRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getInstanceAuthString(InstanceName name) + *
    • getInstanceAuthString(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getInstanceAuthStringCallable() + *
    + *
    RescheduleMaintenance

    Reschedule maintenance for a given instance in a given project and + * location.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • rescheduleMaintenanceAsync(InstanceName name) + *
    • rescheduleMaintenanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • rescheduleMaintenanceOperationCallable() + *
    • rescheduleMaintenanceCallable() + *
    + *
    CreateInstance

    Creates a Redis instance based on the specified tier and memory size. + * + * By default, the instance is accessible from the project's + * [default network](https://cloud.google.com/vpc/docs/vpc). + * + * The creation is executed asynchronously and callers may check the returned + * operation to track its progress. Once the operation is completed the Redis + * instance will be fully functional. The completed longrunning.Operation will + * contain the new instance object in the response field. + * + * The returned operation is automatically deleted after a few hours, so there + * is no need to call DeleteOperation.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createInstanceAsync(CreateInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • createInstanceAsync(LocationName parent) + *
    • createInstanceAsync(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createInstanceOperationCallable() + *
    • createInstanceCallable() + *
    + *
    ImportInstance

    Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. + * + * Redis may stop serving during this operation. Instance state will be + * IMPORTING for entire operation. When complete, the instance will contain + * only data from the imported file. + * + * The returned operation is automatically deleted after a few hours, so + * there is no need to call DeleteOperation.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • importInstanceAsync(ImportInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • importInstanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • importInstanceOperationCallable() + *
    • importInstanceCallable() + *
    + *
    FailoverInstance

    Initiates a failover of the primary node to current replica node for a + * specific STANDARD tier Cloud Memorystore for Redis instance.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • failoverInstanceAsync(FailoverInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • failoverInstanceAsync(InstanceName name) + *
    • failoverInstanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • failoverInstanceOperationCallable() + *
    • failoverInstanceCallable() + *
    + *
    UpgradeInstance

    Upgrades Redis instance to the newer Redis version specified in the + * request.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • upgradeInstanceAsync(UpgradeInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • upgradeInstanceAsync(InstanceName name) + *
    • upgradeInstanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • upgradeInstanceOperationCallable() + *
    • upgradeInstanceCallable() + *
    + *
    DeleteInstance

    Deletes a specific Redis instance. Instance stops serving and data is + * deleted.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteInstanceAsync(DeleteInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • deleteInstanceAsync(InstanceName name) + *
    • deleteInstanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteInstanceOperationCallable() + *
    • deleteInstanceCallable() + *
    + *
    * *

    See the individual methods for example code. * diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index 650dafb7a8..1377677719 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -78,19 +78,630 @@ *

    Note: close() needs to be called on the StorageClient object to clean up resources such as * threads. In the example above, try-with-resources is used, which automatically calls close(). * - *

    The surface of this class includes several types of Java methods for each of the API's - * methods: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
    MethodDescriptionMethod Variants
    DeleteNotification

    Permanently deletes a notification subscription.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteNotification(DeleteNotificationRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteNotification(NotificationName name) + *
    • deleteNotification(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteNotificationCallable() + *
    + *
    DeleteObject

    Deletes an object and its metadata. Deletions are permanent if versioning + * is not enabled for the bucket, or if the `generation` parameter is used.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteObject(DeleteObjectRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteObject(String bucket) + *
    • deleteObject(String bucket) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteObjectCallable() + *
    + *
    StartResumableWrite

    Starts a resumable write. How long the write operation remains valid, and + * what happens when the write operation becomes invalid, are + * service-dependent.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • startResumableWrite(StartResumableWriteRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • startResumableWriteCallable() + *
    + *
    SetIamPolicy

    Updates an IAM policy for the specified bucket or object. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • setIamPolicy(SetIamPolicyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • setIamPolicy(ResourceName resource) + *
    • setIamPolicy(String resource) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • setIamPolicyCallable() + *
    + *
    ListNotifications

    Retrieves a list of notification subscriptions for a given bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listNotifications(ListNotificationsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listNotifications(ProjectName parent) + *
    • listNotifications(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listNotificationsPagedCallable() + *
    • listNotificationsCallable() + *
    + *
    UpdateHmacKey

    Updates a given HMAC key state between ACTIVE and INACTIVE.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateHmacKey(UpdateHmacKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateHmacKey(HmacKeyMetadata hmacKey) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateHmacKeyCallable() + *
    + *
    GetHmacKey

    Gets an existing HMAC key metadata for the given id.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getHmacKey(GetHmacKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getHmacKey(String accessId) + *
    • getHmacKey(String accessId) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getHmacKeyCallable() + *
    + *
    DeleteBucket

    Permanently deletes an empty bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteBucket(DeleteBucketRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteBucket(BucketName name) + *
    • deleteBucket(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteBucketCallable() + *
    + *
    TestIamPermissions

    Tests a set of permissions on the given bucket or object to see which, if + * any, are held by the caller. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • testIamPermissions(ResourceName resource) + *
    • testIamPermissions(String resource) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() + *
    + *
    ListBuckets

    Retrieves a list of buckets for a given project.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listBuckets(ListBucketsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listBuckets(ProjectName parent) + *
    • listBuckets(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listBucketsPagedCallable() + *
    • listBucketsCallable() + *
    + *
    DeleteHmacKey

    Deletes a given HMAC key. Key must be in an INACTIVE state.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteHmacKey(DeleteHmacKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteHmacKey(String accessId) + *
    • deleteHmacKey(String accessId) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteHmacKeyCallable() + *
    + *
    ListHmacKeys

    Lists HMAC keys under a given project with the additional filters provided.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listHmacKeys(ListHmacKeysRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listHmacKeys(ProjectName project) + *
    • listHmacKeys(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listHmacKeysPagedCallable() + *
    • listHmacKeysCallable() + *
    + *
    GetObject

    Retrieves an object's metadata.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getObject(GetObjectRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getObject(String bucket) + *
    • getObject(String bucket) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getObjectCallable() + *
    + *
    CreateNotification

    Creates a notification subscription for a given bucket. + * These notifications, when triggered, publish messages to the specified + * Pub/Sub topics. + * See https://cloud.google.com/storage/docs/pubsub-notifications.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createNotification(CreateNotificationRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createNotification(ProjectName parent) + *
    • createNotification(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createNotificationCallable() + *
    + *
    WriteObject

    Stores a new object and metadata. * - *

      - *
    1. A "flattened" method. With this type of method, the fields of the request type have been - * converted into function parameters. It may be the case that not all fields are available as - * parameters, and not every API method will have a flattened method entry point. - *
    2. A "request object" method. This type of method only takes one parameter, a request object, - * which must be constructed before the call. Not every API method will have a request object - * method. - *
    3. A "callable" method. This type of method takes no parameters and returns an immutable API - * callable object, which can be used to initiate calls to the service. - *
    + * An object can be written either in a single message stream or in a + * resumable sequence of message streams. To write using a single stream, + * the client should include in the first message of the stream an + * `WriteObjectSpec` describing the destination bucket, object, and any + * preconditions. Additionally, the final message must set 'finish_write' to + * true, or else it is an error. + * + * For a resumable write, the client should instead call + * `StartResumableWrite()`, populating a `WriteObjectSpec` into that request. + * They should then attach the returned `upload_id` to the first message of + * each following call to `WriteObject`. If the stream is closed before + * finishing the upload (either explicitly by the client or due to a network + * error or an error response from the server), the client should do as + * follows: + * - Check the result Status of the stream, to determine if writing can be + * resumed on this stream or must be restarted from scratch (by calling + * `StartResumableWrite()`). The resumable errors are DEADLINE_EXCEEDED, + * INTERNAL, and UNAVAILABLE. For each case, the client should use binary + * exponential backoff before retrying. Additionally, writes can be + * resumed after RESOURCE_EXHAUSTED errors, but only after taking + * appropriate measures, which may include reducing aggregate send rate + * across clients and/or requesting a quota increase for your project. + * - If the call to `WriteObject` returns `ABORTED`, that indicates + * concurrent attempts to update the resumable write, caused either by + * multiple racing clients or by a single client where the previous + * request was timed out on the client side but nonetheless reached the + * server. In this case the client should take steps to prevent further + * concurrent writes (e.g., increase the timeouts, stop using more than + * one process to perform the upload, etc.), and then should follow the + * steps below for resuming the upload. + * - For resumable errors, the client should call `QueryWriteStatus()` and + * then continue writing from the returned `persisted_size`. This may be + * less than the amount of data the client previously sent. Note also that + * it is acceptable to send data starting at an offset earlier than the + * returned `persisted_size`; in this case, the service will skip data at + * offsets that were already persisted (without checking that it matches + * the previously written data), and write only the data starting from the + * persisted offset. This behavior can make client-side handling simpler + * in some cases. + * + * The service will not view the object as complete until the client has + * sent a `WriteObjectRequest` with `finish_write` set to `true`. Sending any + * requests on a stream after sending a request with `finish_write` set to + * `true` will cause an error. The client **should** check the response it + * receives to determine how much data the service was able to commit and + * whether the service views the object as complete. + * + * Attempting to resume an already finalized object will result in an OK + * status, with a WriteObjectResponse containing the finalized object's + * metadata.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • writeObjectCallable() + *
    + *
    GetServiceAccount

    Retrieves the name of a project's Google Cloud Storage service account.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getServiceAccount(GetServiceAccountRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getServiceAccount(ProjectName project) + *
    • getServiceAccount(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getServiceAccountCallable() + *
    + *
    ListObjects

    Retrieves a list of objects matching the criteria.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listObjects(ListObjectsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listObjects(ProjectName parent) + *
    • listObjects(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listObjectsPagedCallable() + *
    • listObjectsCallable() + *
    + *
    GetBucket

    Returns metadata for the specified bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getBucket(GetBucketRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getBucket(BucketName name) + *
    • getBucket(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getBucketCallable() + *
    + *
    UpdateObject

    Updates an object's metadata. + * Equivalent to JSON API's storage.objects.patch.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateObject(UpdateObjectRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateObject(Object object) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateObjectCallable() + *
    + *
    GetIamPolicy

    Gets the IAM policy for a specified bucket or object. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getIamPolicy(GetIamPolicyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getIamPolicy(ResourceName resource) + *
    • getIamPolicy(String resource) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getIamPolicyCallable() + *
    + *
    QueryWriteStatus

    Determines the `persisted_size` for an object that is being written, which + * can then be used as the `write_offset` for the next `Write()` call. + * + * If the object does not exist (i.e., the object has been deleted, or the + * first `Write()` has not yet reached the service), this method returns the + * error `NOT_FOUND`. + * + * The client **may** call `QueryWriteStatus()` at any time to determine how + * much data has been processed for this object. This is useful if the + * client is buffering data and needs to know which data can be safely + * evicted. For any sequence of `QueryWriteStatus()` calls for a given + * object name, the sequence of returned `persisted_size` values will be + * non-decreasing.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • queryWriteStatus(QueryWriteStatusRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • queryWriteStatus(String uploadId) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • queryWriteStatusCallable() + *
    + *
    RewriteObject

    Rewrites a source object to a destination object. Optionally overrides + * metadata.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • rewriteObject(RewriteObjectRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • rewriteObjectCallable() + *
    + *
    LockBucketRetentionPolicy

    Locks retention policy on a bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • lockBucketRetentionPolicy(BucketName bucket) + *
    • lockBucketRetentionPolicy(String bucket) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • lockBucketRetentionPolicyCallable() + *
    + *
    CreateHmacKey

    Creates a new HMAC key for the given service account.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createHmacKey(CreateHmacKeyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createHmacKey(ProjectName project) + *
    • createHmacKey(String project) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createHmacKeyCallable() + *
    + *
    ComposeObject

    Concatenates a list of existing objects into a new object in the same + * bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • composeObject(ComposeObjectRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • composeObjectCallable() + *
    + *
    CancelResumableWrite

    Cancels an in-progress resumable upload.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • cancelResumableWrite(CancelResumableWriteRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • cancelResumableWrite(String uploadId) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • cancelResumableWriteCallable() + *
    + *
    UpdateBucket

    Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateBucket(UpdateBucketRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateBucket(Bucket bucket) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateBucketCallable() + *
    + *
    ReadObject

    Reads an object's data.

    		 + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • readObjectCallable() + *
    + *
    CreateBucket

    Creates a new bucket.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createBucket(CreateBucketRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createBucket(ProjectName parent) + *
    • createBucket(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createBucketCallable() + *
    + *
    GetNotification

    View a notification config.

    		 + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getNotification(GetNotificationRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getNotification(BucketName name) + *
    • getNotification(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getNotificationCallable() + *
    + *
    * *

    See the individual methods for example code. * From ab1c642379387780cf2e479332485417a0904816 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 10 Nov 2023 09:32:42 -0500 Subject: [PATCH 11/21] test change to ci --- .github/workflows/ci.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 4b86e4b5d3..1bc6059398 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -69,7 +69,7 @@ jobs: shell: bash run: | set -x - export JAVA_HOME=$JAVA11_HOME + export JAVA_HOME=$JAVA_HOME export PATH=${JAVA_HOME}/bin:$PATH # Maven surefire plugin lets us to specify the JVM when running tests via # the "jvm" system property. From adf7d97beff5cfa98408d294604babfa475dfd08 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 10 Nov 2023 10:03:09 -0500 Subject: [PATCH 12/21] update ci comment --- .github/workflows/ci.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 1bc6059398..0719b66995 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -54,7 +54,7 @@ jobs: runs-on: ubuntu-22.04 steps: - uses: actions/checkout@v3 - # Java 8 tests uses JDK 11 to compile and JDK 8 to run tests. + # Java 8 tests uses JDK 17 to compile and JDK 8 to run tests. - uses: actions/setup-java@v3 with: java-version: 8 From d6f758d21ae445e7f5094e05aafb8fd19e8f92b8 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 10 Nov 2023 11:18:56 -0500 Subject: [PATCH 13/21] update to use linkedhashmap for consistent ordering --- .../comment/ServiceClientCommentComposer.java | 6 +- .../goldens/DeprecatedServiceClient.golden | 12 +- .../composer/grpc/goldens/EchoClient.golden | 62 +-- .../grpc/goldens/IdentityClient.golden | 50 +- .../grpc/goldens/MessagingClient.golden | 158 +++---- .../grpcrest/goldens/EchoClient.golden | 68 +-- .../grpcrest/goldens/WickedClient.golden | 20 +- .../cloud/asset/v1/AssetServiceClient.java | 328 ++++++------- .../data/v2/BaseBigtableDataClient.java | 116 ++--- .../compute/v1small/AddressesClient.java | 40 +- .../com/google/iam/v1/IAMPolicyClient.java | 34 +- .../kms/v1/KeyManagementServiceClient.java | 416 ++++++++-------- .../library/v1/LibraryServiceClient.java | 160 +++---- .../google/cloud/logging/v2/ConfigClient.java | 446 +++++++++--------- .../cloud/logging/v2/LoggingClient.java | 88 ++-- .../cloud/logging/v2/MetricsClient.java | 62 +-- .../cloud/pubsub/v1/SchemaServiceClient.java | 168 +++---- .../pubsub/v1/SubscriptionAdminClient.java | 388 +++++++-------- .../cloud/pubsub/v1/TopicAdminClient.java | 166 +++---- .../cloud/redis/v1beta1/CloudRedisClient.java | 182 +++---- .../com/google/storage/v2/StorageClient.java | 418 ++++++++-------- 21 files changed, 1696 insertions(+), 1692 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index 3e6c519e77..d981983171 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -27,6 +27,7 @@ import java.util.Arrays; import java.util.Collections; import java.util.List; +import java.util.LinkedHashMap; import java.util.Map; import java.util.Optional; import java.util.stream.Collectors; @@ -131,7 +132,10 @@ public static List createClassHeaderComments( method -> { String description = method.getDescription(); return description != null ? description : ""; - }))); + }, + (existingValue, newValue) -> existingValue, + LinkedHashMap::new + ))); // Build a list of MethodAndVariants to create the table List methodAndVariantsList = new ArrayList<>(); diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden index 1927fa0a4b..8fdb80509c 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden @@ -36,30 +36,30 @@ import javax.annotation.Generated; * Description * Method Variants * - * SlowFibonacci + * FastFibonacci *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • slowFibonacci(FibonacciRequest request) + *
    • fastFibonacci(FibonacciRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • slowFibonacciCallable() + *
    • fastFibonacciCallable() *
    * * * - * FastFibonacci + * SlowFibonacci *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • fastFibonacci(FibonacciRequest request) + *
    • slowFibonacci(FibonacciRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • fastFibonacciCallable() + *
    • slowFibonacciCallable() *
    * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden index af92656e6d..22e3c390bf 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden @@ -83,110 +83,110 @@ import javax.annotation.Generated; * * * - * Collect + * Expand *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • collectCallable() + *
    • expandCallable() *
    * * * - * Expand + * Collect *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • expandCallable() + *
    • collectCallable() *
    * * * - * PagedExpand + * Chat *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • pagedExpand(PagedExpandRequest request) - *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • pagedExpandPagedCallable() - *
    • pagedExpandCallable() + *
    • chatCallable() *
    * * * - * Chat + * ChatAgain *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • chatCallable() + *
    • chatAgainCallable() *
    * * * - * Block + * PagedExpand *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • block(BlockRequest request) + *
    • pagedExpand(PagedExpandRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • blockCallable() + *
    • pagedExpandPagedCallable() + *
    • pagedExpandCallable() *
    * * * - * Wait + * SimplePagedExpand *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • waitAsync(WaitRequest request) + *
    • simplePagedExpand(PagedExpandRequest request) *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • waitAsync(Duration ttl) - *
    • waitAsync(Timestamp endTime) + *
    • simplePagedExpand() *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • waitOperationCallable() - *
    • waitCallable() + *
    • simplePagedExpandPagedCallable() + *
    • simplePagedExpandCallable() *
    * * * - * SimplePagedExpand + * Wait *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • simplePagedExpand(PagedExpandRequest request) + *
    • waitAsync(WaitRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    *
      - *
    • simplePagedExpand() + *
    • waitAsync(Duration ttl) + *
    • waitAsync(Timestamp endTime) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • simplePagedExpandPagedCallable() - *
    • simplePagedExpandCallable() + *
    • waitOperationCallable() + *
    • waitCallable() *
    * * * - * ChatAgain + * Block *

    * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • block(BlockRequest request) + *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • chatAgainCallable() + *
    • blockCallable() *
    * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden index 2199646ef3..8ae4f03a5c 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden @@ -46,21 +46,6 @@ import javax.annotation.Generated; * Description * Method Variants * - * ListUsers - *

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listUsers(ListUsersRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listUsersPagedCallable() - *
    • listUsersCallable() - *
    - * - * - * * CreateUser *

    * @@ -81,21 +66,21 @@ import javax.annotation.Generated; * * * - * DeleteUser + * GetUser *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteUser(DeleteUserRequest request) + *
    • getUser(GetUserRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteUser(UserName name) - *
    • deleteUser(String name) + *
    • getUser(UserName name) + *
    • getUser(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteUserCallable() + *
    • getUserCallable() *
    * * @@ -114,21 +99,36 @@ import javax.annotation.Generated; * * * - * GetUser + * DeleteUser *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getUser(GetUserRequest request) + *
    • deleteUser(DeleteUserRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getUser(UserName name) - *
    • getUser(String name) + *
    • deleteUser(UserName name) + *
    • deleteUser(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getUserCallable() + *
    • deleteUserCallable() + *
    + * + * + * + * ListUsers + *

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listUsers(ListUsersRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listUsersPagedCallable() + *
    • listUsersCallable() *
    * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden index a19db5582a..5ccf73e2ac 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden @@ -53,41 +53,39 @@ import javax.annotation.Generated; * Description * Method Variants * - * SearchBlurbs + * CreateRoom *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • searchBlurbsAsync(SearchBlurbsRequest request) + *
    • createRoom(CreateRoomRequest request) *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • searchBlurbsAsync(String query) + *
    • createRoom(String displayName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • searchBlurbsOperationCallable() - *
    • searchBlurbsCallable() + *
    • createRoomCallable() *
    * * * - * Connect + * GetRoom *

    * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • connectCallable() + *
    • getRoom(GetRoomRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getRoom(RoomName name) + *
    • getRoom(String name) *
    - * - * - * - * SendBlurbs - *

    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • sendBlurbsCallable() + *
    • getRoomCallable() *
    * * @@ -106,179 +104,181 @@ import javax.annotation.Generated; * * * - * GetBlurb + * DeleteRoom *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getBlurb(GetBlurbRequest request) + *
    • deleteRoom(DeleteRoomRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getBlurb(BlurbName name) - *
    • getBlurb(String name) + *
    • deleteRoom(RoomName name) + *
    • deleteRoom(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getBlurbCallable() + *
    • deleteRoomCallable() *
    * * * - * GetRoom + * ListRooms *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getRoom(GetRoomRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getRoom(RoomName name) - *
    • getRoom(String name) + *
    • listRooms(ListRoomsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getRoomCallable() + *
    • listRoomsPagedCallable() + *
    • listRoomsCallable() *
    * * * - * UpdateBlurb + * CreateBlurb *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateBlurb(UpdateBlurbRequest request) + *
    • createBlurb(CreateBlurbRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createBlurb(ProfileName parent) + *
    • createBlurb(ProfileName parent) + *
    • createBlurb(RoomName parent) + *
    • createBlurb(RoomName parent) + *
    • createBlurb(String parent) + *
    • createBlurb(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateBlurbCallable() + *
    • createBlurbCallable() *
    * * * - * ListBlurbs + * GetBlurb *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listBlurbs(ListBlurbsRequest request) + *
    • getBlurb(GetBlurbRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listBlurbs(ProfileName parent) - *
    • listBlurbs(RoomName parent) - *
    • listBlurbs(String parent) + *
    • getBlurb(BlurbName name) + *
    • getBlurb(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listBlurbsPagedCallable() - *
    • listBlurbsCallable() + *
    • getBlurbCallable() *
    * * * - * StreamBlurbs + * UpdateBlurb *

    * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateBlurb(UpdateBlurbRequest request) + *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • streamBlurbsCallable() + *
    • updateBlurbCallable() *
    * * * - * DeleteRoom + * DeleteBlurb *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteRoom(DeleteRoomRequest request) + *
    • deleteBlurb(DeleteBlurbRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteRoom(RoomName name) - *
    • deleteRoom(String name) + *
    • deleteBlurb(BlurbName name) + *
    • deleteBlurb(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteRoomCallable() + *
    • deleteBlurbCallable() *
    * * * - * ListRooms + * ListBlurbs *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listRooms(ListRoomsRequest request) + *
    • listBlurbs(ListBlurbsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listBlurbs(ProfileName parent) + *
    • listBlurbs(RoomName parent) + *
    • listBlurbs(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listRoomsPagedCallable() - *
    • listRoomsCallable() + *
    • listBlurbsPagedCallable() + *
    • listBlurbsCallable() *
    * * * - * CreateRoom + * SearchBlurbs *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createRoom(CreateRoomRequest request) + *
    • searchBlurbsAsync(SearchBlurbsRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    *
      - *
    • createRoom(String displayName) + *
    • searchBlurbsAsync(String query) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createRoomCallable() + *
    • searchBlurbsOperationCallable() + *
    • searchBlurbsCallable() *
    * * * - * CreateBlurb + * StreamBlurbs *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createBlurb(CreateBlurbRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createBlurb(ProfileName parent) - *
    • createBlurb(ProfileName parent) - *
    • createBlurb(RoomName parent) - *
    • createBlurb(RoomName parent) - *
    • createBlurb(String parent) - *
    • createBlurb(String parent) - *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createBlurbCallable() + *
    • streamBlurbsCallable() *
    * * * - * DeleteBlurb + * SendBlurbs *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteBlurb(DeleteBlurbRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteBlurb(BlurbName name) - *
    • deleteBlurb(String name) + *
    • sendBlurbsCallable() *
    + * + * + * + * Connect + *

    + * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteBlurbCallable() + *
    • connectCallable() *
    * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index 0c26809459..ea3ff6a283 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -78,20 +78,6 @@ import javax.annotation.Generated; * * * - * NoBinding - *

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • noBinding(EchoRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • noBindingCallable() - *
    - * - * - * * Expand *

    * @@ -117,26 +103,21 @@ import javax.annotation.Generated; * * * - * Chat + * SimplePagedExpand *

    * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • chatCallable() + *
    • simplePagedExpand(PagedExpandRequest request) *
    - * - * - * - * Block - *

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • block(BlockRequest request) + *
    • simplePagedExpand() *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • blockCallable() + *
    • simplePagedExpandPagedCallable() + *
    • simplePagedExpandCallable() *
    * * @@ -161,21 +142,16 @@ import javax.annotation.Generated; * * * - * SimplePagedExpand + * Block *

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • simplePagedExpand(PagedExpandRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • simplePagedExpand() + *
    • block(BlockRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • simplePagedExpandPagedCallable() - *
    • simplePagedExpandCallable() + *
    • blockCallable() *
    * * @@ -208,6 +184,30 @@ import javax.annotation.Generated; * * * + * Chat + *

    + * + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • chatCallable() + *
    + * + * + * + * NoBinding + *

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • noBinding(EchoRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • noBindingCallable() + *
    + * + * + * * UpdateCase *

    * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden index 7637bff29a..a7d9c00ec8 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden @@ -38,36 +38,36 @@ import javax.annotation.Generated; * Description * Method Variants * - * BrainstormEvilPlans + * CraftEvilPlan *

    * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • craftEvilPlan(EvilRequest request) + *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • brainstormEvilPlansCallable() + *
    • craftEvilPlanCallable() *
    * * * - * PersuadeEvilPlan + * BrainstormEvilPlans *

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • persuadeEvilPlanCallable() + *
    • brainstormEvilPlansCallable() *
    * * * - * CraftEvilPlan + * PersuadeEvilPlan *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • craftEvilPlan(EvilRequest request) - *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • craftEvilPlanCallable() + *
    • persuadeEvilPlanCallable() *
    * * diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index 07eb2dab2c..7812a8f8a9 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -75,38 +75,86 @@ * Description * Method Variants * - * UpdateFeed - *

    Updates an asset feed configuration.

    + * ExportAssets + *

    Exports assets with time and resource types to a given Cloud Storage + * location/BigQuery table. For Cloud Storage location destinations, the + * output format is newline-delimited JSON. Each line represents a + * [google.cloud.asset.v1.Asset][google.cloud.asset.v1.Asset] in the JSON format; for BigQuery table + * destinations, the output table stores the fields in asset Protobuf as + * columns. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API, + * which allows you to keep track of the export. We recommend intervals of at + * least 2 seconds with exponential retry to poll the export operation result. + * For regular-size resource parent, the export operation usually finishes + * within 5 minutes.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateFeed(UpdateFeedRequest request) + *
    • exportAssetsAsync(ExportAssetsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • exportAssetsOperationCallable() + *
    • exportAssetsCallable() + *
    + * + * + * + * ListAssets + *

    Lists assets with time and resource types and returns paged results in + * response.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listAssets(ListAssetsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateFeed(Feed feed) + *
    • listAssets(ResourceName parent) + *
    • listAssets(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateFeedCallable() + *
    • listAssetsPagedCallable() + *
    • listAssetsCallable() *
    * * * - * ListFeeds - *

    Lists all asset feeds in a parent project/folder/organization.

    + * BatchGetAssetsHistory + *

    Batch gets the update history of assets that overlap a time window. + * For IAM_POLICY content, this API outputs history when the asset and its + * attached IAM POLICY both exist. This can create gaps in the output history. + * Otherwise, this API outputs history with asset in both non-delete or + * deleted status. + * If a specified asset does not exist, this API returns an INVALID_ARGUMENT + * error.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listFeeds(ListFeedsRequest request) + *
    • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • batchGetAssetsHistoryCallable() + *
    + * + * + * + * CreateFeed + *

    Creates a feed in a parent project/folder/organization to listen to its + * asset updates.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createFeed(CreateFeedRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listFeeds(String parent) + *
    • createFeed(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listFeedsCallable() + *
    • createFeedCallable() *
    * * @@ -130,141 +178,157 @@ * * * - * BatchGetAssetsHistory - *

    Batch gets the update history of assets that overlap a time window. - * For IAM_POLICY content, this API outputs history when the asset and its - * attached IAM POLICY both exist. This can create gaps in the output history. - * Otherwise, this API outputs history with asset in both non-delete or - * deleted status. - * If a specified asset does not exist, this API returns an INVALID_ARGUMENT - * error.

    + * ListFeeds + *

    Lists all asset feeds in a parent project/folder/organization.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) + *
    • listFeeds(ListFeedsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listFeeds(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • batchGetAssetsHistoryCallable() + *
    • listFeedsCallable() *
    * * * - * AnalyzeIamPolicy - *

    Analyzes IAM policies to answer which identities have what accesses on - * which resources.

    + * UpdateFeed + *

    Updates an asset feed configuration.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • analyzeIamPolicy(AnalyzeIamPolicyRequest request) + *
    • updateFeed(UpdateFeedRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateFeed(Feed feed) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • analyzeIamPolicyCallable() + *
    • updateFeedCallable() *
    * * * - * ExportAssets - *

    Exports assets with time and resource types to a given Cloud Storage - * location/BigQuery table. For Cloud Storage location destinations, the - * output format is newline-delimited JSON. Each line represents a - * [google.cloud.asset.v1.Asset][google.cloud.asset.v1.Asset] in the JSON format; for BigQuery table - * destinations, the output table stores the fields in asset Protobuf as - * columns. This API implements the [google.longrunning.Operation][google.longrunning.Operation] API, - * which allows you to keep track of the export. We recommend intervals of at - * least 2 seconds with exponential retry to poll the export operation result. - * For regular-size resource parent, the export operation usually finishes - * within 5 minutes.

    + * DeleteFeed + *

    Deletes an asset feed.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • exportAssetsAsync(ExportAssetsRequest request) + *
    • deleteFeed(DeleteFeedRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteFeed(FeedName name) + *
    • deleteFeed(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • exportAssetsOperationCallable() - *
    • exportAssetsCallable() + *
    • deleteFeedCallable() *
    * * * - * GetSavedQuery - *

    Gets details about a saved query.

    + * SearchAllResources + *

    Searches all Cloud resources within the specified scope, such as a project, + * folder, or organization. The caller must be granted the + * `cloudasset.assets.searchAllResources` permission on the desired scope, + * otherwise the request will be rejected.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getSavedQuery(GetSavedQueryRequest request) + *
    • searchAllResources(SearchAllResourcesRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getSavedQuery(SavedQueryName name) - *
    • getSavedQuery(String name) + *
    • searchAllResources(String scope) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getSavedQueryCallable() + *
    • searchAllResourcesPagedCallable() + *
    • searchAllResourcesCallable() *
    * * * - * CreateSavedQuery - *

    Creates a saved query in a parent project/folder/organization.

    + * SearchAllIamPolicies + *

    Searches all IAM policies within the specified scope, such as a project, + * folder, or organization. The caller must be granted the + * `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, + * otherwise the request will be rejected.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createSavedQuery(CreateSavedQueryRequest request) + *
    • searchAllIamPolicies(SearchAllIamPoliciesRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createSavedQuery(FolderName parent) - *
    • createSavedQuery(OrganizationName parent) - *
    • createSavedQuery(ProjectName parent) - *
    • createSavedQuery(String parent) + *
    • searchAllIamPolicies(String scope) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createSavedQueryCallable() + *
    • searchAllIamPoliciesPagedCallable() + *
    • searchAllIamPoliciesCallable() *
    * * * - * ListAssets - *

    Lists assets with time and resource types and returns paged results in - * response.

    + * AnalyzeIamPolicy + *

    Analyzes IAM policies to answer which identities have what accesses on + * which resources.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listAssets(ListAssetsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listAssets(ResourceName parent) - *
    • listAssets(String parent) + *
    • analyzeIamPolicy(AnalyzeIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listAssetsPagedCallable() - *
    • listAssetsCallable() + *
    • analyzeIamPolicyCallable() *
    * * * - * DeleteFeed - *

    Deletes an asset feed.

    + * AnalyzeIamPolicyLongrunning + *

    Analyzes IAM policies asynchronously to answer which identities have what + * accesses on which resources, and writes the analysis results to a Google + * Cloud Storage or a BigQuery destination. For Cloud Storage destination, the + * output format is the JSON format that represents a + * [AnalyzeIamPolicyResponse][google.cloud.asset.v1.AnalyzeIamPolicyResponse]. This method implements the + * [google.longrunning.Operation][google.longrunning.Operation], which allows you to track the operation + * status. We recommend intervals of at least 2 seconds with exponential + * backoff retry to poll the operation result. The metadata contains the + * metadata for the long-running operation.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteFeed(DeleteFeedRequest request) + *
    • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteFeed(FeedName name) - *
    • deleteFeed(String name) + *
    • analyzeIamPolicyLongrunningOperationCallable() + *
    • analyzeIamPolicyLongrunningCallable() + *
    + * + * + * + * AnalyzeMove + *

    Analyze moving a resource to a specified destination without kicking off + * the actual move. The analysis is best effort depending on the user's + * permissions of viewing different hierarchical policies and configurations. + * The policies and configuration are subject to change before the actual + * resource migration takes place.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • analyzeMove(AnalyzeMoveRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteFeedCallable() + *
    • analyzeMoveCallable() *
    * * @@ -296,84 +360,42 @@ * * * - * DeleteSavedQuery - *

    Deletes a saved query.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteSavedQuery(DeleteSavedQueryRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSavedQuery(SavedQueryName name) - *
    • deleteSavedQuery(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteSavedQueryCallable() - *
    - * - * - * - * SearchAllResources - *

    Searches all Cloud resources within the specified scope, such as a project, - * folder, or organization. The caller must be granted the - * `cloudasset.assets.searchAllResources` permission on the desired scope, - * otherwise the request will be rejected.

    + * CreateSavedQuery + *

    Creates a saved query in a parent project/folder/organization.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • searchAllResources(SearchAllResourcesRequest request) + *
    • createSavedQuery(CreateSavedQueryRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • searchAllResources(String scope) + *
    • createSavedQuery(FolderName parent) + *
    • createSavedQuery(OrganizationName parent) + *
    • createSavedQuery(ProjectName parent) + *
    • createSavedQuery(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • searchAllResourcesPagedCallable() - *
    • searchAllResourcesCallable() + *
    • createSavedQueryCallable() *
    * * * - * UpdateSavedQuery - *

    Updates a saved query.

    + * GetSavedQuery + *

    Gets details about a saved query.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateSavedQuery(UpdateSavedQueryRequest request) + *
    • getSavedQuery(GetSavedQueryRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateSavedQuery(SavedQuery savedQuery) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateSavedQueryCallable() - *
    - * - * - * - * AnalyzeIamPolicyLongrunning - *

    Analyzes IAM policies asynchronously to answer which identities have what - * accesses on which resources, and writes the analysis results to a Google - * Cloud Storage or a BigQuery destination. For Cloud Storage destination, the - * output format is the JSON format that represents a - * [AnalyzeIamPolicyResponse][google.cloud.asset.v1.AnalyzeIamPolicyResponse]. This method implements the - * [google.longrunning.Operation][google.longrunning.Operation], which allows you to track the operation - * status. We recommend intervals of at least 2 seconds with exponential - * backoff retry to poll the operation result. The metadata contains the - * metadata for the long-running operation.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) + *
    • getSavedQuery(SavedQueryName name) + *
    • getSavedQuery(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • analyzeIamPolicyLongrunningOperationCallable() - *
    • analyzeIamPolicyLongrunningCallable() + *
    • getSavedQueryCallable() *
    * * @@ -400,75 +422,53 @@ * * * - * CreateFeed - *

    Creates a feed in a parent project/folder/organization to listen to its - * asset updates.

    + * UpdateSavedQuery + *

    Updates a saved query.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createFeed(CreateFeedRequest request) + *
    • updateSavedQuery(UpdateSavedQueryRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createFeed(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createFeedCallable() - *
    - * - * - * - * BatchGetEffectiveIamPolicies - *

    Gets effective IAM policies for a batch of resources.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) + *
    • updateSavedQuery(SavedQuery savedQuery) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • batchGetEffectiveIamPoliciesCallable() + *
    • updateSavedQueryCallable() *
    * * * - * SearchAllIamPolicies - *

    Searches all IAM policies within the specified scope, such as a project, - * folder, or organization. The caller must be granted the - * `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, - * otherwise the request will be rejected.

    + * DeleteSavedQuery + *

    Deletes a saved query.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • searchAllIamPolicies(SearchAllIamPoliciesRequest request) + *
    • deleteSavedQuery(DeleteSavedQueryRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • searchAllIamPolicies(String scope) + *
    • deleteSavedQuery(SavedQueryName name) + *
    • deleteSavedQuery(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • searchAllIamPoliciesPagedCallable() - *
    • searchAllIamPoliciesCallable() + *
    • deleteSavedQueryCallable() *
    * * * - * AnalyzeMove - *

    Analyze moving a resource to a specified destination without kicking off - * the actual move. The analysis is best effort depending on the user's - * permissions of viewing different hierarchical policies and configurations. - * The policies and configuration are subject to change before the actual - * resource migration takes place.

    + * BatchGetEffectiveIamPolicies + *

    Gets effective IAM policies for a batch of resources.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • analyzeMove(AnalyzeMoveRequest request) + *
    • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • analyzeMoveCallable() + *
    • batchGetEffectiveIamPoliciesCallable() *
    * * diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index d01885145f..34d1f7b676 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -77,40 +77,6 @@ * Description * Method Variants * - * MutateRows - *

    Mutates multiple rows in a batch. Each individual row is mutated - * atomically as in MutateRow, but the entire batch is not executed - * atomically.

    - * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • mutateRowsCallable() - *
    - * - * - * - * PingAndWarm - *

    Warm up associated instance metadata for this connection. - * This call is not required but may be useful for connection keep-alive.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • pingAndWarm(PingAndWarmRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • pingAndWarm(InstanceName name) - *
    • pingAndWarm(String name) - *
    • pingAndWarm(InstanceName name) - *
    • pingAndWarm(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • pingAndWarmCallable() - *
    - * - * - * * ReadRows *

    Streams back the contents of all requested rows in key order, optionally * applying the same Reader filter to each. Depending on their size, @@ -125,27 +91,15 @@ * * * - * ReadModifyWriteRow - *

    Modifies a row atomically on the server. The method reads the latest - * existing timestamp and value from the specified columns and writes a new - * entry based on pre-defined read/modify/write rules. The new value for the - * timestamp is the greater of the existing timestamp or the current server - * time. The method returns the new contents of all modified cells.

    + * SampleRowKeys + *

    Returns a sample of row keys in the table. The returned row keys will + * delimit contiguous sections of the table of approximately equal size, + * which can be used to break up the data for distributed tasks like + * mapreduces.

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • readModifyWriteRow(ReadModifyWriteRowRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • readModifyWriteRow(TableName tableName) - *
    • readModifyWriteRow(String tableName) - *
    • readModifyWriteRow(TableName tableName) - *
    • readModifyWriteRow(String tableName) - *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • readModifyWriteRowCallable() + *
    • sampleRowKeysCallable() *
    * * @@ -172,15 +126,14 @@ * * * - * SampleRowKeys - *

    Returns a sample of row keys in the table. The returned row keys will - * delimit contiguous sections of the table of approximately equal size, - * which can be used to break up the data for distributed tasks like - * mapreduces.

    + * MutateRows + *

    Mutates multiple rows in a batch. Each individual row is mutated + * atomically as in MutateRow, but the entire batch is not executed + * atomically.

    * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • sampleRowKeysCallable() + *
    • mutateRowsCallable() *
    * * @@ -205,6 +158,53 @@ * * * + * + * PingAndWarm + *

    Warm up associated instance metadata for this connection. + * This call is not required but may be useful for connection keep-alive.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • pingAndWarm(PingAndWarmRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • pingAndWarm(InstanceName name) + *
    • pingAndWarm(String name) + *
    • pingAndWarm(InstanceName name) + *
    • pingAndWarm(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • pingAndWarmCallable() + *
    + * + * + * + * ReadModifyWriteRow + *

    Modifies a row atomically on the server. The method reads the latest + * existing timestamp and value from the specified columns and writes a new + * entry based on pre-defined read/modify/write rules. The new value for the + * timestamp is the greater of the existing timestamp or the current server + * time. The method returns the new contents of all modified cells.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • readModifyWriteRow(ReadModifyWriteRowRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • readModifyWriteRow(TableName tableName) + *
    • readModifyWriteRow(String tableName) + *
    • readModifyWriteRow(TableName tableName) + *
    • readModifyWriteRow(String tableName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • readModifyWriteRowCallable() + *
    + * + * * * *

    See the individual methods for example code. diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index 4aec80ab53..70a5281f75 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -69,40 +69,40 @@ * Description * Method Variants * - * Delete - *

    Deletes the specified address resource.

    + * AggregatedList + *

    Retrieves an aggregated list of addresses.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteAsync(DeleteAddressRequest request) + *
    • aggregatedList(AggregatedListAddressesRequest request) *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteAsync(String project) + *
    • aggregatedList(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteOperationCallable() - *
    • deleteCallable() + *
    • aggregatedListPagedCallable() + *
    • aggregatedListCallable() *
    * * * - * List - *

    Retrieves a list of addresses contained within the specified region.

    + * Delete + *

    Deletes the specified address resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • list(ListAddressesRequest request) + *
    • deleteAsync(DeleteAddressRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    *
      - *
    • list(String project) + *
    • deleteAsync(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listPagedCallable() - *
    • listCallable() + *
    • deleteOperationCallable() + *
    • deleteCallable() *
    * * @@ -126,21 +126,21 @@ * * * - * AggregatedList - *

    Retrieves an aggregated list of addresses.

    + * List + *

    Retrieves a list of addresses contained within the specified region.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • aggregatedList(AggregatedListAddressesRequest request) + *
    • list(ListAddressesRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • aggregatedList(String project) + *
    • list(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • aggregatedListPagedCallable() - *
    • aggregatedListCallable() + *
    • listPagedCallable() + *
    • listCallable() *
    * * diff --git a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java index 89a94e6fa2..83f807c087 100644 --- a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java +++ b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java @@ -78,6 +78,23 @@ * Description * Method Variants * + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • setIamPolicy(SetIamPolicyRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • setIamPolicyCallable() + *
    + * + * + * * GetIamPolicy *

    Gets the access control policy for a resource. * Returns an empty policy if the resource exists and does not have a policy @@ -113,23 +130,6 @@ * * * - * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces any - * existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • setIamPolicy(SetIamPolicyRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • setIamPolicyCallable() - *
    - * - * * * *

    See the individual methods for example code. diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index 228cd0f025..1d432936b4 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -86,85 +86,62 @@ * Description * Method Variants * - * UpdateCryptoKey - *

    Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • updateCryptoKey(UpdateCryptoKeyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateCryptoKey(CryptoKey cryptoKey) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateCryptoKeyCallable() - *
    - * - * - * - * Decrypt - *

    Decrypts data that was protected by - * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The - * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    + * ListKeyRings + *

    Lists [KeyRings][google.cloud.kms.v1.KeyRing].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • decrypt(DecryptRequest request) + *
    • listKeyRings(ListKeyRingsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • decrypt(CryptoKeyName name) - *
    • decrypt(String name) + *
    • listKeyRings(LocationName parent) + *
    • listKeyRings(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • decryptCallable() + *
    • listKeyRingsPagedCallable() + *
    • listKeyRingsCallable() *
    * * * - * ListKeyRings - *

    Lists [KeyRings][google.cloud.kms.v1.KeyRing].

    + * ListCryptoKeys + *

    Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listKeyRings(ListKeyRingsRequest request) + *
    • listCryptoKeys(ListCryptoKeysRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listKeyRings(LocationName parent) - *
    • listKeyRings(String parent) + *
    • listCryptoKeys(KeyRingName parent) + *
    • listCryptoKeys(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listKeyRingsPagedCallable() - *
    • listKeyRingsCallable() + *
    • listCryptoKeysPagedCallable() + *
    • listCryptoKeysCallable() *
    * * * - * AsymmetricDecrypt - *

    Decrypts data that was encrypted with a public key retrieved from - * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] - * corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] - * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] - * ASYMMETRIC_DECRYPT.

    + * ListCryptoKeyVersions + *

    Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • asymmetricDecrypt(AsymmetricDecryptRequest request) + *
    • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • asymmetricDecrypt(CryptoKeyVersionName name) - *
    • asymmetricDecrypt(String name) + *
    • listCryptoKeyVersions(CryptoKeyName parent) + *
    • listCryptoKeyVersions(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • asymmetricDecryptCallable() + *
    • listCryptoKeyVersionsPagedCallable() + *
    • listCryptoKeyVersionsCallable() *
    * * @@ -189,63 +166,62 @@ * * * - * GetImportJob - *

    Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].

    + * GetKeyRing + *

    Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getImportJob(GetImportJobRequest request) + *
    • getKeyRing(GetKeyRingRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getImportJob(ImportJobName name) - *
    • getImportJob(String name) + *
    • getKeyRing(KeyRingName name) + *
    • getKeyRing(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getImportJobCallable() + *
    • getKeyRingCallable() *
    * * * - * CreateImportJob - *

    Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a - * [KeyRing][google.cloud.kms.v1.KeyRing]. - * - * [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is - * required.

    + * GetCryptoKey + *

    Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as + * well as its [primary][google.cloud.kms.v1.CryptoKey.primary] + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createImportJob(CreateImportJobRequest request) + *
    • getCryptoKey(GetCryptoKeyRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createImportJob(KeyRingName parent) - *
    • createImportJob(String parent) + *
    • getCryptoKey(CryptoKeyName name) + *
    • getCryptoKey(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createImportJobCallable() + *
    • getCryptoKeyCallable() *
    * * * - * ImportCryptoKeyVersion - *

    Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into - * an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the wrapped - * key material provided in the request. - * - * The version ID will be assigned the next sequential id within the - * [CryptoKey][google.cloud.kms.v1.CryptoKey].

    + * GetCryptoKeyVersion + *

    Returns metadata for a given + * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) + *
    • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getCryptoKeyVersion(CryptoKeyVersionName name) + *
    • getCryptoKeyVersion(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • importCryptoKeyVersionCallable() + *
    • getCryptoKeyVersionCallable() *
    * * @@ -274,30 +250,21 @@ * * * - * GetLocation - *

    Gets information about a location.

    + * GetImportJob + *

    Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getLocation(GetLocationRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getLocationCallable() + *
    • getImportJob(GetImportJobRequest request) *
    - * - * - * - * TestIamPermissions - *

    This is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • getImportJob(ImportJobName name) + *
    • getImportJob(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • getImportJobCallable() *
    * * @@ -322,40 +289,6 @@ * * * - * GetKeyRing - *

    Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getKeyRing(GetKeyRingRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getKeyRing(KeyRingName name) - *
    • getKeyRing(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getKeyRingCallable() - *
    - * - * - * - * ListLocations - *

    Lists information about the supported locations for this service.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listLocations(ListLocationsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listLocationsPagedCallable() - *
    • listLocationsCallable() - *
    - * - * - * * CreateCryptoKey *

    Create a new [CryptoKey][google.cloud.kms.v1.CryptoKey] within a * [KeyRing][google.cloud.kms.v1.KeyRing]. @@ -404,97 +337,62 @@ * * * - * UpdateCryptoKeyPrimaryVersion - *

    Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that - * will be used in - * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. + * ImportCryptoKeyVersion + *

    Imports a new [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] into + * an existing [CryptoKey][google.cloud.kms.v1.CryptoKey] using the wrapped + * key material provided in the request. * - * Returns an error if called on an asymmetric key.

    + * The version ID will be assigned the next sequential id within the + * [CryptoKey][google.cloud.kms.v1.CryptoKey].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateCryptoKeyPrimaryVersion(CryptoKeyName name) - *
    • updateCryptoKeyPrimaryVersion(String name) + *
    • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateCryptoKeyPrimaryVersionCallable() + *
    • importCryptoKeyVersionCallable() *
    * * * - * DestroyCryptoKeyVersion - *

    Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for - * destruction. - * - * Upon calling this method, - * [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will - * be set to - * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] - * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will - * be set to a time 24 hours in the future, at which point the - * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be changed to - * [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], - * and the key material will be irrevocably destroyed. + * CreateImportJob + *

    Create a new [ImportJob][google.cloud.kms.v1.ImportJob] within a + * [KeyRing][google.cloud.kms.v1.KeyRing]. * - * Before the - * [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is - * reached, - * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] - * may be called to reverse the process.

    + * [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is + * required.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) + *
    • createImportJob(CreateImportJobRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • destroyCryptoKeyVersion(CryptoKeyVersionName name) - *
    • destroyCryptoKeyVersion(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • destroyCryptoKeyVersionCallable() - *
    - * - * - * - * GetIamPolicy - *

    Gets the access control policy for a resource. ADDED ONLY FOR MIXIN TESTS. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • createImportJob(KeyRingName parent) + *
    • createImportJob(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • createImportJobCallable() *
    * * * - * GetCryptoKeyVersion - *

    Returns metadata for a given - * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    + * UpdateCryptoKey + *

    Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) + *
    • updateCryptoKey(UpdateCryptoKeyRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getCryptoKeyVersion(CryptoKeyVersionName name) - *
    • getCryptoKeyVersion(String name) + *
    • updateCryptoKey(CryptoKey cryptoKey) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getCryptoKeyVersionCallable() + *
    • updateCryptoKeyCallable() *
    * * @@ -528,22 +426,46 @@ * * * - * ListCryptoKeyVersions - *

    Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].

    + * Encrypt + *

    Encrypts data, so that it can only be recovered by a call to + * [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) + *
    • encrypt(EncryptRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listCryptoKeyVersions(CryptoKeyName parent) - *
    • listCryptoKeyVersions(String parent) + *
    • encrypt(ResourceName name) + *
    • encrypt(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listCryptoKeyVersionsPagedCallable() - *
    • listCryptoKeyVersionsCallable() + *
    • encryptCallable() + *
    + * + * + * + * Decrypt + *

    Decrypts data that was protected by + * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. The + * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be + * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • decrypt(DecryptRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • decrypt(CryptoKeyName name) + *
    • decrypt(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • decryptCallable() *
    * * @@ -571,45 +493,84 @@ * * * - * Encrypt - *

    Encrypts data, so that it can only be recovered by a call to - * [Decrypt][google.cloud.kms.v1.KeyManagementService.Decrypt]. The - * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be - * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

    + * AsymmetricDecrypt + *

    Decrypts data that was encrypted with a public key retrieved from + * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey] + * corresponding to a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] + * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] + * ASYMMETRIC_DECRYPT.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • encrypt(EncryptRequest request) + *
    • asymmetricDecrypt(AsymmetricDecryptRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • encrypt(ResourceName name) - *
    • encrypt(String name) + *
    • asymmetricDecrypt(CryptoKeyVersionName name) + *
    • asymmetricDecrypt(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • encryptCallable() + *
    • asymmetricDecryptCallable() *
    * * * - * GetCryptoKey - *

    Returns metadata for a given [CryptoKey][google.cloud.kms.v1.CryptoKey], as - * well as its [primary][google.cloud.kms.v1.CryptoKey.primary] - * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

    + * UpdateCryptoKeyPrimaryVersion + *

    Update the version of a [CryptoKey][google.cloud.kms.v1.CryptoKey] that + * will be used in + * [Encrypt][google.cloud.kms.v1.KeyManagementService.Encrypt]. + * + * Returns an error if called on an asymmetric key.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getCryptoKey(GetCryptoKeyRequest request) + *
    • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getCryptoKey(CryptoKeyName name) - *
    • getCryptoKey(String name) + *
    • updateCryptoKeyPrimaryVersion(CryptoKeyName name) + *
    • updateCryptoKeyPrimaryVersion(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getCryptoKeyCallable() + *
    • updateCryptoKeyPrimaryVersionCallable() + *
    + * + * + * + * DestroyCryptoKeyVersion + *

    Schedule a [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion] for + * destruction. + * + * Upon calling this method, + * [CryptoKeyVersion.state][google.cloud.kms.v1.CryptoKeyVersion.state] will + * be set to + * [DESTROY_SCHEDULED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROY_SCHEDULED] + * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will + * be set to a time 24 hours in the future, at which point the + * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be changed to + * [DESTROYED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.DESTROYED], + * and the key material will be irrevocably destroyed. + * + * Before the + * [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] is + * reached, + * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] + * may be called to reverse the process.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • destroyCryptoKeyVersion(CryptoKeyVersionName name) + *
    • destroyCryptoKeyVersion(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • destroyCryptoKeyVersionCallable() *
    * * @@ -641,22 +602,61 @@ * * * - * ListCryptoKeys - *

    Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].

    + * GetIamPolicy + *

    Gets the access control policy for a resource. ADDED ONLY FOR MIXIN TESTS. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listCryptoKeys(ListCryptoKeysRequest request) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listCryptoKeys(KeyRingName parent) - *
    • listCryptoKeys(String parent) + *
    • getIamPolicyCallable() + *
    + * + * + * + * ListLocations + *

    Lists information about the supported locations for this service.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listLocations(ListLocationsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listCryptoKeysPagedCallable() - *
    • listCryptoKeysCallable() + *
    • listLocationsPagedCallable() + *
    • listLocationsCallable() + *
    + * + * + * + * GetLocation + *

    Gets information about a location.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getLocation(GetLocationRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getLocationCallable() + *
    + * + * + * + * TestIamPermissions + *

    This is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() *
    * * diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index c30e8e20c2..79849596bc 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -86,36 +86,55 @@ * Description * Method Variants * - * ListShelves - *

    Lists shelves. The order is unspecified but deterministic. Newly created - * shelves will not necessarily be added to the end of this list.

    + * CreateShelf + *

    Creates a shelf, and returns the new Shelf.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listShelves(ListShelvesRequest request) + *
    • createShelf(CreateShelfRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createShelf(Shelf shelf) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listShelvesPagedCallable() - *
    • listShelvesCallable() + *
    • createShelfCallable() *
    * * * - * CreateShelf - *

    Creates a shelf, and returns the new Shelf.

    + * GetShelf + *

    Gets a shelf. Returns NOT_FOUND if the shelf does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createShelf(CreateShelfRequest request) + *
    • getShelf(GetShelfRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createShelf(Shelf shelf) + *
    • getShelf(ShelfName name) + *
    • getShelf(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createShelfCallable() + *
    • getShelfCallable() + *
    + * + * + * + * ListShelves + *

    Lists shelves. The order is unspecified but deterministic. Newly created + * shelves will not necessarily be added to the end of this list.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listShelves(ListShelvesRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listShelvesPagedCallable() + *
    • listShelvesCallable() *
    * * @@ -139,24 +158,29 @@ * * * - * MoveBook - *

    Moves a book to another shelf, and returns the new book. The book - * id of the new book may not be the same as the original book.

    + * MergeShelves + *

    Merges two shelves by adding all books from the shelf named + * `other_shelf_name` to shelf `name`, and deletes + * `other_shelf_name`. Returns the updated shelf. + * The book ids of the moved books may not be the same as the original books. + * + * Returns NOT_FOUND if either shelf does not exist. + * This call is a no-op if the specified shelves are the same.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • moveBook(MoveBookRequest request) + *
    • mergeShelves(MergeShelvesRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • moveBook(BookName name) - *
    • moveBook(BookName name) - *
    • moveBook(String name) - *
    • moveBook(String name) + *
    • mergeShelves(ShelfName name) + *
    • mergeShelves(ShelfName name) + *
    • mergeShelves(String name) + *
    • mergeShelves(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • moveBookCallable() + *
    • mergeShelvesCallable() *
    * * @@ -180,127 +204,103 @@ * * * - * DeleteBook - *

    Deletes a book. Returns NOT_FOUND if the book does not exist.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteBook(DeleteBookRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteBook(BookName name) - *
    • deleteBook(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteBookCallable() - *
    - * - * - * - * UpdateBook - *

    Updates a book. Returns INVALID_ARGUMENT if the name of the book - * is non-empty and does not equal the existing name.

    + * GetBook + *

    Gets a book. Returns NOT_FOUND if the book does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateBook(UpdateBookRequest request) + *
    • getBook(GetBookRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateBook(Book book) + *
    • getBook(BookName name) + *
    • getBook(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateBookCallable() + *
    • getBookCallable() *
    * * * - * GetShelf - *

    Gets a shelf. Returns NOT_FOUND if the shelf does not exist.

    + * ListBooks + *

    Lists books in a shelf. The order is unspecified but deterministic. Newly + * created books will not necessarily be added to the end of this list. + * Returns NOT_FOUND if the shelf does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getShelf(GetShelfRequest request) + *
    • listBooks(ListBooksRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getShelf(ShelfName name) - *
    • getShelf(String name) + *
    • listBooks(ShelfName parent) + *
    • listBooks(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getShelfCallable() + *
    • listBooksPagedCallable() + *
    • listBooksCallable() *
    * * * - * GetBook - *

    Gets a book. Returns NOT_FOUND if the book does not exist.

    + * DeleteBook + *

    Deletes a book. Returns NOT_FOUND if the book does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getBook(GetBookRequest request) + *
    • deleteBook(DeleteBookRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getBook(BookName name) - *
    • getBook(String name) + *
    • deleteBook(BookName name) + *
    • deleteBook(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getBookCallable() + *
    • deleteBookCallable() *
    * * * - * MergeShelves - *

    Merges two shelves by adding all books from the shelf named - * `other_shelf_name` to shelf `name`, and deletes - * `other_shelf_name`. Returns the updated shelf. - * The book ids of the moved books may not be the same as the original books. - * - * Returns NOT_FOUND if either shelf does not exist. - * This call is a no-op if the specified shelves are the same.

    + * UpdateBook + *

    Updates a book. Returns INVALID_ARGUMENT if the name of the book + * is non-empty and does not equal the existing name.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • mergeShelves(MergeShelvesRequest request) + *
    • updateBook(UpdateBookRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • mergeShelves(ShelfName name) - *
    • mergeShelves(ShelfName name) - *
    • mergeShelves(String name) - *
    • mergeShelves(String name) + *
    • updateBook(Book book) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • mergeShelvesCallable() + *
    • updateBookCallable() *
    * * * - * ListBooks - *

    Lists books in a shelf. The order is unspecified but deterministic. Newly - * created books will not necessarily be added to the end of this list. - * Returns NOT_FOUND if the shelf does not exist.

    + * MoveBook + *

    Moves a book to another shelf, and returns the new book. The book + * id of the new book may not be the same as the original book.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listBooks(ListBooksRequest request) + *
    • moveBook(MoveBookRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listBooks(ShelfName parent) - *
    • listBooks(String parent) + *
    • moveBook(BookName name) + *
    • moveBook(BookName name) + *
    • moveBook(String name) + *
    • moveBook(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listBooksPagedCallable() - *
    • listBooksCallable() + *
    • moveBookCallable() *
    * * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index 1133d11ac3..6bb3d76417 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -120,82 +120,95 @@ * Description * Method Variants * - * DeleteSink - *

    Deletes a sink. If the sink has a unique `writer_identity`, then that - * service account is also deleted.

    + * ListBuckets + *

    Lists log buckets.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteSink(DeleteSinkRequest request) + *
    • listBuckets(ListBucketsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteSink(LogSinkName sinkName) - *
    • deleteSink(String sinkName) + *
    • listBuckets(BillingAccountLocationName parent) + *
    • listBuckets(FolderLocationName parent) + *
    • listBuckets(LocationName parent) + *
    • listBuckets(OrganizationLocationName parent) + *
    • listBuckets(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteSinkCallable() + *
    • listBucketsPagedCallable() + *
    • listBucketsCallable() *
    * * * - * UpdateView - *

    Updates a view on a log bucket. This method replaces the following fields - * in the existing view with values from the new view: `filter`. - * If an `UNAVAILABLE` error is returned, this indicates that system is not in - * a state where it can update the view. If this occurs, please try again in a - * few minutes.

    + * GetBucket + *

    Gets a log bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateView(UpdateViewRequest request) + *
    • getBucket(GetBucketRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateViewCallable() + *
    • getBucketCallable() *
    * * * - * UpdateCmekSettings - *

    Updates the Log Router CMEK settings for the given resource. + * CreateBucket + *

    Creates a log bucket that can be used to store log entries. After a bucket + * has been created, the bucket's location cannot be changed.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createBucket(CreateBucketRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createBucketCallable() + *
    + * + * + * + * UpdateBucket + *

    Updates a log bucket. This method replaces the following fields in the + * existing bucket with values from the new bucket: `retention_period` * - * Note: CMEK for the Log Router can currently only be configured for Google - * Cloud organizations. Once configured, it applies to all projects and - * folders in the Google Cloud organization. + * If the retention period is decreased and the bucket is locked, + * `FAILED_PRECONDITION` will be returned. * - * [UpdateCmekSettings][google.logging.v2.ConfigServiceV2.UpdateCmekSettings] - * will fail if 1) `kms_key_name` is invalid, or 2) the associated service - * account does not have the required - * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or - * 3) access to the key is disabled. + * If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then + * `FAILED_PRECONDITION` will be returned. * - * See [Enabling CMEK for Log - * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information.

    + * After a bucket has been created, the bucket's location cannot be changed.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateCmekSettings(UpdateCmekSettingsRequest request) + *
    • updateBucket(UpdateBucketRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateCmekSettingsCallable() + *
    • updateBucketCallable() *
    * * * - * GetView - *

    Gets a view on a log bucket..

    + * DeleteBucket + *

    Deletes a log bucket. + * + * Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state. + * After 7 days, the bucket will be purged and all log entries in the bucket + * will be permanently deleted.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getView(GetViewRequest request) + *
    • deleteBucket(DeleteBucketRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getViewCallable() + *
    • deleteBucketCallable() *
    * * @@ -215,58 +228,35 @@ * * * - * ListExclusions - *

    Lists all the exclusions on the _Default sink in a parent resource.

    + * ListViews + *

    Lists views on a log bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listExclusions(ListExclusionsRequest request) + *
    • listViews(ListViewsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listExclusions(BillingAccountName parent) - *
    • listExclusions(FolderName parent) - *
    • listExclusions(OrganizationName parent) - *
    • listExclusions(ProjectName parent) - *
    • listExclusions(String parent) + *
    • listViews(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listExclusionsPagedCallable() - *
    • listExclusionsCallable() + *
    • listViewsPagedCallable() + *
    • listViewsCallable() *
    * * * - * UpdateSettings - *

    Updates the Log Router settings for the given resource. - * - * Note: Settings for the Log Router can currently only be configured for - * Google Cloud organizations. Once configured, it applies to all projects and - * folders in the Google Cloud organization. - * - * [UpdateSettings][google.logging.v2.ConfigServiceV2.UpdateSettings] - * will fail if 1) `kms_key_name` is invalid, or 2) the associated service - * account does not have the required - * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or - * 3) access to the key is disabled. 4) `location_id` is not supported by - * Logging. 5) `location_id` violate OrgPolicy. - * - * See [Enabling CMEK for Log - * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information.

    + * GetView + *

    Gets a view on a log bucket..

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateSettings(UpdateSettingsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateSettings(Settings settings) + *
    • getView(GetViewRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateSettingsCallable() + *
    • getViewCallable() *
    * * @@ -286,6 +276,24 @@ * * * + * UpdateView + *

    Updates a view on a log bucket. This method replaces the following fields + * in the existing view with values from the new view: `filter`. + * If an `UNAVAILABLE` error is returned, this indicates that system is not in + * a state where it can update the view. If this occurs, please try again in a + * few minutes.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateView(UpdateViewRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateViewCallable() + *
    + * + * + * * DeleteView *

    Deletes a view on a log bucket. * If an `UNAVAILABLE` error is returned, this indicates that system is not in @@ -303,22 +311,25 @@ * * * - * UpdateExclusion - *

    Changes one or more properties of an existing exclusion in the _Default - * sink.

    + * ListSinks + *

    Lists sinks.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateExclusion(UpdateExclusionRequest request) + *
    • listSinks(ListSinksRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateExclusion(LogExclusionName name) - *
    • updateExclusion(String name) + *
    • listSinks(BillingAccountName parent) + *
    • listSinks(FolderName parent) + *
    • listSinks(OrganizationName parent) + *
    • listSinks(ProjectName parent) + *
    • listSinks(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateExclusionCallable() + *
    • listSinksPagedCallable() + *
    • listSinksCallable() *
    * * @@ -342,94 +353,6 @@ * * * - * CreateExclusion - *

    Creates a new exclusion in the _Default sink in a specified parent - * resource. Only log entries belonging to that resource can be excluded. You - * can have up to 10 exclusions in a resource.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • createExclusion(CreateExclusionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createExclusion(BillingAccountName parent) - *
    • createExclusion(FolderName parent) - *
    • createExclusion(OrganizationName parent) - *
    • createExclusion(ProjectName parent) - *
    • createExclusion(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • createExclusionCallable() - *
    - * - * - * - * DeleteBucket - *

    Deletes a log bucket. - * - * Changes the bucket's `lifecycle_state` to the `DELETE_REQUESTED` state. - * After 7 days, the bucket will be purged and all log entries in the bucket - * will be permanently deleted.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteBucket(DeleteBucketRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteBucketCallable() - *
    - * - * - * - * ListBuckets - *

    Lists log buckets.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listBuckets(ListBucketsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listBuckets(BillingAccountLocationName parent) - *
    • listBuckets(FolderLocationName parent) - *
    • listBuckets(LocationName parent) - *
    • listBuckets(OrganizationLocationName parent) - *
    • listBuckets(String parent) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listBucketsPagedCallable() - *
    • listBucketsCallable() - *
    - * - * - * - * GetCmekSettings - *

    Gets the Logging CMEK settings for the given resource. - * - * Note: CMEK for the Log Router can be configured for Google Cloud projects, - * folders, organizations and billing accounts. Once configured for an - * organization, it applies to all projects and folders in the Google Cloud - * organization. - * - * See [Enabling CMEK for Log - * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) - * for more information.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getCmekSettings(GetCmekSettingsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getCmekSettingsCallable() - *
    - * - * - * * CreateSink *

    Creates a sink that exports specified log entries to a destination. The * export of newly-ingested log entries begins immediately, unless the sink's @@ -455,125 +378,133 @@ * * * - * GetBucket - *

    Gets a log bucket.

    + * UpdateSink + *

    Updates a sink. This method replaces the following fields in the existing + * sink with values from the new sink: `destination`, and `filter`. + * + * The updated sink might also have a new `writer_identity`; see the + * `unique_writer_identity` field.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getBucket(GetBucketRequest request) + *
    • updateSink(UpdateSinkRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateSink(LogSinkName sinkName) + *
    • updateSink(String sinkName) + *
    • updateSink(LogSinkName sinkName) + *
    • updateSink(String sinkName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getBucketCallable() + *
    • updateSinkCallable() *
    * * * - * ListViews - *

    Lists views on a log bucket.

    + * DeleteSink + *

    Deletes a sink. If the sink has a unique `writer_identity`, then that + * service account is also deleted.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listViews(ListViewsRequest request) + *
    • deleteSink(DeleteSinkRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listViews(String parent) + *
    • deleteSink(LogSinkName sinkName) + *
    • deleteSink(String sinkName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listViewsPagedCallable() - *
    • listViewsCallable() + *
    • deleteSinkCallable() *
    * * * - * ListSinks - *

    Lists sinks.

    + * ListExclusions + *

    Lists all the exclusions on the _Default sink in a parent resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listSinks(ListSinksRequest request) + *
    • listExclusions(ListExclusionsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listSinks(BillingAccountName parent) - *
    • listSinks(FolderName parent) - *
    • listSinks(OrganizationName parent) - *
    • listSinks(ProjectName parent) - *
    • listSinks(String parent) + *
    • listExclusions(BillingAccountName parent) + *
    • listExclusions(FolderName parent) + *
    • listExclusions(OrganizationName parent) + *
    • listExclusions(ProjectName parent) + *
    • listExclusions(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listSinksPagedCallable() - *
    • listSinksCallable() + *
    • listExclusionsPagedCallable() + *
    • listExclusionsCallable() *
    * * * - * UpdateSink - *

    Updates a sink. This method replaces the following fields in the existing - * sink with values from the new sink: `destination`, and `filter`. - * - * The updated sink might also have a new `writer_identity`; see the - * `unique_writer_identity` field.

    + * GetExclusion + *

    Gets the description of an exclusion in the _Default sink.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateSink(UpdateSinkRequest request) + *
    • getExclusion(GetExclusionRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateSink(LogSinkName sinkName) - *
    • updateSink(String sinkName) - *
    • updateSink(LogSinkName sinkName) - *
    • updateSink(String sinkName) + *
    • getExclusion(LogExclusionName name) + *
    • getExclusion(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateSinkCallable() + *
    • getExclusionCallable() *
    * * * - * UpdateBucket - *

    Updates a log bucket. This method replaces the following fields in the - * existing bucket with values from the new bucket: `retention_period` - * - * If the retention period is decreased and the bucket is locked, - * `FAILED_PRECONDITION` will be returned. - * - * If the bucket has a `lifecycle_state` of `DELETE_REQUESTED`, then - * `FAILED_PRECONDITION` will be returned. - * - * After a bucket has been created, the bucket's location cannot be changed.

    + * CreateExclusion + *

    Creates a new exclusion in the _Default sink in a specified parent + * resource. Only log entries belonging to that resource can be excluded. You + * can have up to 10 exclusions in a resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateBucket(UpdateBucketRequest request) + *
    • createExclusion(CreateExclusionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createExclusion(BillingAccountName parent) + *
    • createExclusion(FolderName parent) + *
    • createExclusion(OrganizationName parent) + *
    • createExclusion(ProjectName parent) + *
    • createExclusion(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateBucketCallable() + *
    • createExclusionCallable() *
    * * * - * GetExclusion - *

    Gets the description of an exclusion in the _Default sink.

    + * UpdateExclusion + *

    Changes one or more properties of an existing exclusion in the _Default + * sink.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getExclusion(GetExclusionRequest request) + *
    • updateExclusion(UpdateExclusionRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getExclusion(LogExclusionName name) - *
    • getExclusion(String name) + *
    • updateExclusion(LogExclusionName name) + *
    • updateExclusion(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getExclusionCallable() + *
    • updateExclusionCallable() *
    * * @@ -597,32 +528,53 @@ * * * - * CopyLogEntries - *

    Copies a set of log entries from a log bucket to a Cloud Storage bucket.

    + * GetCmekSettings + *

    Gets the Logging CMEK settings for the given resource. + * + * Note: CMEK for the Log Router can be configured for Google Cloud projects, + * folders, organizations and billing accounts. Once configured for an + * organization, it applies to all projects and folders in the Google Cloud + * organization. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • copyLogEntriesAsync(CopyLogEntriesRequest request) + *
    • getCmekSettings(GetCmekSettingsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • copyLogEntriesOperationCallable() - *
    • copyLogEntriesCallable() + *
    • getCmekSettingsCallable() *
    * * * - * CreateBucket - *

    Creates a log bucket that can be used to store log entries. After a bucket - * has been created, the bucket's location cannot be changed.

    + * UpdateCmekSettings + *

    Updates the Log Router CMEK settings for the given resource. + * + * Note: CMEK for the Log Router can currently only be configured for Google + * Cloud organizations. Once configured, it applies to all projects and + * folders in the Google Cloud organization. + * + * [UpdateCmekSettings][google.logging.v2.ConfigServiceV2.UpdateCmekSettings] + * will fail if 1) `kms_key_name` is invalid, or 2) the associated service + * account does not have the required + * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or + * 3) access to the key is disabled. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createBucket(CreateBucketRequest request) + *
    • updateCmekSettings(UpdateCmekSettingsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createBucketCallable() + *
    • updateCmekSettingsCallable() *
    * * @@ -654,6 +606,54 @@ * * * + * + * UpdateSettings + *

    Updates the Log Router settings for the given resource. + * + * Note: Settings for the Log Router can currently only be configured for + * Google Cloud organizations. Once configured, it applies to all projects and + * folders in the Google Cloud organization. + * + * [UpdateSettings][google.logging.v2.ConfigServiceV2.UpdateSettings] + * will fail if 1) `kms_key_name` is invalid, or 2) the associated service + * account does not have the required + * `roles/cloudkms.cryptoKeyEncrypterDecrypter` role assigned for the key, or + * 3) access to the key is disabled. 4) `location_id` is not supported by + * Logging. 5) `location_id` violate OrgPolicy. + * + * See [Enabling CMEK for Log + * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) + * for more information.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateSettings(UpdateSettingsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • updateSettings(Settings settings) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateSettingsCallable() + *
    + * + * + * + * CopyLogEntries + *

    Copies a set of log entries from a log bucket to a Cloud Storage bucket.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • copyLogEntriesAsync(CopyLogEntriesRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • copyLogEntriesOperationCallable() + *
    • copyLogEntriesCallable() + *
    + * + * * * *

    See the individual methods for example code. diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index 3d8c229fe5..6eb0cf1d49 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -82,6 +82,28 @@ * Description * Method Variants * + * DeleteLog + *

    Deletes all the log entries in a log for the _Default Log Bucket. The log + * reappears if it receives new entries. Log entries written shortly before + * the delete operation might not be deleted. Entries received after the + * delete operation with a timestamp before the operation will be deleted.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteLog(DeleteLogRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteLog(LogName logName) + *
    • deleteLog(String logName) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteLogCallable() + *
    + * + * + * * WriteLogEntries *

    Writes log entries to Logging. This API method is the * only way to send log entries to Logging. This method @@ -107,6 +129,28 @@ * * * + * ListLogEntries + *

    Lists log entries. Use this method to retrieve log entries that originated + * from a project/folder/organization/billing account. For ways to export log + * entries, see [Exporting + * Logs](https://cloud.google.com/logging/docs/export).

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listLogEntries(ListLogEntriesRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listLogEntries(List resourceNames) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listLogEntriesPagedCallable() + *
    • listLogEntriesCallable() + *
    + * + * + * * ListMonitoredResourceDescriptors *

    Lists the descriptors for monitored resource types used by Logging.

    * @@ -146,50 +190,6 @@ * * * - * DeleteLog - *

    Deletes all the log entries in a log for the _Default Log Bucket. The log - * reappears if it receives new entries. Log entries written shortly before - * the delete operation might not be deleted. Entries received after the - * delete operation with a timestamp before the operation will be deleted.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • deleteLog(DeleteLogRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteLog(LogName logName) - *
    • deleteLog(String logName) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • deleteLogCallable() - *
    - * - * - * - * ListLogEntries - *

    Lists log entries. Use this method to retrieve log entries that originated - * from a project/folder/organization/billing account. For ways to export log - * entries, see [Exporting - * Logs](https://cloud.google.com/logging/docs/export).

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listLogEntries(ListLogEntriesRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listLogEntries(List resourceNames) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listLogEntriesPagedCallable() - *
    • listLogEntriesCallable() - *
    - * - * - * * TailLogEntries *

    Streaming read of log entries as they are ingested. Until the stream is * terminated, it will continue reading logs.

    diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index a8eb81defe..f49f3818e9 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -70,98 +70,98 @@ * Description * Method Variants * - * UpdateLogMetric - *

    Creates or updates a logs-based metric.

    + * ListLogMetrics + *

    Lists logs-based metrics.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateLogMetric(UpdateLogMetricRequest request) + *
    • listLogMetrics(ListLogMetricsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateLogMetric(LogMetricName metricName) - *
    • updateLogMetric(String metricName) + *
    • listLogMetrics(ProjectName parent) + *
    • listLogMetrics(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateLogMetricCallable() + *
    • listLogMetricsPagedCallable() + *
    • listLogMetricsCallable() *
    * * * - * CreateLogMetric - *

    Creates a logs-based metric.

    + * GetLogMetric + *

    Gets a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createLogMetric(CreateLogMetricRequest request) + *
    • getLogMetric(GetLogMetricRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createLogMetric(ProjectName parent) - *
    • createLogMetric(String parent) + *
    • getLogMetric(LogMetricName metricName) + *
    • getLogMetric(String metricName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createLogMetricCallable() + *
    • getLogMetricCallable() *
    * * * - * GetLogMetric - *

    Gets a logs-based metric.

    + * CreateLogMetric + *

    Creates a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getLogMetric(GetLogMetricRequest request) + *
    • createLogMetric(CreateLogMetricRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getLogMetric(LogMetricName metricName) - *
    • getLogMetric(String metricName) + *
    • createLogMetric(ProjectName parent) + *
    • createLogMetric(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getLogMetricCallable() + *
    • createLogMetricCallable() *
    * * * - * DeleteLogMetric - *

    Deletes a logs-based metric.

    + * UpdateLogMetric + *

    Creates or updates a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteLogMetric(DeleteLogMetricRequest request) + *
    • updateLogMetric(UpdateLogMetricRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteLogMetric(LogMetricName metricName) - *
    • deleteLogMetric(String metricName) + *
    • updateLogMetric(LogMetricName metricName) + *
    • updateLogMetric(String metricName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteLogMetricCallable() + *
    • updateLogMetricCallable() *
    * * * - * ListLogMetrics - *

    Lists logs-based metrics.

    + * DeleteLogMetric + *

    Deletes a logs-based metric.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listLogMetrics(ListLogMetricsRequest request) + *
    • deleteLogMetric(DeleteLogMetricRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listLogMetrics(ProjectName parent) - *
    • listLogMetrics(String parent) + *
    • deleteLogMetric(LogMetricName metricName) + *
    • deleteLogMetric(String metricName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listLogMetricsPagedCallable() - *
    • listLogMetricsCallable() + *
    • deleteLogMetricCallable() *
    * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index 471490b25a..057bb8b6fa 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -85,36 +85,60 @@ * Description * Method Variants * - * DeleteSchema - *

    Deletes a schema.

    + * CreateSchema + *

    Creates a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteSchema(DeleteSchemaRequest request) + *
    • createSchema(CreateSchemaRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteSchema(SchemaName name) - *
    • deleteSchema(String name) + *
    • createSchema(ProjectName parent) + *
    • createSchema(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteSchemaCallable() + *
    • createSchemaCallable() *
    * * * - * GetIamPolicy - *

    Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set.

    + * GetSchema + *

    Gets a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • getSchema(GetSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getSchema(SchemaName name) + *
    • getSchema(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • getSchemaCallable() + *
    + * + * + * + * ListSchemas + *

    Lists schemas in a project.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSchemas(ListSchemasRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listSchemas(ProjectName parent) + *
    • listSchemas(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listSchemasPagedCallable() + *
    • listSchemasCallable() *
    * * @@ -139,20 +163,21 @@ * * * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces - * any existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors.

    + * CommitSchema + *

    Commits a new schema revision to an existing schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • setIamPolicy(SetIamPolicyRequest request) + *
    • commitSchema(CommitSchemaRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • commitSchema(SchemaName name) + *
    • commitSchema(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • setIamPolicyCallable() + *
    • commitSchemaCallable() *
    * * @@ -195,132 +220,107 @@ * * * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. If the - * resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building - * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning.

    + * DeleteSchema + *

    Deletes a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() + *
    • deleteSchema(DeleteSchemaRequest request) *
    - * - * - * - * ValidateMessage - *

    Validates a message against a schema.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • validateMessage(ValidateMessageRequest request) + *
    • deleteSchema(SchemaName name) + *
    • deleteSchema(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • validateMessageCallable() + *
    • deleteSchemaCallable() *
    * * * - * CreateSchema - *

    Creates a schema.

    + * ValidateSchema + *

    Validates a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createSchema(CreateSchemaRequest request) + *
    • validateSchema(ValidateSchemaRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createSchema(ProjectName parent) - *
    • createSchema(String parent) + *
    • validateSchema(ProjectName parent) + *
    • validateSchema(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createSchemaCallable() + *
    • validateSchemaCallable() *
    * * * - * ListSchemas - *

    Lists schemas in a project.

    + * ValidateMessage + *

    Validates a message against a schema.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listSchemas(ListSchemasRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSchemas(ProjectName parent) - *
    • listSchemas(String parent) + *
    • validateMessage(ValidateMessageRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listSchemasPagedCallable() - *
    • listSchemasCallable() + *
    • validateMessageCallable() *
    * * * - * CommitSchema - *

    Commits a new schema revision to an existing schema.

    + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces + * any existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • commitSchema(CommitSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • commitSchema(SchemaName name) - *
    • commitSchema(String name) + *
    • setIamPolicy(SetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • commitSchemaCallable() + *
    • setIamPolicyCallable() *
    * * * - * GetSchema - *

    Gets a schema.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getSchema(GetSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getSchema(SchemaName name) - *
    • getSchema(String name) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getSchemaCallable() + *
    • getIamPolicyCallable() *
    * * * - * ValidateSchema - *

    Validates a schema.

    + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • validateSchema(ValidateSchemaRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • validateSchema(ProjectName parent) - *
    • validateSchema(String parent) + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • validateSchemaCallable() + *
    • testIamPermissionsCallable() *
    * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 84431a78b4..e62ffd1963 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -101,73 +101,110 @@ * Description * Method Variants * - * Pull - *

    Pulls messages from the server. The server may return `UNAVAILABLE` if - * there are too many concurrent pull requests pending for the given - * subscription.

    + * CreateSubscription + *

    Creates a subscription to a given topic. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). + * If the subscription already exists, returns `ALREADY_EXISTS`. + * If the corresponding topic doesn't exist, returns `NOT_FOUND`. + * + * If the name is not provided in the request, the server will assign a random + * name for this subscription on the same project as the topic, conforming + * to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated + * name is populated in the returned Subscription object. Note that for REST + * API requests, you must specify a name in the request.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • pull(PullRequest request) + *
    • createSubscription(Subscription request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • pull(SubscriptionName subscription) - *
    • pull(String subscription) - *
    • pull(SubscriptionName subscription) - *
    • pull(String subscription) + *
    • createSubscription(SubscriptionName name) + *
    • createSubscription(SubscriptionName name) + *
    • createSubscription(String name) + *
    • createSubscription(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • pullCallable() + *
    • createSubscriptionCallable() *
    * * * - * GetSnapshot - *

    Gets the configuration details of a snapshot. Snapshots are used in - * Seek - * operations, which allow you to manage message acknowledgments in bulk. That - * is, you can set the acknowledgment state of messages in an existing - * subscription to the state captured by a snapshot.

    + * GetSubscription + *

    Gets the configuration details of a subscription.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getSnapshot(GetSnapshotRequest request) + *
    • getSubscription(GetSubscriptionRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getSnapshot(SnapshotName snapshot) - *
    • getSnapshot(String snapshot) + *
    • getSubscription(SubscriptionName subscription) + *
    • getSubscription(String subscription) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getSnapshotCallable() + *
    • getSubscriptionCallable() *
    * * * - * Acknowledge - *

    Acknowledges the messages associated with the `ack_ids` in the - * `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages - * from the subscription. - * - * Acknowledging a message whose ack deadline has expired may succeed, - * but such a message may be redelivered later. Acknowledging a message more - * than once will not result in an error.

    + * UpdateSubscription + *

    Updates an existing subscription. Note that certain properties of a + * subscription, such as its topic, are not modifiable.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • acknowledge(AcknowledgeRequest request) + *
    • updateSubscription(UpdateSubscriptionRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateSubscriptionCallable() + *
    + * + * + * + * ListSubscriptions + *

    Lists matching subscriptions.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listSubscriptions(ListSubscriptionsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • acknowledge(SubscriptionName subscription) - *
    • acknowledge(String subscription) + *
    • listSubscriptions(ProjectName project) + *
    • listSubscriptions(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • acknowledgeCallable() + *
    • listSubscriptionsPagedCallable() + *
    • listSubscriptionsCallable() + *
    + * + * + * + * DeleteSubscription + *

    Deletes an existing subscription. All messages retained in the subscription + * are immediately dropped. Calls to `Pull` after deletion will return + * `NOT_FOUND`. After a subscription is deleted, a new one may be created with + * the same name, but the new one has no association with the old + * subscription or its topic unless the same topic is specified.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteSubscription(DeleteSubscriptionRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteSubscription(SubscriptionName subscription) + *
    • deleteSubscription(String subscription) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • deleteSubscriptionCallable() *
    * * @@ -195,60 +232,50 @@ * * * - * ModifyPushConfig - *

    Modifies the `PushConfig` for a specified subscription. + * Acknowledge + *

    Acknowledges the messages associated with the `ack_ids` in the + * `AcknowledgeRequest`. The Pub/Sub system can remove the relevant messages + * from the subscription. * - * This may be used to change a push subscription to a pull one (signified by - * an empty `PushConfig`) or vice versa, or change the endpoint URL and other - * attributes of a push subscription. Messages will accumulate for delivery - * continuously through the call regardless of changes to the `PushConfig`.

    + * Acknowledging a message whose ack deadline has expired may succeed, + * but such a message may be redelivered later. Acknowledging a message more + * than once will not result in an error.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • modifyPushConfig(ModifyPushConfigRequest request) + *
    • acknowledge(AcknowledgeRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • modifyPushConfig(SubscriptionName subscription) - *
    • modifyPushConfig(String subscription) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • modifyPushConfigCallable() - *
    - * - * - * - * GetIamPolicy - *

    Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • acknowledge(SubscriptionName subscription) + *
    • acknowledge(String subscription) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • acknowledgeCallable() *
    * * * - * GetSubscription - *

    Gets the configuration details of a subscription.

    + * Pull + *

    Pulls messages from the server. The server may return `UNAVAILABLE` if + * there are too many concurrent pull requests pending for the given + * subscription.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getSubscription(GetSubscriptionRequest request) + *
    • pull(PullRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getSubscription(SubscriptionName subscription) - *
    • getSubscription(String subscription) + *
    • pull(SubscriptionName subscription) + *
    • pull(String subscription) + *
    • pull(SubscriptionName subscription) + *
    • pull(String subscription) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getSubscriptionCallable() + *
    • pullCallable() *
    * * @@ -269,102 +296,109 @@ * * * - * ListSnapshots - *

    Lists the existing snapshots. Snapshots are used in [Seek]( - * https://cloud.google.com/pubsub/docs/replay-overview) operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set - * the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot.

    + * ModifyPushConfig + *

    Modifies the `PushConfig` for a specified subscription. + * + * This may be used to change a push subscription to a pull one (signified by + * an empty `PushConfig`) or vice versa, or change the endpoint URL and other + * attributes of a push subscription. Messages will accumulate for delivery + * continuously through the call regardless of changes to the `PushConfig`.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listSnapshots(ListSnapshotsRequest request) + *
    • modifyPushConfig(ModifyPushConfigRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listSnapshots(ProjectName project) - *
    • listSnapshots(String project) + *
    • modifyPushConfig(SubscriptionName subscription) + *
    • modifyPushConfig(String subscription) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listSnapshotsPagedCallable() - *
    • listSnapshotsCallable() + *
    • modifyPushConfigCallable() *
    * * * - * CreateSubscription - *

    Creates a subscription to a given topic. See the [resource name rules] - * (https://cloud.google.com/pubsub/docs/admin#resource_names). - * If the subscription already exists, returns `ALREADY_EXISTS`. - * If the corresponding topic doesn't exist, returns `NOT_FOUND`. - * - * If the name is not provided in the request, the server will assign a random - * name for this subscription on the same project as the topic, conforming - * to the [resource name format] - * (https://cloud.google.com/pubsub/docs/admin#resource_names). The generated - * name is populated in the returned Subscription object. Note that for REST - * API requests, you must specify a name in the request.

    + * GetSnapshot + *

    Gets the configuration details of a snapshot. Snapshots are used in + * Seek + * operations, which allow you to manage message acknowledgments in bulk. That + * is, you can set the acknowledgment state of messages in an existing + * subscription to the state captured by a snapshot.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createSubscription(Subscription request) + *
    • getSnapshot(GetSnapshotRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createSubscription(SubscriptionName name) - *
    • createSubscription(SubscriptionName name) - *
    • createSubscription(String name) - *
    • createSubscription(String name) + *
    • getSnapshot(SnapshotName snapshot) + *
    • getSnapshot(String snapshot) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createSubscriptionCallable() + *
    • getSnapshotCallable() *
    * * * - * DeleteSnapshot - *

    Removes an existing snapshot. Snapshots are used in [Seek] - * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * ListSnapshots + *

    Lists the existing snapshots. Snapshots are used in [Seek]( + * https://cloud.google.com/pubsub/docs/replay-overview) operations, which * allow you to manage message acknowledgments in bulk. That is, you can set * the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. - * When the snapshot is deleted, all messages retained in the snapshot - * are immediately dropped. After a snapshot is deleted, a new one may be - * created with the same name, but the new one has no association with the old - * snapshot or its subscription, unless the same subscription is specified.

    + * state captured by a snapshot.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteSnapshot(DeleteSnapshotRequest request) + *
    • listSnapshots(ListSnapshotsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteSnapshot(SnapshotName snapshot) - *
    • deleteSnapshot(String snapshot) + *
    • listSnapshots(ProjectName project) + *
    • listSnapshots(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteSnapshotCallable() + *
    • listSnapshotsPagedCallable() + *
    • listSnapshotsCallable() *
    * * * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces - * any existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` - * errors.

    + * CreateSnapshot + *

    Creates a snapshot from the requested subscription. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + * which allow you to manage message acknowledgments in bulk. That is, you can + * set the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + * If the snapshot already exists, returns `ALREADY_EXISTS`. + * If the requested subscription doesn't exist, returns `NOT_FOUND`. + * If the backlog in the subscription is too old -- and the resulting snapshot + * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. + * See also the `Snapshot.expire_time` field. If the name is not provided in + * the request, the server will assign a random + * name for this snapshot on the same project as the subscription, conforming + * to the [resource name format] + * (https://cloud.google.com/pubsub/docs/admin#resource_names). The + * generated name is populated in the returned Snapshot object. Note that for + * REST API requests, you must specify a name in the request.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • setIamPolicy(SetIamPolicyRequest request) + *
    • createSnapshot(CreateSnapshotRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createSnapshot(SnapshotName name) + *
    • createSnapshot(SnapshotName name) + *
    • createSnapshot(String name) + *
    • createSnapshot(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • setIamPolicyCallable() + *
    • createSnapshotCallable() *
    * * @@ -388,136 +422,102 @@ * * * - * UpdateSubscription - *

    Updates an existing subscription. Note that certain properties of a - * subscription, such as its topic, are not modifiable.

    + * DeleteSnapshot + *

    Removes an existing snapshot. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. + * When the snapshot is deleted, all messages retained in the snapshot + * are immediately dropped. After a snapshot is deleted, a new one may be + * created with the same name, but the new one has no association with the old + * snapshot or its subscription, unless the same subscription is specified.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateSubscription(UpdateSubscriptionRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateSubscriptionCallable() + *
    • deleteSnapshot(DeleteSnapshotRequest request) *
    - * - * - * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. If the - * resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building - * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • deleteSnapshot(SnapshotName snapshot) + *
    • deleteSnapshot(String snapshot) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • deleteSnapshotCallable() *
    * * * - * DeleteSubscription - *

    Deletes an existing subscription. All messages retained in the subscription - * are immediately dropped. Calls to `Pull` after deletion will return - * `NOT_FOUND`. After a subscription is deleted, a new one may be created with - * the same name, but the new one has no association with the old - * subscription or its topic unless the same topic is specified.

    + * Seek + *

    Seeks an existing subscription to a point in time or to a given snapshot, + * whichever is provided in the request. Snapshots are used in [Seek] + * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which + * allow you to manage message acknowledgments in bulk. That is, you can set + * the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot. Note that both the subscription and the + * snapshot must be on the same topic.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteSubscription(DeleteSubscriptionRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteSubscription(SubscriptionName subscription) - *
    • deleteSubscription(String subscription) + *
    • seek(SeekRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteSubscriptionCallable() + *
    • seekCallable() *
    * * * - * ListSubscriptions - *

    Lists matching subscriptions.

    + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces + * any existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` + * errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listSubscriptions(ListSubscriptionsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listSubscriptions(ProjectName project) - *
    • listSubscriptions(String project) + *
    • setIamPolicy(SetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listSubscriptionsPagedCallable() - *
    • listSubscriptionsCallable() + *
    • setIamPolicyCallable() *
    * * * - * CreateSnapshot - *

    Creates a snapshot from the requested subscription. Snapshots are used in - * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, - * which allow you to manage message acknowledgments in bulk. That is, you can - * set the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. - * If the snapshot already exists, returns `ALREADY_EXISTS`. - * If the requested subscription doesn't exist, returns `NOT_FOUND`. - * If the backlog in the subscription is too old -- and the resulting snapshot - * would expire in less than 1 hour -- then `FAILED_PRECONDITION` is returned. - * See also the `Snapshot.expire_time` field. If the name is not provided in - * the request, the server will assign a random - * name for this snapshot on the same project as the subscription, conforming - * to the [resource name format] - * (https://cloud.google.com/pubsub/docs/admin#resource_names). The - * generated name is populated in the returned Snapshot object. Note that for - * REST API requests, you must specify a name in the request.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createSnapshot(CreateSnapshotRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createSnapshot(SnapshotName name) - *
    • createSnapshot(SnapshotName name) - *
    • createSnapshot(String name) - *
    • createSnapshot(String name) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createSnapshotCallable() + *
    • getIamPolicyCallable() *
    * * * - * Seek - *

    Seeks an existing subscription to a point in time or to a given snapshot, - * whichever is provided in the request. Snapshots are used in [Seek] - * (https://cloud.google.com/pubsub/docs/replay-overview) operations, which - * allow you to manage message acknowledgments in bulk. That is, you can set - * the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot. Note that both the subscription and the - * snapshot must be on the same topic.

    + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • seek(SeekRequest request) + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • seekCallable() + *
    • testIamPermissionsCallable() *
    * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index ba7ab18b97..8e9277d22f 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -84,79 +84,57 @@ * Description * Method Variants * - * ListTopicSubscriptions - *

    Lists the names of the attached subscriptions on this topic.

    + * CreateTopic + *

    Creates the given topic with the given name. See the [resource name rules] + * (https://cloud.google.com/pubsub/docs/admin#resource_names).

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listTopicSubscriptions(ListTopicSubscriptionsRequest request) + *
    • createTopic(Topic request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listTopicSubscriptions(TopicName topic) - *
    • listTopicSubscriptions(String topic) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listTopicSubscriptionsPagedCallable() - *
    • listTopicSubscriptionsCallable() - *
    - * - * - * - * DetachSubscription - *

    Detaches a subscription from this topic. All messages retained in the - * subscription are dropped. Subsequent `Pull` and `StreamingPull` requests - * will return FAILED_PRECONDITION. If the subscription is a push - * subscription, pushes to the endpoint will stop.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • detachSubscription(DetachSubscriptionRequest request) + *
    • createTopic(TopicName name) + *
    • createTopic(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • detachSubscriptionCallable() + *
    • createTopicCallable() *
    * * * - * CreateTopic - *

    Creates the given topic with the given name. See the [resource name rules] - * (https://cloud.google.com/pubsub/docs/admin#resource_names).

    + * UpdateTopic + *

    Updates an existing topic. Note that certain properties of a + * topic are not modifiable.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createTopic(Topic request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createTopic(TopicName name) - *
    • createTopic(String name) + *
    • updateTopic(UpdateTopicRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createTopicCallable() + *
    • updateTopicCallable() *
    * * * - * ListTopics - *

    Lists matching topics.

    + * Publish + *

    Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic + * does not exist.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listTopics(ListTopicsRequest request) + *
    • publish(PublishRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listTopics(ProjectName project) - *
    • listTopics(String project) + *
    • publish(TopicName topic) + *
    • publish(String topic) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listTopicsPagedCallable() - *
    • listTopicsCallable() + *
    • publishCallable() *
    * * @@ -180,52 +158,66 @@ * * * - * GetIamPolicy - *

    Gets the access control policy for a resource. Returns an empty policy - * if the resource exists and does not have a policy set.

    + * ListTopics + *

    Lists matching topics.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • listTopics(ListTopicsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listTopics(ProjectName project) + *
    • listTopics(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • listTopicsPagedCallable() + *
    • listTopicsCallable() *
    * * * - * UpdateTopic - *

    Updates an existing topic. Note that certain properties of a - * topic are not modifiable.

    + * ListTopicSubscriptions + *

    Lists the names of the attached subscriptions on this topic.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateTopic(UpdateTopicRequest request) + *
    • listTopicSubscriptions(ListTopicSubscriptionsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listTopicSubscriptions(TopicName topic) + *
    • listTopicSubscriptions(String topic) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateTopicCallable() + *
    • listTopicSubscriptionsPagedCallable() + *
    • listTopicSubscriptionsCallable() *
    * * * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. If the - * resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building - * permission-aware UIs and command-line tools, not for authorization - * checking. This operation may "fail open" without warning.

    + * ListTopicSnapshots + *

    Lists the names of the snapshots on this topic. Snapshots are used in + * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, + * which allow you to manage message acknowledgments in bulk. That is, you can + * set the acknowledgment state of messages in an existing subscription to the + * state captured by a snapshot.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • listTopicSnapshots(ListTopicSnapshotsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listTopicSnapshots(TopicName topic) + *
    • listTopicSnapshots(String topic) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • listTopicSnapshotsPagedCallable() + *
    • listTopicSnapshotsCallable() *
    * * @@ -253,26 +245,19 @@ * * * - * ListTopicSnapshots - *

    Lists the names of the snapshots on this topic. Snapshots are used in - * [Seek](https://cloud.google.com/pubsub/docs/replay-overview) operations, - * which allow you to manage message acknowledgments in bulk. That is, you can - * set the acknowledgment state of messages in an existing subscription to the - * state captured by a snapshot.

    + * DetachSubscription + *

    Detaches a subscription from this topic. All messages retained in the + * subscription are dropped. Subsequent `Pull` and `StreamingPull` requests + * will return FAILED_PRECONDITION. If the subscription is a push + * subscription, pushes to the endpoint will stop.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listTopicSnapshots(ListTopicSnapshotsRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • listTopicSnapshots(TopicName topic) - *
    • listTopicSnapshots(String topic) + *
    • detachSubscription(DetachSubscriptionRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listTopicSnapshotsPagedCallable() - *
    • listTopicSnapshotsCallable() + *
    • detachSubscriptionCallable() *
    * * @@ -295,22 +280,37 @@ * * * - * Publish - *

    Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic - * does not exist.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. Returns an empty policy + * if the resource exists and does not have a policy set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • publish(PublishRequest request) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • publish(TopicName topic) - *
    • publish(String topic) + *
    • getIamPolicyCallable() + *
    + * + * + * + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. If the + * resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building + * permission-aware UIs and command-line tools, not for authorization + * checking. This operation may "fail open" without warning.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • publishCallable() + *
    • testIamPermissionsCallable() *
    * * diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index 2b5c7631a1..0fdef5ba2f 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -88,49 +88,6 @@ * Description * Method Variants * - * GetInstance - *

    Gets the details of a specific Redis instance.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getInstance(GetInstanceRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getInstance(InstanceName name) - *
    • getInstance(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getInstanceCallable() - *
    - * - * - * - * ExportInstance - *

    Export Redis instance data into a Redis RDB format file in Cloud Storage. - * - * Redis will continue serving during this operation. - * - * The returned operation is automatically deleted after a few hours, so - * there is no need to call DeleteOperation.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • exportInstanceAsync(ExportInstanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • exportInstanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • exportInstanceOperationCallable() - *
    • exportInstanceCallable() - *
    - * - * - * * ListInstances *

    Lists all Redis instances owned by a project in either the specified * location (region) or all locations. @@ -159,25 +116,21 @@ * * * - * UpdateInstance - *

    Updates the metadata and configuration of a specific Redis instance. - * - * Completed longrunning.Operation will contain the new instance object - * in the response field. The returned operation is automatically deleted - * after a few hours, so there is no need to call DeleteOperation.

    + * GetInstance + *

    Gets the details of a specific Redis instance.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateInstanceAsync(UpdateInstanceRequest request) + *
    • getInstance(GetInstanceRequest request) *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateInstanceAsync(FieldMask updateMask) + *
    • getInstance(InstanceName name) + *
    • getInstance(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateInstanceOperationCallable() - *
    • updateInstanceCallable() + *
    • getInstanceCallable() *
    * * @@ -203,27 +156,6 @@ * * * - * RescheduleMaintenance - *

    Reschedule maintenance for a given instance in a given project and - * location.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) - *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    - *
      - *
    • rescheduleMaintenanceAsync(InstanceName name) - *
    • rescheduleMaintenanceAsync(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • rescheduleMaintenanceOperationCallable() - *
    • rescheduleMaintenanceCallable() - *
    - * - * - * * CreateInstance *

    Creates a Redis instance based on the specified tier and memory size. * @@ -255,6 +187,50 @@ * * * + * UpdateInstance + *

    Updates the metadata and configuration of a specific Redis instance. + * + * Completed longrunning.Operation will contain the new instance object + * in the response field. The returned operation is automatically deleted + * after a few hours, so there is no need to call DeleteOperation.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • updateInstanceAsync(UpdateInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • updateInstanceAsync(FieldMask updateMask) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • updateInstanceOperationCallable() + *
    • updateInstanceCallable() + *
    + * + * + * + * UpgradeInstance + *

    Upgrades Redis instance to the newer Redis version specified in the + * request.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • upgradeInstanceAsync(UpgradeInstanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • upgradeInstanceAsync(InstanceName name) + *
    • upgradeInstanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • upgradeInstanceOperationCallable() + *
    • upgradeInstanceCallable() + *
    + * + * + * * ImportInstance *

    Import a Redis RDB snapshot file from Cloud Storage into a Redis instance. * @@ -281,44 +257,47 @@ * * * - * FailoverInstance - *

    Initiates a failover of the primary node to current replica node for a - * specific STANDARD tier Cloud Memorystore for Redis instance.

    + * ExportInstance + *

    Export Redis instance data into a Redis RDB format file in Cloud Storage. + * + * Redis will continue serving during this operation. + * + * The returned operation is automatically deleted after a few hours, so + * there is no need to call DeleteOperation.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • failoverInstanceAsync(FailoverInstanceRequest request) + *
    • exportInstanceAsync(ExportInstanceRequest request) *
    *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    *
      - *
    • failoverInstanceAsync(InstanceName name) - *
    • failoverInstanceAsync(String name) + *
    • exportInstanceAsync(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • failoverInstanceOperationCallable() - *
    • failoverInstanceCallable() + *
    • exportInstanceOperationCallable() + *
    • exportInstanceCallable() *
    * * * - * UpgradeInstance - *

    Upgrades Redis instance to the newer Redis version specified in the - * request.

    + * FailoverInstance + *

    Initiates a failover of the primary node to current replica node for a + * specific STANDARD tier Cloud Memorystore for Redis instance.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • upgradeInstanceAsync(UpgradeInstanceRequest request) + *
    • failoverInstanceAsync(FailoverInstanceRequest request) *
    *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    *
      - *
    • upgradeInstanceAsync(InstanceName name) - *
    • upgradeInstanceAsync(String name) + *
    • failoverInstanceAsync(InstanceName name) + *
    • failoverInstanceAsync(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • upgradeInstanceOperationCallable() - *
    • upgradeInstanceCallable() + *
    • failoverInstanceOperationCallable() + *
    • failoverInstanceCallable() *
    * * @@ -343,6 +322,27 @@ * * * + * + * RescheduleMaintenance + *

    Reschedule maintenance for a given instance in a given project and + * location.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) + *
    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *
      + *
    • rescheduleMaintenanceAsync(InstanceName name) + *
    • rescheduleMaintenanceAsync(String name) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • rescheduleMaintenanceOperationCallable() + *
    • rescheduleMaintenanceCallable() + *
    + * + * * * *

    See the individual methods for example code. diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index 1377677719..cd97389ba8 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -84,57 +84,120 @@ * Description * Method Variants * - * DeleteNotification - *

    Permanently deletes a notification subscription.

    + * DeleteBucket + *

    Permanently deletes an empty bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteNotification(DeleteNotificationRequest request) + *
    • deleteBucket(DeleteBucketRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteNotification(NotificationName name) - *
    • deleteNotification(String name) + *
    • deleteBucket(BucketName name) + *
    • deleteBucket(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteNotificationCallable() + *
    • deleteBucketCallable() *
    * * * - * DeleteObject - *

    Deletes an object and its metadata. Deletions are permanent if versioning - * is not enabled for the bucket, or if the `generation` parameter is used.

    + * GetBucket + *

    Returns metadata for the specified bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteObject(DeleteObjectRequest request) + *
    • getBucket(GetBucketRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteObject(String bucket) - *
    • deleteObject(String bucket) + *
    • getBucket(BucketName name) + *
    • getBucket(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteObjectCallable() + *
    • getBucketCallable() *
    * * * - * StartResumableWrite - *

    Starts a resumable write. How long the write operation remains valid, and - * what happens when the write operation becomes invalid, are - * service-dependent.

    + * CreateBucket + *

    Creates a new bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • startResumableWrite(StartResumableWriteRequest request) + *
    • createBucket(CreateBucketRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createBucket(ProjectName parent) + *
    • createBucket(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • startResumableWriteCallable() + *
    • createBucketCallable() + *
    + * + * + * + * ListBuckets + *

    Retrieves a list of buckets for a given project.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • listBuckets(ListBucketsRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • listBuckets(ProjectName parent) + *
    • listBuckets(String parent) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • listBucketsPagedCallable() + *
    • listBucketsCallable() + *
    + * + * + * + * LockBucketRetentionPolicy + *

    Locks retention policy on a bucket.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • lockBucketRetentionPolicy(BucketName bucket) + *
    • lockBucketRetentionPolicy(String bucket) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • lockBucketRetentionPolicyCallable() + *
    + * + * + * + * GetIamPolicy + *

    Gets the IAM policy for a specified bucket or object. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getIamPolicy(GetIamPolicyRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getIamPolicy(ResourceName resource) + *
    • getIamPolicy(String resource) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getIamPolicyCallable() *
    * * @@ -161,160 +224,176 @@ * * * - * ListNotifications - *

    Retrieves a list of notification subscriptions for a given bucket.

    + * TestIamPermissions + *

    Tests a set of permissions on the given bucket or object to see which, if + * any, are held by the caller. + * The `resource` field in the request should be + * projects/_/buckets/ for a bucket or + * projects/_/buckets//objects/ for an object.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listNotifications(ListNotificationsRequest request) + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listNotifications(ProjectName parent) - *
    • listNotifications(String parent) + *
    • testIamPermissions(ResourceName resource) + *
    • testIamPermissions(String resource) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listNotificationsPagedCallable() - *
    • listNotificationsCallable() + *
    • testIamPermissionsCallable() *
    * * * - * UpdateHmacKey - *

    Updates a given HMAC key state between ACTIVE and INACTIVE.

    + * UpdateBucket + *

    Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateHmacKey(UpdateHmacKeyRequest request) + *
    • updateBucket(UpdateBucketRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateHmacKey(HmacKeyMetadata hmacKey) + *
    • updateBucket(Bucket bucket) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateHmacKeyCallable() + *
    • updateBucketCallable() *
    * * * - * GetHmacKey - *

    Gets an existing HMAC key metadata for the given id.

    + * DeleteNotification + *

    Permanently deletes a notification subscription.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getHmacKey(GetHmacKeyRequest request) + *
    • deleteNotification(DeleteNotificationRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getHmacKey(String accessId) - *
    • getHmacKey(String accessId) + *
    • deleteNotification(NotificationName name) + *
    • deleteNotification(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getHmacKeyCallable() + *
    • deleteNotificationCallable() *
    * * * - * DeleteBucket - *

    Permanently deletes an empty bucket.

    + * GetNotification + *

    View a notification config.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteBucket(DeleteBucketRequest request) + *
    • getNotification(GetNotificationRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteBucket(BucketName name) - *
    • deleteBucket(String name) + *
    • getNotification(BucketName name) + *
    • getNotification(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteBucketCallable() + *
    • getNotificationCallable() *
    * * * - * TestIamPermissions - *

    Tests a set of permissions on the given bucket or object to see which, if - * any, are held by the caller. - * The `resource` field in the request should be - * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object.

    + * CreateNotification + *

    Creates a notification subscription for a given bucket. + * These notifications, when triggered, publish messages to the specified + * Pub/Sub topics. + * See https://cloud.google.com/storage/docs/pubsub-notifications.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • createNotification(CreateNotificationRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • testIamPermissions(ResourceName resource) - *
    • testIamPermissions(String resource) + *
    • createNotification(ProjectName parent) + *
    • createNotification(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • createNotificationCallable() *
    * * * - * ListBuckets - *

    Retrieves a list of buckets for a given project.

    + * ListNotifications + *

    Retrieves a list of notification subscriptions for a given bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listBuckets(ListBucketsRequest request) + *
    • listNotifications(ListNotificationsRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listBuckets(ProjectName parent) - *
    • listBuckets(String parent) + *
    • listNotifications(ProjectName parent) + *
    • listNotifications(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listBucketsPagedCallable() - *
    • listBucketsCallable() + *
    • listNotificationsPagedCallable() + *
    • listNotificationsCallable() *
    * * * - * DeleteHmacKey - *

    Deletes a given HMAC key. Key must be in an INACTIVE state.

    + * ComposeObject + *

    Concatenates a list of existing objects into a new object in the same + * bucket.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteHmacKey(DeleteHmacKeyRequest request) + *
    • composeObject(ComposeObjectRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • composeObjectCallable() + *
    + * + * + * + * DeleteObject + *

    Deletes an object and its metadata. Deletions are permanent if versioning + * is not enabled for the bucket, or if the `generation` parameter is used.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteObject(DeleteObjectRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • deleteHmacKey(String accessId) - *
    • deleteHmacKey(String accessId) + *
    • deleteObject(String bucket) + *
    • deleteObject(String bucket) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteHmacKeyCallable() + *
    • deleteObjectCallable() *
    * * * - * ListHmacKeys - *

    Lists HMAC keys under a given project with the additional filters provided.

    + * CancelResumableWrite + *

    Cancels an in-progress resumable upload.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listHmacKeys(ListHmacKeysRequest request) + *
    • cancelResumableWrite(CancelResumableWriteRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • listHmacKeys(ProjectName project) - *
    • listHmacKeys(String project) + *
    • cancelResumableWrite(String uploadId) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listHmacKeysPagedCallable() - *
    • listHmacKeysCallable() + *
    • cancelResumableWriteCallable() *
    * * @@ -338,24 +417,31 @@ * * * - * CreateNotification - *

    Creates a notification subscription for a given bucket. - * These notifications, when triggered, publish messages to the specified - * Pub/Sub topics. - * See https://cloud.google.com/storage/docs/pubsub-notifications.

    + * ReadObject + *

    Reads an object's data.

    + * + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • readObjectCallable() + *
    + * + * + * + * UpdateObject + *

    Updates an object's metadata. + * Equivalent to JSON API's storage.objects.patch.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createNotification(CreateNotificationRequest request) + *
    • updateObject(UpdateObjectRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createNotification(ProjectName parent) - *
    • createNotification(String parent) + *
    • updateObject(Object object) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createNotificationCallable() + *
    • updateObjectCallable() *
    * * @@ -421,25 +507,6 @@ * * * - * GetServiceAccount - *

    Retrieves the name of a project's Google Cloud Storage service account.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getServiceAccount(GetServiceAccountRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getServiceAccount(ProjectName project) - *
    • getServiceAccount(String project) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getServiceAccountCallable() - *
    - * - * - * * ListObjects *

    Retrieves a list of objects matching the criteria.

    * @@ -460,62 +527,33 @@ * * * - * GetBucket - *

    Returns metadata for the specified bucket.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getBucket(GetBucketRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getBucket(BucketName name) - *
    • getBucket(String name) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getBucketCallable() - *
    - * - * - * - * UpdateObject - *

    Updates an object's metadata. - * Equivalent to JSON API's storage.objects.patch.

    + * RewriteObject + *

    Rewrites a source object to a destination object. Optionally overrides + * metadata.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateObject(UpdateObjectRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • updateObject(Object object) + *
    • rewriteObject(RewriteObjectRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateObjectCallable() + *
    • rewriteObjectCallable() *
    * * * - * GetIamPolicy - *

    Gets the IAM policy for a specified bucket or object. - * The `resource` field in the request should be - * projects/_/buckets/ for a bucket or - * projects/_/buckets//objects/ for an object.

    + * StartResumableWrite + *

    Starts a resumable write. How long the write operation remains valid, and + * what happens when the write operation becomes invalid, are + * service-dependent.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • getIamPolicy(ResourceName resource) - *
    • getIamPolicy(String resource) + *
    • startResumableWrite(StartResumableWriteRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • startResumableWriteCallable() *
    * * @@ -550,36 +588,21 @@ * * * - * RewriteObject - *

    Rewrites a source object to a destination object. Optionally overrides - * metadata.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • rewriteObject(RewriteObjectRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • rewriteObjectCallable() - *
    - * - * - * - * LockBucketRetentionPolicy - *

    Locks retention policy on a bucket.

    + * GetServiceAccount + *

    Retrieves the name of a project's Google Cloud Storage service account.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) + *
    • getServiceAccount(GetServiceAccountRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • lockBucketRetentionPolicy(BucketName bucket) - *
    • lockBucketRetentionPolicy(String bucket) + *
    • getServiceAccount(ProjectName project) + *
    • getServiceAccount(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • lockBucketRetentionPolicyCallable() + *
    • getServiceAccountCallable() *
    * * @@ -603,101 +626,78 @@ * * * - * ComposeObject - *

    Concatenates a list of existing objects into a new object in the same - * bucket.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • composeObject(ComposeObjectRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • composeObjectCallable() - *
    - * - * - * - * CancelResumableWrite - *

    Cancels an in-progress resumable upload.

    + * DeleteHmacKey + *

    Deletes a given HMAC key. Key must be in an INACTIVE state.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • cancelResumableWrite(CancelResumableWriteRequest request) + *
    • deleteHmacKey(DeleteHmacKeyRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • cancelResumableWrite(String uploadId) + *
    • deleteHmacKey(String accessId) + *
    • deleteHmacKey(String accessId) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • cancelResumableWriteCallable() + *
    • deleteHmacKeyCallable() *
    * * * - * UpdateBucket - *

    Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.

    + * GetHmacKey + *

    Gets an existing HMAC key metadata for the given id.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateBucket(UpdateBucketRequest request) + *
    • getHmacKey(GetHmacKeyRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • updateBucket(Bucket bucket) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • updateBucketCallable() + *
    • getHmacKey(String accessId) + *
    • getHmacKey(String accessId) *
    - * - * - * - * ReadObject - *

    Reads an object's data.

    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • readObjectCallable() + *
    • getHmacKeyCallable() *
    * * * - * CreateBucket - *

    Creates a new bucket.

    + * ListHmacKeys + *

    Lists HMAC keys under a given project with the additional filters provided.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createBucket(CreateBucketRequest request) + *
    • listHmacKeys(ListHmacKeysRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • createBucket(ProjectName parent) - *
    • createBucket(String parent) + *
    • listHmacKeys(ProjectName project) + *
    • listHmacKeys(String project) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createBucketCallable() + *
    • listHmacKeysPagedCallable() + *
    • listHmacKeysCallable() *
    * * * - * GetNotification - *

    View a notification config.

    + * UpdateHmacKey + *

    Updates a given HMAC key state between ACTIVE and INACTIVE.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getNotification(GetNotificationRequest request) + *
    • updateHmacKey(UpdateHmacKeyRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getNotification(BucketName name) - *
    • getNotification(String name) + *
    • updateHmacKey(HmacKeyMetadata hmacKey) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getNotificationCallable() + *
    • updateHmacKeyCallable() *
    * * From a1845a941b86c3a8fe823120f0629f3ad2e3bef1 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 10 Nov 2023 11:27:35 -0500 Subject: [PATCH 14/21] update showcase goldens --- .../showcase/v1beta1/ComplianceClient.java | 168 +++++------ .../google/showcase/v1beta1/EchoClient.java | 160 +++++----- .../showcase/v1beta1/IdentityClient.java | 122 ++++---- .../showcase/v1beta1/MessagingClient.java | 276 +++++++++--------- .../v1beta1/SequenceServiceClient.java | 130 ++++----- .../showcase/v1beta1/TestingClient.java | 150 +++++----- 6 files changed, 503 insertions(+), 503 deletions(-) diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java index ea0b20f52e..e1ba243756 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java @@ -85,54 +85,33 @@ * Description * Method Variants * - * GetEnum - *

    This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the - * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the - * response from this RPC as the request to VerifyEnum() - * - * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for - * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getEnum(EnumRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getEnumCallable() - *
    - * - * - * - * RepeatDataPathTrailingResource - *

    Same as RepeatDataSimplePath, but with a trailing resource.

    + * RepeatDataBody + *

    This method echoes the ComplianceData request. This method exercises + * sending the entire request object in the REST body.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • repeatDataPathTrailingResource(RepeatRequest request) + *
    • repeatDataBody(RepeatRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • repeatDataPathTrailingResourceCallable() + *
    • repeatDataBodyCallable() *
    * * * - * VerifyEnum - *

    This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum() - * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds - * with the same EnumResponse; otherwise, the RPC errors. - * - * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run, - * although they are not guaranteed to be the same across separate Showcase server runs.

    + * RepeatDataBodyInfo + *

    This method echoes the ComplianceData request. This method exercises + * sending the a message-type field in the REST body. Per AIP-127, only + * top-level, non-repeated fields can be sent this way.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • verifyEnum(EnumResponse request) + *
    • repeatDataBodyInfo(RepeatRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • verifyEnumCallable() + *
    • repeatDataBodyInfoCallable() *
    * * @@ -152,51 +131,46 @@ * * * - * GetIamPolicy - *

    Gets the access control policy for a resource. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    + * RepeatDataSimplePath + *

    This method echoes the ComplianceData request. This method exercises + * sending some parameters as "simple" path variables (i.e., of the form + * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • repeatDataSimplePath(RepeatRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • repeatDataSimplePathCallable() *
    * * * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces any - * existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    + * RepeatDataPathResource + *

    Same as RepeatDataSimplePath, but with a path resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • setIamPolicy(SetIamPolicyRequest request) + *
    • repeatDataPathResource(RepeatRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • setIamPolicyCallable() + *
    • repeatDataPathResourceCallable() *
    * * * - * RepeatDataSimplePath - *

    This method echoes the ComplianceData request. This method exercises - * sending some parameters as "simple" path variables (i.e., of the form - * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters.

    + * RepeatDataPathTrailingResource + *

    Same as RepeatDataSimplePath, but with a trailing resource.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • repeatDataSimplePath(RepeatRequest request) + *
    • repeatDataPathTrailingResource(RepeatRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • repeatDataSimplePathCallable() + *
    • repeatDataPathTrailingResourceCallable() *
    * * @@ -229,96 +203,122 @@ * * * - * GetLocation - *

    Gets information about a location.

    + * GetEnum + *

    This method requests an enum value from the server. Depending on the contents of EnumRequest, the enum value returned will be a known enum declared in the + * .proto file, or a made-up enum value the is unknown to the client. To verify that clients can round-trip unknown enum vaues they receive, use the + * response from this RPC as the request to VerifyEnum() + * + * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for + * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getLocation(GetLocationRequest request) + *
    • getEnum(EnumRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getLocationCallable() + *
    • getEnumCallable() *
    * * * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. - * If the resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. + * VerifyEnum + *

    This method is used to verify that clients can round-trip enum values, which is particularly important for unknown enum values over REST. VerifyEnum() + * verifies that its request, which is presumably the response that the client previously got to a GetEnum(), contains the correct data. If so, it responds + * with the same EnumResponse; otherwise, the RPC errors. * - * Note: This operation is designed to be used for building permission-aware - * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning.

    + * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run, + * although they are not guaranteed to be the same across separate Showcase server runs.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • verifyEnum(EnumResponse request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • verifyEnumCallable() *
    * * * - * RepeatDataPathResource - *

    Same as RepeatDataSimplePath, but with a path resource.

    + * ListLocations + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • repeatDataPathResource(RepeatRequest request) + *
    • listLocations(ListLocationsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • repeatDataPathResourceCallable() + *
    • listLocationsPagedCallable() + *
    • listLocationsCallable() *
    * * * - * ListLocations - *

    Lists information about the supported locations for this service.

    + * GetLocation + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listLocations(ListLocationsRequest request) + *
    • getLocation(GetLocationRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listLocationsPagedCallable() - *
    • listLocationsCallable() + *
    • getLocationCallable() *
    * * * - * RepeatDataBody - *

    This method echoes the ComplianceData request. This method exercises - * sending the entire request object in the REST body.

    + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • repeatDataBody(RepeatRequest request) + *
    • setIamPolicy(SetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • repeatDataBodyCallable() + *
    • setIamPolicyCallable() *
    * * * - * RepeatDataBodyInfo - *

    This method echoes the ComplianceData request. This method exercises - * sending the a message-type field in the REST body. Per AIP-127, only - * top-level, non-repeated fields can be sent this way.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • repeatDataBodyInfo(RepeatRequest request) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • repeatDataBodyInfoCallable() + *
    • getIamPolicyCallable() + *
    + * + * + * + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • testIamPermissionsCallable() *
    * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java index 28d8b11732..b7bf1b3a9f 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java @@ -88,35 +88,27 @@ * Description * Method Variants * - * PagedExpandLegacyMapped - *

    This method returns a map containing lists of words that appear in the input, keyed by their - * initial character. The only words returned are the ones included in the current page, - * as determined by page_token and page_size, which both refer to the word indices in the - * input. This paging result consisting of a map of lists is a pattern used by some legacy - * APIs. New APIs should NOT use this pattern.

    + * Echo + *

    This method simply echoes the request. This method showcases unary RPCs.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • pagedExpandLegacyMapped(PagedExpandRequest request) + *
    • echo(EchoRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • pagedExpandLegacyMappedPagedCallable() - *
    • pagedExpandLegacyMappedCallable() + *
    • echoCallable() *
    * * * - * Echo - *

    This method simply echoes the request. This method showcases unary RPCs.

    + * Expand + *

    This method splits the given content into words and will pass each word back + * through the stream. This method showcases server-side streaming RPCs.

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • echo(EchoRequest request) - *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • echoCallable() + *
    • expandCallable() *
    * * @@ -133,6 +125,18 @@ * * * + * Chat + *

    This method, upon receiving a request on the stream, will pass the same + * content back on the stream. This method showcases bidirectional + * streaming RPCs.

    + * + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • chatCallable() + *
    + * + * + * * PagedExpand *

    This is similar to the Expand method but instead of returning a stream of * expanded words, this method returns a paged list of expanded words.

    @@ -149,155 +153,151 @@ * * * - * GetIamPolicy - *

    Gets the access control policy for a resource. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    + * PagedExpandLegacy + *

    This is similar to the PagedExpand except that it uses + * max_results instead of page_size, as some legacy APIs still + * do. New APIs should NOT use this pattern.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • pagedExpandLegacy(PagedExpandLegacyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • pagedExpandLegacyCallable() *
    * * * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces any - * existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    + * PagedExpandLegacyMapped + *

    This method returns a map containing lists of words that appear in the input, keyed by their + * initial character. The only words returned are the ones included in the current page, + * as determined by page_token and page_size, which both refer to the word indices in the + * input. This paging result consisting of a map of lists is a pattern used by some legacy + * APIs. New APIs should NOT use this pattern.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • setIamPolicy(SetIamPolicyRequest request) + *
    • pagedExpandLegacyMapped(PagedExpandRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • setIamPolicyCallable() + *
    • pagedExpandLegacyMappedPagedCallable() + *
    • pagedExpandLegacyMappedCallable() *
    * * * - * PagedExpandLegacy - *

    This is similar to the PagedExpand except that it uses - * max_results instead of page_size, as some legacy APIs still - * do. New APIs should NOT use this pattern.

    + * Wait + *

    This method will wait for the requested amount of time and then return. + * This method showcases how a client handles a request timeout.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • pagedExpandLegacy(PagedExpandLegacyRequest request) + *
    • waitAsync(WaitRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • pagedExpandLegacyCallable() + *
    • waitOperationCallable() + *
    • waitCallable() *
    * * * - * Expand - *

    This method splits the given content into words and will pass each word back - * through the stream. This method showcases server-side streaming RPCs.

    + * Block + *

    This method will block (wait) for the requested amount of time + * and then return the response or error. + * This method showcases how a client handles delays or retries.

    * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • expandCallable() + *
    • block(BlockRequest request) *
    - * - * - * - * Chat - *

    This method, upon receiving a request on the stream, will pass the same - * content back on the stream. This method showcases bidirectional - * streaming RPCs.

    - * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • chatCallable() + *
    • blockCallable() *
    * * * - * GetLocation - *

    Gets information about a location.

    + * ListLocations + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getLocation(GetLocationRequest request) + *
    • listLocations(ListLocationsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getLocationCallable() + *
    • listLocationsPagedCallable() + *
    • listLocationsCallable() *
    * * * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. - * If the resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building permission-aware - * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning.

    + * GetLocation + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • getLocation(GetLocationRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • getLocationCallable() *
    * * * - * Block - *

    This method will block (wait) for the requested amount of time - * and then return the response or error. - * This method showcases how a client handles delays or retries.

    + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • block(BlockRequest request) + *
    • setIamPolicy(SetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • blockCallable() + *
    • setIamPolicyCallable() *
    * * * - * Wait - *

    This method will wait for the requested amount of time and then return. - * This method showcases how a client handles a request timeout.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • waitAsync(WaitRequest request) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • waitOperationCallable() - *
    • waitCallable() + *
    • getIamPolicyCallable() *
    * * * - * ListLocations - *

    Lists information about the supported locations for this service.

    + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listLocations(ListLocationsRequest request) + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listLocationsPagedCallable() - *
    • listLocationsCallable() + *
    • testIamPermissionsCallable() *
    * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java index 66b88219a5..320f1d282a 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java @@ -72,86 +72,54 @@ * Description * Method Variants * - * ListUsers - *

    Lists all users.

    + * CreateUser + *

    Creates a user.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listUsers(ListUsersRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • listUsersPagedCallable() - *
    • listUsersCallable() + *
    • createUser(CreateUserRequest request) *
    - * - * - * - * GetIamPolicy - *

    Gets the access control policy for a resource. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • createUser(String displayName) + *
    • createUser(String displayName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • createUserCallable() *
    * * * - * GetLocation - *

    Gets information about a location.

    + * GetUser + *

    Retrieves the User with the given uri.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getLocation(GetLocationRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • getLocationCallable() + *
    • getUser(GetUserRequest request) *
    - * - * - * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. - * If the resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building permission-aware - * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • getUser(UserName name) + *
    • getUser(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • getUserCallable() *
    * * * - * CreateUser - *

    Creates a user.

    + * UpdateUser + *

    Updates a user.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createUser(CreateUserRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createUser(String displayName) - *
    • createUser(String displayName) + *
    • updateUser(UpdateUserRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createUserCallable() + *
    • updateUserCallable() *
    * * @@ -175,16 +143,17 @@ * * * - * UpdateUser - *

    Updates a user.

    + * ListUsers + *

    Lists all users.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateUser(UpdateUserRequest request) + *
    • listUsers(ListUsersRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateUserCallable() + *
    • listUsersPagedCallable() + *
    • listUsersCallable() *
    * * @@ -204,6 +173,20 @@ * * * + * GetLocation + *

    Gets information about a location.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getLocation(GetLocationRequest request) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • getLocationCallable() + *
    + * + * + * * SetIamPolicy *

    Sets the access control policy on the specified resource. Replaces any * existing policy. @@ -221,21 +204,38 @@ * * * - * GetUser - *

    Retrieves the User with the given uri.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getUser(GetUserRequest request) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getUser(UserName name) - *
    • getUser(String name) + *
    • getIamPolicyCallable() + *
    + * + * + * + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getUserCallable() + *
    • testIamPermissionsCallable() *
    * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java index 826ec2f117..7651d212e6 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java @@ -83,148 +83,170 @@ * Description * Method Variants * - * SearchBlurbs - *

    This method searches through all blurbs across all rooms and profiles - * for blurbs containing to words found in the query. Only posts that - * contain an exact match of a queried word will be returned.

    + * CreateRoom + *

    Creates a room.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • searchBlurbsAsync(SearchBlurbsRequest request) + *
    • createRoom(CreateRoomRequest request) *
    - *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • searchBlurbsAsync(ProfileName parent) - *
    • searchBlurbsAsync(RoomName parent) - *
    • searchBlurbsAsync(String parent) + *
    • createRoom(String displayName) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • searchBlurbsOperationCallable() - *
    • searchBlurbsCallable() + *
    • createRoomCallable() *
    * * * - * Connect - *

    This method starts a bidirectional stream that receives all blurbs that - * are being created after the stream has started and sends requests to create - * blurbs. If an invalid blurb is requested to be created, the stream will - * close with an error.

    + * GetRoom + *

    Retrieves the Room with the given resource name.

    * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • getRoom(GetRoomRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • getRoom(RoomName name) + *
    • getRoom(String name) + *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • connectCallable() + *
    • getRoomCallable() *
    * * * - * GetIamPolicy - *

    Gets the access control policy for a resource. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    + * UpdateRoom + *

    Updates a room.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • updateRoom(UpdateRoomRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • updateRoomCallable() *
    * * * - * SendBlurbs - *

    This is a stream to create multiple blurbs. If an invalid blurb is - * requested to be created, the stream will close with an error.

    + * DeleteRoom + *

    Deletes a room and all of its blurbs.

    * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • deleteRoom(DeleteRoomRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteRoom(RoomName name) + *
    • deleteRoom(String name) + *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • sendBlurbsCallable() + *
    • deleteRoomCallable() *
    * * * - * UpdateRoom - *

    Updates a room.

    + * ListRooms + *

    Lists all chat rooms.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateRoom(UpdateRoomRequest request) + *
    • listRooms(ListRoomsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateRoomCallable() + *
    • listRoomsPagedCallable() + *
    • listRoomsCallable() *
    * * * - * GetBlurb - *

    Retrieves the Blurb with the given resource name.

    + * CreateBlurb + *

    Creates a blurb. If the parent is a room, the blurb is understood to be a + * message in that room. If the parent is a profile, the blurb is understood + * to be a post on the profile.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getBlurb(GetBlurbRequest request) + *
    • createBlurb(CreateBlurbRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getBlurb(BlurbName name) - *
    • getBlurb(String name) + *
    • createBlurb(ProfileName parent) + *
    • createBlurb(ProfileName parent) + *
    • createBlurb(ProfileName parent) + *
    • createBlurb(ProfileName parent) + *
    • createBlurb(RoomName parent) + *
    • createBlurb(RoomName parent) + *
    • createBlurb(RoomName parent) + *
    • createBlurb(RoomName parent) + *
    • createBlurb(String parent) + *
    • createBlurb(String parent) + *
    • createBlurb(String parent) + *
    • createBlurb(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getBlurbCallable() + *
    • createBlurbCallable() *
    * * * - * GetRoom - *

    Retrieves the Room with the given resource name.

    + * GetBlurb + *

    Retrieves the Blurb with the given resource name.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getRoom(GetRoomRequest request) + *
    • getBlurb(GetBlurbRequest request) *
    *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    *
      - *
    • getRoom(RoomName name) - *
    • getRoom(String name) + *
    • getBlurb(BlurbName name) + *
    • getBlurb(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getRoomCallable() + *
    • getBlurbCallable() *
    * * * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces any - * existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    + * UpdateBlurb + *

    Updates a blurb.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • setIamPolicy(SetIamPolicyRequest request) + *
    • updateBlurb(UpdateBlurbRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • setIamPolicyCallable() + *
    • updateBlurbCallable() *
    * * * - * UpdateBlurb - *

    Updates a blurb.

    + * DeleteBlurb + *

    Deletes a blurb.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • updateBlurb(UpdateBlurbRequest request) + *
    • deleteBlurb(DeleteBlurbRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • deleteBlurb(BlurbName name) + *
    • deleteBlurb(String name) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • updateBlurbCallable() + *
    • deleteBlurbCallable() *
    * * @@ -251,164 +273,142 @@ * * * - * StreamBlurbs - *

    This returns a stream that emits the blurbs that are created for a - * particular chat room or user profile.

    - * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • streamBlurbsCallable() - *
    - * - * - * - * DeleteRoom - *

    Deletes a room and all of its blurbs.

    + * SearchBlurbs + *

    This method searches through all blurbs across all rooms and profiles + * for blurbs containing to words found in the query. Only posts that + * contain an exact match of a queried word will be returned.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteRoom(DeleteRoomRequest request) + *
    • searchBlurbsAsync(SearchBlurbsRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

    *
      - *
    • deleteRoom(RoomName name) - *
    • deleteRoom(String name) + *
    • searchBlurbsAsync(ProfileName parent) + *
    • searchBlurbsAsync(RoomName parent) + *
    • searchBlurbsAsync(String parent) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteRoomCallable() + *
    • searchBlurbsOperationCallable() + *
    • searchBlurbsCallable() *
    * * * - * ListRooms - *

    Lists all chat rooms.

    + * StreamBlurbs + *

    This returns a stream that emits the blurbs that are created for a + * particular chat room or user profile.

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • listRooms(ListRoomsRequest request) - *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listRoomsPagedCallable() - *
    • listRoomsCallable() + *
    • streamBlurbsCallable() *
    * * * - * GetLocation - *

    Gets information about a location.

    + * SendBlurbs + *

    This is a stream to create multiple blurbs. If an invalid blurb is + * requested to be created, the stream will close with an error.

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getLocation(GetLocationRequest request) + *
    • sendBlurbsCallable() *
    + * + * + * + * Connect + *

    This method starts a bidirectional stream that receives all blurbs that + * are being created after the stream has started and sends requests to create + * blurbs. If an invalid blurb is requested to be created, the stream will + * close with an error.

    + * *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getLocationCallable() + *
    • connectCallable() *
    * * * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. - * If the resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building permission-aware - * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning.

    + * ListLocations + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • listLocations(ListLocationsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • listLocationsPagedCallable() + *
    • listLocationsCallable() *
    * * * - * CreateRoom - *

    Creates a room.

    + * GetLocation + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createRoom(CreateRoomRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createRoom(String displayName) + *
    • getLocation(GetLocationRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createRoomCallable() + *
    • getLocationCallable() *
    * * * - * ListLocations - *

    Lists information about the supported locations for this service.

    + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listLocations(ListLocationsRequest request) + *
    • setIamPolicy(SetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listLocationsPagedCallable() - *
    • listLocationsCallable() + *
    • setIamPolicyCallable() *
    * * * - * CreateBlurb - *

    Creates a blurb. If the parent is a room, the blurb is understood to be a - * message in that room. If the parent is a profile, the blurb is understood - * to be a post on the profile.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createBlurb(CreateBlurbRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createBlurb(ProfileName parent) - *
    • createBlurb(ProfileName parent) - *
    • createBlurb(ProfileName parent) - *
    • createBlurb(ProfileName parent) - *
    • createBlurb(RoomName parent) - *
    • createBlurb(RoomName parent) - *
    • createBlurb(RoomName parent) - *
    • createBlurb(RoomName parent) - *
    • createBlurb(String parent) - *
    • createBlurb(String parent) - *
    • createBlurb(String parent) - *
    • createBlurb(String parent) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createBlurbCallable() + *
    • getIamPolicyCallable() *
    * * * - * DeleteBlurb - *

    Deletes a blurb.

    + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteBlurb(DeleteBlurbRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • deleteBlurb(BlurbName name) - *
    • deleteBlurb(String name) + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteBlurbCallable() + *
    • testIamPermissionsCallable() *
    * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java index 9b6f0220f2..870d155c13 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java @@ -71,6 +71,42 @@ * Description * Method Variants * + * CreateSequence + *

    Creates a sequence.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createSequence(CreateSequenceRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createSequence(Sequence sequence) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createSequenceCallable() + *
    + * + * + * + * CreateStreamingSequence + *

    Creates a sequence.

    + * + *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *
      + *
    • createStreamingSequence(CreateStreamingSequenceRequest request) + *
    + *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *
      + *
    • createStreamingSequence(StreamingSequence streamingSequence) + *
    + *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *
      + *
    • createStreamingSequenceCallable() + *
    + * + * + * * GetSequenceReport *

    Retrieves a sequence.

    * @@ -109,16 +145,6 @@ * * * - * AttemptStreamingSequence - *

    Attempts a streaming sequence.

    - * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • attemptStreamingSequenceCallable() - *
    - * - * - * * AttemptSequence *

    Attempts a sequence.

    * @@ -138,36 +164,27 @@ * * * - * GetIamPolicy - *

    Gets the access control policy for a resource. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    + * AttemptStreamingSequence + *

    Attempts a streaming sequence.

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • getIamPolicy(GetIamPolicyRequest request) - *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • attemptStreamingSequenceCallable() *
    * * * - * CreateStreamingSequence - *

    Creates a sequence.

    + * ListLocations + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createStreamingSequence(CreateStreamingSequenceRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createStreamingSequence(StreamingSequence streamingSequence) + *
    • listLocations(ListLocationsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createStreamingSequenceCallable() + *
    • listLocationsPagedCallable() + *
    • listLocationsCallable() *
    * * @@ -186,72 +203,55 @@ * * * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. - * If the resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces any + * existing policy. * - * Note: This operation is designed to be used for building permission-aware - * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning.

    - * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    - *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) - *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    - *
      - *
    • testIamPermissionsCallable() - *
    - * - * - * - * CreateSequence - *

    Creates a sequence.

    + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createSequence(CreateSequenceRequest request) - *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    - *
      - *
    • createSequence(Sequence sequence) + *
    • setIamPolicy(SetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createSequenceCallable() + *
    • setIamPolicyCallable() *
    * * * - * ListLocations - *

    Lists information about the supported locations for this service.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listLocations(ListLocationsRequest request) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listLocationsPagedCallable() - *
    • listLocationsCallable() + *
    • getIamPolicyCallable() *
    * * * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces any - * existing policy. + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • setIamPolicy(SetIamPolicyRequest request) + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • setIamPolicyCallable() + *
    • testIamPermissionsCallable() *
    * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java index b4046ff2be..a0bd68aeb6 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java @@ -72,208 +72,208 @@ * Description * Method Variants * - * DeleteTest - *

    Explicitly decline to implement a test. - * - * This removes the test from subsequent `ListTests` calls, and - * attempting to do the test will error. - * - * This method will error if attempting to delete a required test.

    + * CreateSession + *

    Creates a new testing session.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteTest(DeleteTestRequest request) + *
    • createSession(CreateSessionRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteTestCallable() + *
    • createSessionCallable() *
    * * * - * GetIamPolicy - *

    Gets the access control policy for a resource. - * Returns an empty policy if the resource exists and does not have a policy - * set.

    + * GetSession + *

    Gets a testing session.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getIamPolicy(GetIamPolicyRequest request) + *
    • getSession(GetSessionRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getIamPolicyCallable() + *
    • getSessionCallable() *
    * * * - * CreateSession - *

    Creates a new testing session.

    + * ListSessions + *

    Lists the current test sessions.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • createSession(CreateSessionRequest request) + *
    • listSessions(ListSessionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • createSessionCallable() + *
    • listSessionsPagedCallable() + *
    • listSessionsCallable() *
    * * * - * SetIamPolicy - *

    Sets the access control policy on the specified resource. Replaces any - * existing policy. - * - * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    + * DeleteSession + *

    Delete a test session.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • setIamPolicy(SetIamPolicyRequest request) + *
    • deleteSession(DeleteSessionRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • setIamPolicyCallable() + *
    • deleteSessionCallable() *
    * * * - * GetSession - *

    Gets a testing session.

    + * ReportSession + *

    Report on the status of a session. + * This generates a report detailing which tests have been completed, + * and an overall rollup.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getSession(GetSessionRequest request) + *
    • reportSession(ReportSessionRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getSessionCallable() + *
    • reportSessionCallable() *
    * * * - * DeleteSession - *

    Delete a test session.

    + * ListTests + *

    List the tests of a sessesion.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • deleteSession(DeleteSessionRequest request) + *
    • listTests(ListTestsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • deleteSessionCallable() + *
    • listTestsPagedCallable() + *
    • listTestsCallable() *
    * * * - * VerifyTest - *

    Register a response to a test. + * DeleteTest + *

    Explicitly decline to implement a test. * - * In cases where a test involves registering a final answer at the - * end of the test, this method provides the means to do so.

    + * This removes the test from subsequent `ListTests` calls, and + * attempting to do the test will error. + * + * This method will error if attempting to delete a required test.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • verifyTest(VerifyTestRequest request) + *
    • deleteTest(DeleteTestRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • verifyTestCallable() + *
    • deleteTestCallable() *
    * * * - * GetLocation - *

    Gets information about a location.

    + * VerifyTest + *

    Register a response to a test. + * + * In cases where a test involves registering a final answer at the + * end of the test, this method provides the means to do so.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • getLocation(GetLocationRequest request) + *
    • verifyTest(VerifyTestRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • getLocationCallable() + *
    • verifyTestCallable() *
    * * * - * TestIamPermissions - *

    Returns permissions that a caller has on the specified resource. - * If the resource does not exist, this will return an empty set of - * permissions, not a `NOT_FOUND` error. - * - * Note: This operation is designed to be used for building permission-aware - * UIs and command-line tools, not for authorization checking. This operation - * may "fail open" without warning.

    + * ListLocations + *

    Lists information about the supported locations for this service.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • testIamPermissions(TestIamPermissionsRequest request) + *
    • listLocations(ListLocationsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • testIamPermissionsCallable() + *
    • listLocationsPagedCallable() + *
    • listLocationsCallable() *
    * * * - * ListTests - *

    List the tests of a sessesion.

    + * GetLocation + *

    Gets information about a location.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listTests(ListTestsRequest request) + *
    • getLocation(GetLocationRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listTestsPagedCallable() - *
    • listTestsCallable() + *
    • getLocationCallable() *
    * * * - * ListLocations - *

    Lists information about the supported locations for this service.

    + * SetIamPolicy + *

    Sets the access control policy on the specified resource. Replaces any + * existing policy. + * + * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listLocations(ListLocationsRequest request) + *
    • setIamPolicy(SetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listLocationsPagedCallable() - *
    • listLocationsCallable() + *
    • setIamPolicyCallable() *
    * * * - * ReportSession - *

    Report on the status of a session. - * This generates a report detailing which tests have been completed, - * and an overall rollup.

    + * GetIamPolicy + *

    Gets the access control policy for a resource. + * Returns an empty policy if the resource exists and does not have a policy + * set.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • reportSession(ReportSessionRequest request) + *
    • getIamPolicy(GetIamPolicyRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • reportSessionCallable() + *
    • getIamPolicyCallable() *
    * * * - * ListSessions - *

    Lists the current test sessions.

    + * TestIamPermissions + *

    Returns permissions that a caller has on the specified resource. + * If the resource does not exist, this will return an empty set of + * permissions, not a `NOT_FOUND` error. + * + * Note: This operation is designed to be used for building permission-aware + * UIs and command-line tools, not for authorization checking. This operation + * may "fail open" without warning.

    * *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    *
      - *
    • listSessions(ListSessionsRequest request) + *
    • testIamPermissions(TestIamPermissionsRequest request) *
    *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    *
      - *
    • listSessionsPagedCallable() - *
    • listSessionsCallable() + *
    • testIamPermissionsCallable() *
    * * From 52ce9c2b990e1182ff3b007480d8e6a8a93a916a Mon Sep 17 00:00:00 2001 From: Alice Li Date: Fri, 10 Nov 2023 11:28:38 -0500 Subject: [PATCH 15/21] fix lint --- .../gapic/composer/comment/ServiceClientCommentComposer.java | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index d981983171..96ba7c15d4 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -26,8 +26,8 @@ import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; -import java.util.List; import java.util.LinkedHashMap; +import java.util.List; import java.util.Map; import java.util.Optional; import java.util.stream.Collectors; @@ -134,8 +134,7 @@ public static List createClassHeaderComments( return description != null ? description : ""; }, (existingValue, newValue) -> existingValue, - LinkedHashMap::new - ))); + LinkedHashMap::new))); // Build a list of MethodAndVariants to create the table List methodAndVariantsList = new ArrayList<>(); From 7cad882f22d774004f3816778cec6c9e4a25ed84 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Mon, 13 Nov 2023 16:36:11 -0500 Subject: [PATCH 16/21] refactor --- .../comment/ServiceClientCommentComposer.java | 88 ++++------ .../AbstractServiceClientClassComposer.java | 46 +++-- .../api/generator/gapic/model/Method.java | 8 - ...cServiceClientWithNestedClassImport.golden | 4 +- .../grpc/goldens/BookshopClient.golden | 6 +- .../goldens/DeprecatedServiceClient.golden | 8 +- .../composer/grpc/goldens/EchoClient.golden | 38 ++-- .../grpc/goldens/IdentityClient.golden | 26 +-- .../grpc/goldens/MessagingClient.golden | 66 +++---- .../grpcrest/goldens/EchoClient.golden | 48 ++--- .../grpcrest/goldens/WickedClient.golden | 8 +- .../v1/ConnectionServiceClient.java | 6 +- .../cloud/apigeeconnect/v1/TetherClient.java | 2 +- .../cloud/asset/v1/AssetServiceClient.java | 106 +++++------ .../data/v2/BaseBigtableDataClient.java | 30 ++-- .../compute/v1small/AddressesClient.java | 24 +-- .../v1small/RegionOperationsClient.java | 12 +- .../credentials/v1/IamCredentialsClient.java | 24 +-- .../com/google/iam/v1/IAMPolicyClient.java | 12 +- .../kms/v1/KeyManagementServiceClient.java | 152 ++++++++-------- .../library/v1/LibraryServiceClient.java | 64 +++---- .../google/cloud/logging/v2/ConfigClient.java | 132 +++++++------- .../cloud/logging/v2/LoggingClient.java | 30 ++-- .../cloud/logging/v2/MetricsClient.java | 30 ++-- .../cloud/pubsub/v1/SchemaServiceClient.java | 70 ++++---- .../pubsub/v1/SubscriptionAdminClient.java | 98 +++++------ .../cloud/pubsub/v1/TopicAdminClient.java | 62 +++---- .../cloud/redis/v1beta1/CloudRedisClient.java | 66 +++---- .../com/google/storage/v2/StorageClient.java | 166 +++++++++--------- 29 files changed, 700 insertions(+), 732 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index 96ba7c15d4..44d4f20a50 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -14,6 +14,8 @@ package com.google.api.generator.gapic.composer.comment; +import static java.util.stream.Collectors.toList; + import com.google.api.generator.engine.ast.CommentStatement; import com.google.api.generator.engine.ast.JavaDocComment; import com.google.api.generator.engine.ast.TypeNode; @@ -26,11 +28,9 @@ import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; -import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import java.util.Optional; -import java.util.stream.Collectors; public class ServiceClientCommentComposer { // Tokens. @@ -122,30 +122,11 @@ public static List createClassHeaderComments( String.format( SERVICE_DESCRIPTION_CLOSE_PATTERN, ClassNames.getServiceClientClassName(service))); - // Build the map of methods and descriptions - Map mapOfMethodsAndDescriptions = - Collections.unmodifiableMap( - service.methods().stream() - .collect( - Collectors.toMap( - Method::getName, - method -> { - String description = method.getDescription(); - return description != null ? description : ""; - }, - (existingValue, newValue) -> existingValue, - LinkedHashMap::new))); - - // Build a list of MethodAndVariants to create the table - List methodAndVariantsList = new ArrayList<>(); - for (Map.Entry method : mapOfMethodsAndDescriptions.entrySet()) { - MethodAndVariants methodAndVariants = - new MethodAndVariants( - method.getKey(), - method.getValue(), - methodVariantsForClientHeader.get(method.getKey())); - methodAndVariantsList.add(methodAndVariants); - } + // Build the map of methods and descriptions to create the table in Client Overviews + List methodAndVariantsList = + service.methods().stream() + .map((Method method) -> createMethodAndVariants(method, methodVariantsForClientHeader)) + .collect(toList()); classHeaderJavadocBuilder.addUnescapedComment(createTableOfMethods(methodAndVariantsList)); classHeaderJavadocBuilder.addParagraph(SERVICE_DESCRIPTION_SURFACE_CODA_STRING); @@ -229,15 +210,23 @@ public static List createRpcMethodHeaderComment( return comments; } + private static MethodAndVariants createMethodAndVariants( + Method method, Map> methodVariantsForClientHeader) { + String name = method.name(); + String description = method.description(); + if (description == null) description = ""; + return new MethodAndVariants(name, description, methodVariantsForClientHeader.get(name)); + } + private static String createTableOfMethods(List methodAndVariantsList) { String FLATTENED_METHODS = - "

    \"Flattened\" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    \n"; + "

    \"Flattened\" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

    \n"; String REQUEST_OBJECT_METHODS = - "

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    \n"; + "

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    \n"; String CALLABLE_METHODS = - "

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    \n"; + "

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    \n"; String ASYNC_METHODS = - "

    Methods that return long-running operations have \"Async\" method variants that return `OperationFuture` which is used to track polling of the service.

    \n"; + "

    Methods that return long-running operations have \"Async\" method variants that return `OperationFuture`, which is used to track polling of the service.

    \n"; StringBuilder tableBuilder = new StringBuilder(); tableBuilder @@ -302,39 +291,32 @@ private static String createTableOfMethods(List methodAndVari return tableBuilder.toString(); } - public static class MethodAndVariants { - String method; - String description; - boolean hasFlattenedVariants = false; - boolean hasRequestObjectVariants; - boolean hasCallableVariants; - boolean hasAsyncVariants; + private static class MethodAndVariants { + private final String method; + private final String description; + private final boolean hasFlattenedVariants; + private final boolean hasRequestObjectVariants; + private final boolean hasCallableVariants; + private final boolean hasAsyncVariants; - List flattenedVariants; - List requestObjectVariants; - List callableVariants; - List asyncVariants; + private final List flattenedVariants; + private final List requestObjectVariants; + private final List callableVariants; + private final List asyncVariants; - public MethodAndVariants(String method, String description, List methodVariants) { + private MethodAndVariants(String method, String description, List methodVariants) { this.method = method; this.description = description; requestObjectVariants = - methodVariants.stream().filter(s -> s.contains("request")).collect(Collectors.toList()); + methodVariants.stream().filter(s -> s.contains("request")).collect(toList()); hasRequestObjectVariants = methodVariants.removeAll(requestObjectVariants); - // hasRequestObjectVariants = methodVariants.stream().anyMatch(s -> s.contains("request")); callableVariants = - methodVariants.stream().filter(s -> s.contains("Callable")).collect(Collectors.toList()); + methodVariants.stream().filter(s -> s.contains("Callable")).collect(toList()); hasCallableVariants = methodVariants.removeAll(callableVariants); - // hasCallableVariants = methodVariants.stream().anyMatch(s -> s.contains("Callable")); - asyncVariants = - methodVariants.stream().filter(s -> s.contains("Async")).collect(Collectors.toList()); + asyncVariants = methodVariants.stream().filter(s -> s.contains("Async")).collect(toList()); hasAsyncVariants = methodVariants.removeAll(asyncVariants); - // hasAsyncVariants = methodVariants.stream().anyMatch(s -> s.contains("Async")); - // Whatever is remaining should just be flattened variants flattenedVariants = methodVariants; - if (!flattenedVariants.isEmpty()) { - hasFlattenedVariants = true; - } + hasFlattenedVariants = !flattenedVariants.isEmpty(); } } diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java index df1e848a5f..b97414fa66 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java @@ -578,6 +578,21 @@ private List createGetterMethods( .collect(Collectors.toList()); } + private static String getJavaMethod(MethodDefinition m) { + if (m.arguments().isEmpty()) { + return m.methodIdentifier().name() + "()"; + } + + Variable firstParam = m.arguments().get(0).variable(); + String firstParamType = + firstParam.type().reference() != null ? firstParam.type().reference().name() + " " : ""; + return m.methodIdentifier().name() + + "(" + + firstParamType + + firstParam.identifier().name() + + ")"; + } + private static List createServiceMethods( Service service, Map messageTypes, @@ -588,27 +603,6 @@ private static List createServiceMethods( List samples) { List javaMethods = new ArrayList<>(); Function javaMethodNameFn = m -> m.methodIdentifier().name(); - // This generates the list of method variants with arguments for the Client header statements - Function javaMethodFn = - m -> { - String s; - if (m.arguments().isEmpty()) { - s = m.methodIdentifier().name() + "()"; - } else { - String argument = - m.arguments().get(0).variable().type().reference() != null - ? m.arguments().get(0).variable().type().reference().name() + " " - : ""; - s = - m.methodIdentifier().name() - + "(" - + argument - + m.arguments().get(0).variable().identifier().name() - + ")"; - } - ; - return s; - }; for (Method method : service.methods()) { if (!grpcRpcToJavaMethodMetadata.containsKey(method.name())) { grpcRpcToJavaMethodMetadata.put(method.name(), new ArrayList<>()); @@ -638,7 +632,7 @@ private static List createServiceMethods( .get(method.name()) .addAll( generatedMethods.stream() - .map(m -> javaMethodFn.apply(m)) + .map(AbstractServiceClientClassComposer::getJavaMethod) .collect(Collectors.toList())); javaMethods.addAll(generatedMethods); @@ -654,7 +648,7 @@ private static List createServiceMethods( // Collect data for gapic_metadata.json and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); - methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(getJavaMethod(generatedMethod)); javaMethods.add(generatedMethod); } if (method.hasLro()) { @@ -664,7 +658,7 @@ private static List createServiceMethods( // Collect data for gapic_metadata.json and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); - methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(getJavaMethod(generatedMethod)); javaMethods.add(generatedMethod); } if (method.isPaged()) { @@ -674,7 +668,7 @@ private static List createServiceMethods( // Collect data for gapic_metadata.json and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); - methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(getJavaMethod(generatedMethod)); javaMethods.add(generatedMethod); } MethodDefinition generatedMethod = @@ -682,7 +676,7 @@ private static List createServiceMethods( // Collect data for the gapic_metadata.json file and client header. grpcRpcToJavaMethodMetadata.get(method.name()).add(javaMethodNameFn.apply(generatedMethod)); - methodVariantsForClientHeader.get(method.name()).add(javaMethodFn.apply(generatedMethod)); + methodVariantsForClientHeader.get(method.name()).add(getJavaMethod(generatedMethod)); javaMethods.add(generatedMethod); } return javaMethods; diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java index b1a57d4e33..4fd5c4f384 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/model/Method.java @@ -71,14 +71,6 @@ public boolean isPaged() { public abstract boolean operationPollingMethod(); - public String getName() { - return name(); - } - - public String getDescription() { - return description(); - } - public boolean hasLro() { return lro() != null; } diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden index ec78bea370..14024c64e6 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden @@ -40,11 +40,11 @@ import javax.annotation.Generated; * NestedMessageMethod *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      *
    • nestedMessageMethod(Outer.Middle request) *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • nestedMessageMethodCallable() *
    diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden index 630306eb18..3c5af7be49 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden @@ -40,16 +40,16 @@ import javax.annotation.Generated; * GetBook *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      *
    • getBook(GetBookRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

    *
      *
    • getBook(booksCount) *
    • getBook(String booksList) *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • getBookCallable() *
    diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden index 8fdb80509c..d08ce8a307 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden @@ -39,11 +39,11 @@ import javax.annotation.Generated; * FastFibonacci *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      *
    • fastFibonacci(FibonacciRequest request) *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • fastFibonacciCallable() *
    @@ -53,11 +53,11 @@ import javax.annotation.Generated; * SlowFibonacci *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      *
    • slowFibonacci(FibonacciRequest request) *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • slowFibonacciCallable() *
    diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden index 22e3c390bf..09389496f0 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden @@ -61,11 +61,11 @@ import javax.annotation.Generated; * Echo *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      *
    • echo(EchoRequest request) *
    - *

    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

    + *

    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

    *
      *
    • echo() *
    • echo(ResourceName parent) @@ -76,7 +76,7 @@ import javax.annotation.Generated; *
    • echo(String parent) *
    • echo(String content) *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • echoCallable() *
    @@ -86,7 +86,7 @@ import javax.annotation.Generated; * Expand *

    * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • expandCallable() *
    @@ -96,7 +96,7 @@ import javax.annotation.Generated; * Collect *

    * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • collectCallable() *
    @@ -106,7 +106,7 @@ import javax.annotation.Generated; * Chat *

    * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • chatCallable() *
    @@ -116,7 +116,7 @@ import javax.annotation.Generated; * ChatAgain *

    * - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • chatAgainCallable() *
    @@ -126,11 +126,11 @@ import javax.annotation.Generated; * PagedExpand *

    * - *

    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

    + *

    Request object method variants only take one parameter, a request object, which must be constructed before the call.

    *
      *
    • pagedExpand(PagedExpandRequest request) *
    - *

    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

    + *

    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

    *
      *
    • pagedExpandPagedCallable() *
    • pagedExpandCallable() @@ -141,15 +141,15 @@ import javax.annotation.Generated; * SimplePagedExpand *

      * - *

      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

      + *

      Request object method variants only take one parameter, a request object, which must be constructed before the call.

      *
        *
      • simplePagedExpand(PagedExpandRequest request) *
      - *

      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

      + *

      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

      *
        *
      • simplePagedExpand() *
      - *

      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

      + *

      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

      *
        *
      • simplePagedExpandPagedCallable() *
      • simplePagedExpandCallable() @@ -160,16 +160,16 @@ import javax.annotation.Generated; * Wait *

        * - *

        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

        + *

        Request object method variants only take one parameter, a request object, which must be constructed before the call.

        *
          *
        • waitAsync(WaitRequest request) *
        - *

        Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

        + *

        Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

        *
          *
        • waitAsync(Duration ttl) *
        • waitAsync(Timestamp endTime) *
        - *

        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

        + *

        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

        *
          *
        • waitOperationCallable() *
        • waitCallable() @@ -180,11 +180,11 @@ import javax.annotation.Generated; * Block *

          * - *

          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

          + *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            *
          • block(BlockRequest request) *
          - *

          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

          + *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            *
          • blockCallable() *
          @@ -194,11 +194,11 @@ import javax.annotation.Generated; * CollideName *

          * - *

          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

          + *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            *
          • collideName(EchoRequest request) *
          - *

          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

          + *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            *
          • collideNameCallable() *
          diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden index 8ae4f03a5c..76fecc2ed9 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden @@ -49,17 +49,17 @@ import javax.annotation.Generated; * CreateUser *

          * - *

          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

          + *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            *
          • createUser(CreateUserRequest request) *
          - *

          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

          + *

          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

          *
            *
          • createUser(String parent) *
          • createUser(String parent) *
          • createUser(String parent) *
          - *

          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

          + *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            *
          • createUserCallable() *
          @@ -69,16 +69,16 @@ import javax.annotation.Generated; * GetUser *

          * - *

          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

          + *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            *
          • getUser(GetUserRequest request) *
          - *

          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

          + *

          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

          *
            *
          • getUser(UserName name) *
          • getUser(String name) *
          - *

          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

          + *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            *
          • getUserCallable() *
          @@ -88,11 +88,11 @@ import javax.annotation.Generated; * UpdateUser *

          * - *

          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

          + *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            *
          • updateUser(UpdateUserRequest request) *
          - *

          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

          + *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            *
          • updateUserCallable() *
          @@ -102,16 +102,16 @@ import javax.annotation.Generated; * DeleteUser *

          * - *

          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

          + *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            *
          • deleteUser(DeleteUserRequest request) *
          - *

          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

          + *

          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

          *
            *
          • deleteUser(UserName name) *
          • deleteUser(String name) *
          - *

          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

          + *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            *
          • deleteUserCallable() *
          @@ -121,11 +121,11 @@ import javax.annotation.Generated; * ListUsers *

          * - *

          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

          + *

          Request object method variants only take one parameter, a request object, which must be constructed before the call.

          *
            *
          • listUsers(ListUsersRequest request) *
          - *

          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

          + *

          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

          *
            *
          • listUsersPagedCallable() *
          • listUsersCallable() diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden index 5ccf73e2ac..78a7125a7b 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden @@ -56,15 +56,15 @@ import javax.annotation.Generated; * CreateRoom *

            * - *

            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

            + *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            *
              *
            • createRoom(CreateRoomRequest request) *
            - *

            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

            + *

            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

            *
              *
            • createRoom(String displayName) *
            - *

            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

            + *

            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

            *
              *
            • createRoomCallable() *
            @@ -74,16 +74,16 @@ import javax.annotation.Generated; * GetRoom *

            * - *

            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

            + *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            *
              *
            • getRoom(GetRoomRequest request) *
            - *

            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

            + *

            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

            *
              *
            • getRoom(RoomName name) *
            • getRoom(String name) *
            - *

            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

            + *

            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

            *
              *
            • getRoomCallable() *
            @@ -93,11 +93,11 @@ import javax.annotation.Generated; * UpdateRoom *

            * - *

            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

            + *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            *
              *
            • updateRoom(UpdateRoomRequest request) *
            - *

            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

            + *

            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

            *
              *
            • updateRoomCallable() *
            @@ -107,16 +107,16 @@ import javax.annotation.Generated; * DeleteRoom *

            * - *

            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

            + *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            *
              *
            • deleteRoom(DeleteRoomRequest request) *
            - *

            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

            + *

            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

            *
              *
            • deleteRoom(RoomName name) *
            • deleteRoom(String name) *
            - *

            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

            + *

            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

            *
              *
            • deleteRoomCallable() *
            @@ -126,11 +126,11 @@ import javax.annotation.Generated; * ListRooms *

            * - *

            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

            + *

            Request object method variants only take one parameter, a request object, which must be constructed before the call.

            *
              *
            • listRooms(ListRoomsRequest request) *
            - *

            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

            + *

            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

            *
              *
            • listRoomsPagedCallable() *
            • listRoomsCallable() @@ -141,11 +141,11 @@ import javax.annotation.Generated; * CreateBlurb *

              * - *

              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

              + *

              Request object method variants only take one parameter, a request object, which must be constructed before the call.

              *
                *
              • createBlurb(CreateBlurbRequest request) *
              - *

              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

              + *

              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

              *
                *
              • createBlurb(ProfileName parent) *
              • createBlurb(ProfileName parent) @@ -154,7 +154,7 @@ import javax.annotation.Generated; *
              • createBlurb(String parent) *
              • createBlurb(String parent) *
              - *

              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

              + *

              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

              *
                *
              • createBlurbCallable() *
              @@ -164,16 +164,16 @@ import javax.annotation.Generated; * GetBlurb *

              * - *

              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

              + *

              Request object method variants only take one parameter, a request object, which must be constructed before the call.

              *
                *
              • getBlurb(GetBlurbRequest request) *
              - *

              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

              + *

              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

              *
                *
              • getBlurb(BlurbName name) *
              • getBlurb(String name) *
              - *

              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

              + *

              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

              *
                *
              • getBlurbCallable() *
              @@ -183,11 +183,11 @@ import javax.annotation.Generated; * UpdateBlurb *

              * - *

              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

              + *

              Request object method variants only take one parameter, a request object, which must be constructed before the call.

              *
                *
              • updateBlurb(UpdateBlurbRequest request) *
              - *

              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

              + *

              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

              *
                *
              • updateBlurbCallable() *
              @@ -197,16 +197,16 @@ import javax.annotation.Generated; * DeleteBlurb *

              * - *

              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

              + *

              Request object method variants only take one parameter, a request object, which must be constructed before the call.

              *
                *
              • deleteBlurb(DeleteBlurbRequest request) *
              - *

              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

              + *

              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

              *
                *
              • deleteBlurb(BlurbName name) *
              • deleteBlurb(String name) *
              - *

              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

              + *

              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

              *
                *
              • deleteBlurbCallable() *
              @@ -216,17 +216,17 @@ import javax.annotation.Generated; * ListBlurbs *

              * - *

              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

              + *

              Request object method variants only take one parameter, a request object, which must be constructed before the call.

              *
                *
              • listBlurbs(ListBlurbsRequest request) *
              - *

              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

              + *

              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

              *
                *
              • listBlurbs(ProfileName parent) *
              • listBlurbs(RoomName parent) *
              • listBlurbs(String parent) *
              - *

              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

              + *

              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

              *
                *
              • listBlurbsPagedCallable() *
              • listBlurbsCallable() @@ -237,15 +237,15 @@ import javax.annotation.Generated; * SearchBlurbs *

                * - *

                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                + *

                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                *
                  *
                • searchBlurbsAsync(SearchBlurbsRequest request) *
                - *

                Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                + *

                Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                *
                  *
                • searchBlurbsAsync(String query) *
                - *

                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                + *

                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                *
                  *
                • searchBlurbsOperationCallable() *
                • searchBlurbsCallable() @@ -256,7 +256,7 @@ import javax.annotation.Generated; * StreamBlurbs *

                  * - *

                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                  + *

                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                  *
                    *
                  • streamBlurbsCallable() *
                  @@ -266,7 +266,7 @@ import javax.annotation.Generated; * SendBlurbs *

                  * - *

                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                  + *

                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                  *
                    *
                  • sendBlurbsCallable() *
                  @@ -276,7 +276,7 @@ import javax.annotation.Generated; * Connect *

                  * - *

                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                  + *

                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                  *
                    *
                  • connectCallable() *
                  diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index ea3ff6a283..aa92fd196c 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -56,11 +56,11 @@ import javax.annotation.Generated; * Echo *

                  * - *

                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                  + *

                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                  *
                    *
                  • echo(EchoRequest request) *
                  - *

                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                  + *

                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                  *
                    *
                  • echo() *
                  • echo(ResourceName parent) @@ -71,7 +71,7 @@ import javax.annotation.Generated; *
                  • echo(String parent) *
                  • echo(String content) *
                  - *

                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                  + *

                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                  *
                    *
                  • echoCallable() *
                  @@ -81,7 +81,7 @@ import javax.annotation.Generated; * Expand *

                  * - *

                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                  + *

                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                  *
                    *
                  • expandCallable() *
                  @@ -91,11 +91,11 @@ import javax.annotation.Generated; * PagedExpand *

                  * - *

                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                  + *

                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                  *
                    *
                  • pagedExpand(PagedExpandRequest request) *
                  - *

                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                  + *

                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                  *
                    *
                  • pagedExpandPagedCallable() *
                  • pagedExpandCallable() @@ -106,15 +106,15 @@ import javax.annotation.Generated; * SimplePagedExpand *

                    * - *

                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                    + *

                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                    *
                      *
                    • simplePagedExpand(PagedExpandRequest request) *
                    - *

                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                    + *

                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                    *
                      *
                    • simplePagedExpand() *
                    - *

                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                    + *

                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                    *
                      *
                    • simplePagedExpandPagedCallable() *
                    • simplePagedExpandCallable() @@ -125,16 +125,16 @@ import javax.annotation.Generated; * Wait *

                      * - *

                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                      + *

                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                      *
                        *
                      • waitAsync(WaitRequest request) *
                      - *

                      Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                      + *

                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                      *
                        *
                      • waitAsync(Duration ttl) *
                      • waitAsync(Timestamp endTime) *
                      - *

                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                      + *

                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                      *
                        *
                      • waitOperationCallable() *
                      • waitCallable() @@ -145,11 +145,11 @@ import javax.annotation.Generated; * Block *

                        * - *

                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                        + *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          *
                        • block(BlockRequest request) *
                        - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • blockCallable() *
                        @@ -159,11 +159,11 @@ import javax.annotation.Generated; * CollideName *

                        * - *

                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                        + *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          *
                        • collideName(EchoRequest request) *
                        - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • collideNameCallable() *
                        @@ -173,11 +173,11 @@ import javax.annotation.Generated; * NestedBinding *

                        * - *

                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                        + *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          *
                        • nestedBinding(EchoRequest request) *
                        - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • nestedBindingCallable() *
                        @@ -187,7 +187,7 @@ import javax.annotation.Generated; * Chat *

                        * - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • chatCallable() *
                        @@ -197,11 +197,11 @@ import javax.annotation.Generated; * NoBinding *

                        * - *

                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                        + *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          *
                        • noBinding(EchoRequest request) *
                        - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • noBindingCallable() *
                        @@ -211,15 +211,15 @@ import javax.annotation.Generated; * UpdateCase *

                        * - *

                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                        + *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          *
                        • updateCase(UpdateCaseRequest request) *
                        - *

                        "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                        + *

                        "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                        *
                          *
                        • updateCase(Case case_) *
                        - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • updateCaseCallable() *
                        diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden index a7d9c00ec8..738a146749 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden @@ -41,11 +41,11 @@ import javax.annotation.Generated; * CraftEvilPlan *

                        * - *

                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                        + *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          *
                        • craftEvilPlan(EvilRequest request) *
                        - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • craftEvilPlanCallable() *
                        @@ -55,7 +55,7 @@ import javax.annotation.Generated; * BrainstormEvilPlans *

                        * - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • brainstormEvilPlansCallable() *
                        @@ -65,7 +65,7 @@ import javax.annotation.Generated; * PersuadeEvilPlan *

                        * - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • persuadeEvilPlanCallable() *
                        diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java index d41dc4399f..871501ffce 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java @@ -67,16 +67,16 @@ *

                        Lists connections that are currently active for the given Apigee Connect * endpoint.

                        * - *

                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                        + *

                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                        *
                          *
                        • listConnections(ListConnectionsRequest request) *
                        - *

                        "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                        + *

                        "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                        *
                          *
                        • listConnections(EndpointName parent) *
                        • listConnections(String parent) *
                        - *

                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                        + *

                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                        *
                          *
                        • listConnectionsPagedCallable() *
                        • listConnectionsCallable() diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java index fbb28f87c3..9729017411 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java @@ -76,7 +76,7 @@ * the RPC client. * The listener streams http requests and the dialer streams http responses.

                          * - *

                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                          + *

                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                          *
                            *
                          • egressCallable() *
                          diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index 7812a8f8a9..0e6b4f34a1 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -87,11 +87,11 @@ * For regular-size resource parent, the export operation usually finishes * within 5 minutes.

                          * - *

                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                          + *

                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                          *
                            *
                          • exportAssetsAsync(ExportAssetsRequest request) *
                          - *

                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                          + *

                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                          *
                            *
                          • exportAssetsOperationCallable() *
                          • exportAssetsCallable() @@ -103,16 +103,16 @@ *

                            Lists assets with time and resource types and returns paged results in * response.

                            * - *

                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                            + *

                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                            *
                              *
                            • listAssets(ListAssetsRequest request) *
                            - *

                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                            + *

                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                            *
                              *
                            • listAssets(ResourceName parent) *
                            • listAssets(String parent) *
                            - *

                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                            + *

                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                            *
                              *
                            • listAssetsPagedCallable() *
                            • listAssetsCallable() @@ -129,11 +129,11 @@ * If a specified asset does not exist, this API returns an INVALID_ARGUMENT * error.

                              * - *

                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                              + *

                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                              *
                                *
                              • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) *
                              - *

                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                              + *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                *
                              • batchGetAssetsHistoryCallable() *
                              @@ -144,15 +144,15 @@ *

                              Creates a feed in a parent project/folder/organization to listen to its * asset updates.

                              * - *

                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                              + *

                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                              *
                                *
                              • createFeed(CreateFeedRequest request) *
                              - *

                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                              + *

                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                              *
                                *
                              • createFeed(String parent) *
                              - *

                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                              + *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                *
                              • createFeedCallable() *
                              @@ -162,16 +162,16 @@ * GetFeed *

                              Gets details about an asset feed.

                              * - *

                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                              + *

                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                              *
                                *
                              • getFeed(GetFeedRequest request) *
                              - *

                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                              + *

                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                              *
                                *
                              • getFeed(FeedName name) *
                              • getFeed(String name) *
                              - *

                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                              + *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                *
                              • getFeedCallable() *
                              @@ -181,15 +181,15 @@ * ListFeeds *

                              Lists all asset feeds in a parent project/folder/organization.

                              * - *

                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                              + *

                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                              *
                                *
                              • listFeeds(ListFeedsRequest request) *
                              - *

                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                              + *

                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                              *
                                *
                              • listFeeds(String parent) *
                              - *

                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                              + *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                *
                              • listFeedsCallable() *
                              @@ -199,15 +199,15 @@ * UpdateFeed *

                              Updates an asset feed configuration.

                              * - *

                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                              + *

                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                              *
                                *
                              • updateFeed(UpdateFeedRequest request) *
                              - *

                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                              + *

                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                              *
                                *
                              • updateFeed(Feed feed) *
                              - *

                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                              + *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                *
                              • updateFeedCallable() *
                              @@ -217,16 +217,16 @@ * DeleteFeed *

                              Deletes an asset feed.

                              * - *

                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                              + *

                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                              *
                                *
                              • deleteFeed(DeleteFeedRequest request) *
                              - *

                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                              + *

                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                              *
                                *
                              • deleteFeed(FeedName name) *
                              • deleteFeed(String name) *
                              - *

                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                              + *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                *
                              • deleteFeedCallable() *
                              @@ -239,15 +239,15 @@ * `cloudasset.assets.searchAllResources` permission on the desired scope, * otherwise the request will be rejected.

                              * - *

                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                              + *

                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                              *
                                *
                              • searchAllResources(SearchAllResourcesRequest request) *
                              - *

                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                              + *

                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                              *
                                *
                              • searchAllResources(String scope) *
                              - *

                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                              + *

                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                              *
                                *
                              • searchAllResourcesPagedCallable() *
                              • searchAllResourcesCallable() @@ -261,15 +261,15 @@ * `cloudasset.assets.searchAllIamPolicies` permission on the desired scope, * otherwise the request will be rejected.

                                * - *

                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                + *

                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                *
                                  *
                                • searchAllIamPolicies(SearchAllIamPoliciesRequest request) *
                                - *

                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                + *

                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                *
                                  *
                                • searchAllIamPolicies(String scope) *
                                - *

                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                + *

                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                *
                                  *
                                • searchAllIamPoliciesPagedCallable() *
                                • searchAllIamPoliciesCallable() @@ -281,11 +281,11 @@ *

                                  Analyzes IAM policies to answer which identities have what accesses on * which resources.

                                  * - *

                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                  + *

                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                  *
                                    *
                                  • analyzeIamPolicy(AnalyzeIamPolicyRequest request) *
                                  - *

                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                  + *

                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                  *
                                    *
                                  • analyzeIamPolicyCallable() *
                                  @@ -303,11 +303,11 @@ * backoff retry to poll the operation result. The metadata contains the * metadata for the long-running operation.

                                  * - *

                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                  + *

                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                  *
                                    *
                                  • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) *
                                  - *

                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                  + *

                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                  *
                                    *
                                  • analyzeIamPolicyLongrunningOperationCallable() *
                                  • analyzeIamPolicyLongrunningCallable() @@ -322,11 +322,11 @@ * The policies and configuration are subject to change before the actual * resource migration takes place.

                                    * - *

                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                    + *

                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                    *
                                      *
                                    • analyzeMove(AnalyzeMoveRequest request) *
                                    - *

                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                    + *

                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                    *
                                      *
                                    • analyzeMoveCallable() *
                                    @@ -349,11 +349,11 @@ * https://cloud.google.com/bigquery/docs/best-practices-performance-output, * queries return larger results will result in errors.

                                    * - *

                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                    + *

                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                    *
                                      *
                                    • queryAssets(QueryAssetsRequest request) *
                                    - *

                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                    + *

                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                    *
                                      *
                                    • queryAssetsCallable() *
                                    @@ -363,18 +363,18 @@ * CreateSavedQuery *

                                    Creates a saved query in a parent project/folder/organization.

                                    * - *

                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                    + *

                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                    *
                                      *
                                    • createSavedQuery(CreateSavedQueryRequest request) *
                                    - *

                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                    + *

                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                    *
                                      *
                                    • createSavedQuery(FolderName parent) *
                                    • createSavedQuery(OrganizationName parent) *
                                    • createSavedQuery(ProjectName parent) *
                                    • createSavedQuery(String parent) *
                                    - *

                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                    + *

                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                    *
                                      *
                                    • createSavedQueryCallable() *
                                    @@ -384,16 +384,16 @@ * GetSavedQuery *

                                    Gets details about a saved query.

                                    * - *

                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                    + *

                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                    *
                                      *
                                    • getSavedQuery(GetSavedQueryRequest request) *
                                    - *

                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                    + *

                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                    *
                                      *
                                    • getSavedQuery(SavedQueryName name) *
                                    • getSavedQuery(String name) *
                                    - *

                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                    + *

                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                    *
                                      *
                                    • getSavedQueryCallable() *
                                    @@ -403,18 +403,18 @@ * ListSavedQueries *

                                    Lists all saved queries in a parent project/folder/organization.

                                    * - *

                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                    + *

                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                    *
                                      *
                                    • listSavedQueries(ListSavedQueriesRequest request) *
                                    - *

                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                    + *

                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                    *
                                      *
                                    • listSavedQueries(FolderName parent) *
                                    • listSavedQueries(OrganizationName parent) *
                                    • listSavedQueries(ProjectName parent) *
                                    • listSavedQueries(String parent) *
                                    - *

                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                    + *

                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                    *
                                      *
                                    • listSavedQueriesPagedCallable() *
                                    • listSavedQueriesCallable() @@ -425,15 +425,15 @@ * UpdateSavedQuery *

                                      Updates a saved query.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • updateSavedQuery(UpdateSavedQueryRequest request) *
                                      - *

                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                      + *

                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                      *
                                        *
                                      • updateSavedQuery(SavedQuery savedQuery) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • updateSavedQueryCallable() *
                                      @@ -443,16 +443,16 @@ * DeleteSavedQuery *

                                      Deletes a saved query.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • deleteSavedQuery(DeleteSavedQueryRequest request) *
                                      - *

                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                      + *

                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                      *
                                        *
                                      • deleteSavedQuery(SavedQueryName name) *
                                      • deleteSavedQuery(String name) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • deleteSavedQueryCallable() *
                                      @@ -462,11 +462,11 @@ * BatchGetEffectiveIamPolicies *

                                      Gets effective IAM policies for a batch of resources.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • batchGetEffectiveIamPoliciesCallable() *
                                      diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index 34d1f7b676..20e26f3af5 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -84,7 +84,7 @@ * atomicity of each row will still be preserved. See the * ReadRowsResponse documentation for details.

                                      * - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • readRowsCallable() *
                                      @@ -97,7 +97,7 @@ * which can be used to break up the data for distributed tasks like * mapreduces.

                                      * - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • sampleRowKeysCallable() *
                                      @@ -108,18 +108,18 @@ *

                                      Mutates a row atomically. Cells already present in the row are left * unchanged unless explicitly changed by `mutation`.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • mutateRow(MutateRowRequest request) *
                                      - *

                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                      + *

                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                      *
                                        *
                                      • mutateRow(TableName tableName) *
                                      • mutateRow(String tableName) *
                                      • mutateRow(TableName tableName) *
                                      • mutateRow(String tableName) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • mutateRowCallable() *
                                      @@ -131,7 +131,7 @@ * atomically as in MutateRow, but the entire batch is not executed * atomically.

                                      * - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • mutateRowsCallable() *
                                      @@ -141,18 +141,18 @@ * CheckAndMutateRow *

                                      Mutates a row atomically based on the output of a predicate Reader filter.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • checkAndMutateRow(CheckAndMutateRowRequest request) *
                                      - *

                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                      + *

                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                      *
                                        *
                                      • checkAndMutateRow(TableName tableName) *
                                      • checkAndMutateRow(String tableName) *
                                      • checkAndMutateRow(TableName tableName) *
                                      • checkAndMutateRow(String tableName) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • checkAndMutateRowCallable() *
                                      @@ -163,18 +163,18 @@ *

                                      Warm up associated instance metadata for this connection. * This call is not required but may be useful for connection keep-alive.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • pingAndWarm(PingAndWarmRequest request) *
                                      - *

                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                      + *

                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                      *
                                        *
                                      • pingAndWarm(InstanceName name) *
                                      • pingAndWarm(String name) *
                                      • pingAndWarm(InstanceName name) *
                                      • pingAndWarm(String name) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • pingAndWarmCallable() *
                                      @@ -188,18 +188,18 @@ * timestamp is the greater of the existing timestamp or the current server * time. The method returns the new contents of all modified cells.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • readModifyWriteRow(ReadModifyWriteRowRequest request) *
                                      - *

                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                      + *

                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                      *
                                        *
                                      • readModifyWriteRow(TableName tableName) *
                                      • readModifyWriteRow(String tableName) *
                                      • readModifyWriteRow(TableName tableName) *
                                      • readModifyWriteRow(String tableName) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • readModifyWriteRowCallable() *
                                      diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index 70a5281f75..d267add264 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -72,15 +72,15 @@ * AggregatedList *

                                      Retrieves an aggregated list of addresses.

                                      * - *

                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                      + *

                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                      *
                                        *
                                      • aggregatedList(AggregatedListAddressesRequest request) *
                                      - *

                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                      + *

                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                      *
                                        *
                                      • aggregatedList(String project) *
                                      - *

                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                      + *

                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                      *
                                        *
                                      • aggregatedListPagedCallable() *
                                      • aggregatedListCallable() @@ -91,15 +91,15 @@ * Delete *

                                        Deletes the specified address resource.

                                        * - *

                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                        + *

                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                        *
                                          *
                                        • deleteAsync(DeleteAddressRequest request) *
                                        - *

                                        Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                        + *

                                        Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                        *
                                          *
                                        • deleteAsync(String project) *
                                        - *

                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                        + *

                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                        *
                                          *
                                        • deleteOperationCallable() *
                                        • deleteCallable() @@ -110,15 +110,15 @@ * Insert *

                                          Creates an address resource in the specified project by using the data included in the request.

                                          * - *

                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                          + *

                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                          *
                                            *
                                          • insertAsync(InsertAddressRequest request) *
                                          - *

                                          Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                          + *

                                          Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                          *
                                            *
                                          • insertAsync(String project) *
                                          - *

                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                          + *

                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                          *
                                            *
                                          • insertOperationCallable() *
                                          • insertCallable() @@ -129,15 +129,15 @@ * List *

                                            Retrieves a list of addresses contained within the specified region.

                                            * - *

                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                            + *

                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                            *
                                              *
                                            • list(ListAddressesRequest request) *
                                            - *

                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                            + *

                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                            *
                                              *
                                            • list(String project) *
                                            - *

                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                            + *

                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                            *
                                              *
                                            • listPagedCallable() *
                                            • listCallable() diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java index ff43ff31a1..f5d01dc4b1 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java @@ -58,15 +58,15 @@ * Get *

                                              Retrieves the specified region-specific Operations resource.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • get(GetRegionOperationRequest request) *
                                              - *

                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                              + *

                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                              *
                                                *
                                              • get(String project) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • getCallable() *
                                              @@ -80,15 +80,15 @@ * - In uncommon cases, when the server is overloaded, the request might return before the default deadline is reached, or might return after zero seconds. * - If the default deadline is reached, there is no guarantee that the operation is actually done when the method returns. Be prepared to retry if the operation is not `DONE`.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • wait(WaitRegionOperationRequest request) *
                                              - *

                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                              + *

                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                              *
                                                *
                                              • wait(String project) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • waitCallable() *
                                              diff --git a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java index 2c573b309a..76cc3f705d 100644 --- a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java +++ b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java @@ -69,16 +69,16 @@ * GenerateAccessToken *

                                              Generates an OAuth 2.0 access token for a service account.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • generateAccessToken(GenerateAccessTokenRequest request) *
                                              - *

                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                              + *

                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                              *
                                                *
                                              • generateAccessToken(ServiceAccountName name) *
                                              • generateAccessToken(String name) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • generateAccessTokenCallable() *
                                              @@ -88,16 +88,16 @@ * GenerateIdToken *

                                              Generates an OpenID Connect ID token for a service account.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • generateIdToken(GenerateIdTokenRequest request) *
                                              - *

                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                              + *

                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                              *
                                                *
                                              • generateIdToken(ServiceAccountName name) *
                                              • generateIdToken(String name) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • generateIdTokenCallable() *
                                              @@ -107,16 +107,16 @@ * SignBlob *

                                              Signs a blob using a service account's system-managed private key.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • signBlob(SignBlobRequest request) *
                                              - *

                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                              + *

                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                              *
                                                *
                                              • signBlob(ServiceAccountName name) *
                                              • signBlob(String name) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • signBlobCallable() *
                                              @@ -126,16 +126,16 @@ * SignJwt *

                                              Signs a JWT using a service account's system-managed private key.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • signJwt(SignJwtRequest request) *
                                              - *

                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                              + *

                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                              *
                                                *
                                              • signJwt(ServiceAccountName name) *
                                              • signJwt(String name) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • signJwtCallable() *
                                              diff --git a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java index 83f807c087..da072cde0e 100644 --- a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java +++ b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java @@ -84,11 +84,11 @@ * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • setIamPolicy(SetIamPolicyRequest request) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • setIamPolicyCallable() *
                                              @@ -100,11 +100,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • getIamPolicy(GetIamPolicyRequest request) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • getIamPolicyCallable() *
                                              @@ -120,11 +120,11 @@ * UIs and command-line tools, not for authorization checking. This operation * may "fail open" without warning.

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • testIamPermissions(TestIamPermissionsRequest request) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • testIamPermissionsCallable() *
                                              diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index 1d432936b4..400c8966d9 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -89,16 +89,16 @@ * ListKeyRings *

                                              Lists [KeyRings][google.cloud.kms.v1.KeyRing].

                                              * - *

                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                              + *

                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                              *
                                                *
                                              • listKeyRings(ListKeyRingsRequest request) *
                                              - *

                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                              + *

                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                              *
                                                *
                                              • listKeyRings(LocationName parent) *
                                              • listKeyRings(String parent) *
                                              - *

                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                              + *

                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                              *
                                                *
                                              • listKeyRingsPagedCallable() *
                                              • listKeyRingsCallable() @@ -109,16 +109,16 @@ * ListCryptoKeys *

                                                Lists [CryptoKeys][google.cloud.kms.v1.CryptoKey].

                                                * - *

                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                + *

                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                *
                                                  *
                                                • listCryptoKeys(ListCryptoKeysRequest request) *
                                                - *

                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                + *

                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                *
                                                  *
                                                • listCryptoKeys(KeyRingName parent) *
                                                • listCryptoKeys(String parent) *
                                                - *

                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                + *

                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                *
                                                  *
                                                • listCryptoKeysPagedCallable() *
                                                • listCryptoKeysCallable() @@ -129,16 +129,16 @@ * ListCryptoKeyVersions *

                                                  Lists [CryptoKeyVersions][google.cloud.kms.v1.CryptoKeyVersion].

                                                  * - *

                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                  + *

                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                  *
                                                    *
                                                  • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) *
                                                  - *

                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                  + *

                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                  *
                                                    *
                                                  • listCryptoKeyVersions(CryptoKeyName parent) *
                                                  • listCryptoKeyVersions(String parent) *
                                                  - *

                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                  + *

                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                  *
                                                    *
                                                  • listCryptoKeyVersionsPagedCallable() *
                                                  • listCryptoKeyVersionsCallable() @@ -149,16 +149,16 @@ * ListImportJobs *

                                                    Lists [ImportJobs][google.cloud.kms.v1.ImportJob].

                                                    * - *

                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                    + *

                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                    *
                                                      *
                                                    • listImportJobs(ListImportJobsRequest request) *
                                                    - *

                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                    + *

                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                    *
                                                      *
                                                    • listImportJobs(KeyRingName parent) *
                                                    • listImportJobs(String parent) *
                                                    - *

                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                    + *

                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                    *
                                                      *
                                                    • listImportJobsPagedCallable() *
                                                    • listImportJobsCallable() @@ -169,16 +169,16 @@ * GetKeyRing *

                                                      Returns metadata for a given [KeyRing][google.cloud.kms.v1.KeyRing].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • getKeyRing(GetKeyRingRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • getKeyRing(KeyRingName name) *
                                                      • getKeyRing(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • getKeyRingCallable() *
                                                      @@ -190,16 +190,16 @@ * well as its [primary][google.cloud.kms.v1.CryptoKey.primary] * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • getCryptoKey(GetCryptoKeyRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • getCryptoKey(CryptoKeyName name) *
                                                      • getCryptoKey(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • getCryptoKeyCallable() *
                                                      @@ -210,16 +210,16 @@ *

                                                      Returns metadata for a given * [CryptoKeyVersion][google.cloud.kms.v1.CryptoKeyVersion].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • getCryptoKeyVersion(CryptoKeyVersionName name) *
                                                      • getCryptoKeyVersion(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • getCryptoKeyVersionCallable() *
                                                      @@ -234,16 +234,16 @@ * or * [ASYMMETRIC_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ASYMMETRIC_DECRYPT].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • getPublicKey(GetPublicKeyRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • getPublicKey(CryptoKeyVersionName name) *
                                                      • getPublicKey(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • getPublicKeyCallable() *
                                                      @@ -253,16 +253,16 @@ * GetImportJob *

                                                      Returns metadata for a given [ImportJob][google.cloud.kms.v1.ImportJob].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • getImportJob(GetImportJobRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • getImportJob(ImportJobName name) *
                                                      • getImportJob(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • getImportJobCallable() *
                                                      @@ -273,16 +273,16 @@ *

                                                      Create a new [KeyRing][google.cloud.kms.v1.KeyRing] in a given Project and * Location.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • createKeyRing(CreateKeyRingRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • createKeyRing(LocationName parent) *
                                                      • createKeyRing(String parent) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • createKeyRingCallable() *
                                                      @@ -297,16 +297,16 @@ * [CryptoKey.version_template.algorithm][google.cloud.kms.v1.CryptoKeyVersionTemplate.algorithm] * are required.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • createCryptoKey(CreateCryptoKeyRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • createCryptoKey(KeyRingName parent) *
                                                      • createCryptoKey(String parent) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • createCryptoKeyCallable() *
                                                      @@ -321,16 +321,16 @@ * [state][google.cloud.kms.v1.CryptoKeyVersion.state] will be set to * [ENABLED][google.cloud.kms.v1.CryptoKeyVersion.CryptoKeyVersionState.ENABLED].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • createCryptoKeyVersion(CreateCryptoKeyVersionRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • createCryptoKeyVersion(CryptoKeyName parent) *
                                                      • createCryptoKeyVersion(String parent) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • createCryptoKeyVersionCallable() *
                                                      @@ -345,11 +345,11 @@ * The version ID will be assigned the next sequential id within the * [CryptoKey][google.cloud.kms.v1.CryptoKey].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • importCryptoKeyVersionCallable() *
                                                      @@ -363,16 +363,16 @@ * [ImportJob.import_method][google.cloud.kms.v1.ImportJob.import_method] is * required.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • createImportJob(CreateImportJobRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • createImportJob(KeyRingName parent) *
                                                      • createImportJob(String parent) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • createImportJobCallable() *
                                                      @@ -382,15 +382,15 @@ * UpdateCryptoKey *

                                                      Update a [CryptoKey][google.cloud.kms.v1.CryptoKey].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • updateCryptoKey(UpdateCryptoKeyRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • updateCryptoKey(CryptoKey cryptoKey) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • updateCryptoKeyCallable() *
                                                      @@ -411,15 +411,15 @@ * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] * to move between other states.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • updateCryptoKeyVersion(UpdateCryptoKeyVersionRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • updateCryptoKeyVersionCallable() *
                                                      @@ -432,16 +432,16 @@ * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • encrypt(EncryptRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • encrypt(ResourceName name) *
                                                      • encrypt(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • encryptCallable() *
                                                      @@ -454,16 +454,16 @@ * [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] must be * [ENCRYPT_DECRYPT][google.cloud.kms.v1.CryptoKey.CryptoKeyPurpose.ENCRYPT_DECRYPT].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • decrypt(DecryptRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • decrypt(CryptoKeyName name) *
                                                      • decrypt(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • decryptCallable() *
                                                      @@ -477,16 +477,16 @@ * key retrieved from * [GetPublicKey][google.cloud.kms.v1.KeyManagementService.GetPublicKey].

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • asymmetricSign(AsymmetricSignRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • asymmetricSign(CryptoKeyVersionName name) *
                                                      • asymmetricSign(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • asymmetricSignCallable() *
                                                      @@ -500,16 +500,16 @@ * with [CryptoKey.purpose][google.cloud.kms.v1.CryptoKey.purpose] * ASYMMETRIC_DECRYPT.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • asymmetricDecrypt(AsymmetricDecryptRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • asymmetricDecrypt(CryptoKeyVersionName name) *
                                                      • asymmetricDecrypt(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • asymmetricDecryptCallable() *
                                                      @@ -523,16 +523,16 @@ * * Returns an error if called on an asymmetric key.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • updateCryptoKeyPrimaryVersion(CryptoKeyName name) *
                                                      • updateCryptoKeyPrimaryVersion(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • updateCryptoKeyPrimaryVersionCallable() *
                                                      @@ -559,16 +559,16 @@ * [RestoreCryptoKeyVersion][google.cloud.kms.v1.KeyManagementService.RestoreCryptoKeyVersion] * may be called to reverse the process.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • destroyCryptoKeyVersion(CryptoKeyVersionName name) *
                                                      • destroyCryptoKeyVersion(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • destroyCryptoKeyVersionCallable() *
                                                      @@ -586,16 +586,16 @@ * and [destroy_time][google.cloud.kms.v1.CryptoKeyVersion.destroy_time] will * be cleared.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • restoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest request) *
                                                      - *

                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                      + *

                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                      *
                                                        *
                                                      • restoreCryptoKeyVersion(CryptoKeyVersionName name) *
                                                      • restoreCryptoKeyVersion(String name) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • restoreCryptoKeyVersionCallable() *
                                                      @@ -607,11 +607,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • getIamPolicyCallable() *
                                                      @@ -621,11 +621,11 @@ * ListLocations *

                                                      Lists information about the supported locations for this service.

                                                      * - *

                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                      + *

                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                      *
                                                        *
                                                      • listLocations(ListLocationsRequest request) *
                                                      - *

                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                      + *

                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                      *
                                                        *
                                                      • listLocationsPagedCallable() *
                                                      • listLocationsCallable() @@ -636,11 +636,11 @@ * GetLocation *

                                                        Gets information about a location.

                                                        * - *

                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                        + *

                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                        *
                                                          *
                                                        • getLocation(GetLocationRequest request) *
                                                        - *

                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                        + *

                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                        *
                                                          *
                                                        • getLocationCallable() *
                                                        @@ -650,11 +650,11 @@ * TestIamPermissions *

                                                        This is a different comment for TestIamPermissions in the yaml file that should clobber the documentation in iam_policy.proto.

                                                        * - *

                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                        + *

                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                        *
                                                          *
                                                        • testIamPermissions(TestIamPermissionsRequest request) *
                                                        - *

                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                        + *

                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                        *
                                                          *
                                                        • testIamPermissionsCallable() *
                                                        diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index 79849596bc..9f98ed17c0 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -89,15 +89,15 @@ * CreateShelf *

                                                        Creates a shelf, and returns the new Shelf.

                                                        * - *

                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                        + *

                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                        *
                                                          *
                                                        • createShelf(CreateShelfRequest request) *
                                                        - *

                                                        "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                        + *

                                                        "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                        *
                                                          *
                                                        • createShelf(Shelf shelf) *
                                                        - *

                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                        + *

                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                        *
                                                          *
                                                        • createShelfCallable() *
                                                        @@ -107,16 +107,16 @@ * GetShelf *

                                                        Gets a shelf. Returns NOT_FOUND if the shelf does not exist.

                                                        * - *

                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                        + *

                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                        *
                                                          *
                                                        • getShelf(GetShelfRequest request) *
                                                        - *

                                                        "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                        + *

                                                        "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                        *
                                                          *
                                                        • getShelf(ShelfName name) *
                                                        • getShelf(String name) *
                                                        - *

                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                        + *

                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                        *
                                                          *
                                                        • getShelfCallable() *
                                                        @@ -127,11 +127,11 @@ *

                                                        Lists shelves. The order is unspecified but deterministic. Newly created * shelves will not necessarily be added to the end of this list.

                                                        * - *

                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                        + *

                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                        *
                                                          *
                                                        • listShelves(ListShelvesRequest request) *
                                                        - *

                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                        + *

                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                        *
                                                          *
                                                        • listShelvesPagedCallable() *
                                                        • listShelvesCallable() @@ -142,16 +142,16 @@ * DeleteShelf *

                                                          Deletes a shelf. Returns NOT_FOUND if the shelf does not exist.

                                                          * - *

                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                          + *

                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                          *
                                                            *
                                                          • deleteShelf(DeleteShelfRequest request) *
                                                          - *

                                                          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                          + *

                                                          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                          *
                                                            *
                                                          • deleteShelf(ShelfName name) *
                                                          • deleteShelf(String name) *
                                                          - *

                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                          + *

                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                          *
                                                            *
                                                          • deleteShelfCallable() *
                                                          @@ -167,18 +167,18 @@ * Returns NOT_FOUND if either shelf does not exist. * This call is a no-op if the specified shelves are the same.

                                                          * - *

                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                          + *

                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                          *
                                                            *
                                                          • mergeShelves(MergeShelvesRequest request) *
                                                          - *

                                                          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                          + *

                                                          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                          *
                                                            *
                                                          • mergeShelves(ShelfName name) *
                                                          • mergeShelves(ShelfName name) *
                                                          • mergeShelves(String name) *
                                                          • mergeShelves(String name) *
                                                          - *

                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                          + *

                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                          *
                                                            *
                                                          • mergeShelvesCallable() *
                                                          @@ -188,16 +188,16 @@ * CreateBook *

                                                          Creates a book, and returns the new Book.

                                                          * - *

                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                          + *

                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                          *
                                                            *
                                                          • createBook(CreateBookRequest request) *
                                                          - *

                                                          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                          + *

                                                          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                          *
                                                            *
                                                          • createBook(ShelfName parent) *
                                                          • createBook(String parent) *
                                                          - *

                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                          + *

                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                          *
                                                            *
                                                          • createBookCallable() *
                                                          @@ -207,16 +207,16 @@ * GetBook *

                                                          Gets a book. Returns NOT_FOUND if the book does not exist.

                                                          * - *

                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                          + *

                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                          *
                                                            *
                                                          • getBook(GetBookRequest request) *
                                                          - *

                                                          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                          + *

                                                          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                          *
                                                            *
                                                          • getBook(BookName name) *
                                                          • getBook(String name) *
                                                          - *

                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                          + *

                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                          *
                                                            *
                                                          • getBookCallable() *
                                                          @@ -228,16 +228,16 @@ * created books will not necessarily be added to the end of this list. * Returns NOT_FOUND if the shelf does not exist.

                                                          * - *

                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                          + *

                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                          *
                                                            *
                                                          • listBooks(ListBooksRequest request) *
                                                          - *

                                                          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                          + *

                                                          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                          *
                                                            *
                                                          • listBooks(ShelfName parent) *
                                                          • listBooks(String parent) *
                                                          - *

                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                          + *

                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                          *
                                                            *
                                                          • listBooksPagedCallable() *
                                                          • listBooksCallable() @@ -248,16 +248,16 @@ * DeleteBook *

                                                            Deletes a book. Returns NOT_FOUND if the book does not exist.

                                                            * - *

                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                            + *

                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                            *
                                                              *
                                                            • deleteBook(DeleteBookRequest request) *
                                                            - *

                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                            + *

                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                            *
                                                              *
                                                            • deleteBook(BookName name) *
                                                            • deleteBook(String name) *
                                                            - *

                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                            + *

                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                            *
                                                              *
                                                            • deleteBookCallable() *
                                                            @@ -268,15 +268,15 @@ *

                                                            Updates a book. Returns INVALID_ARGUMENT if the name of the book * is non-empty and does not equal the existing name.

                                                            * - *

                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                            + *

                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                            *
                                                              *
                                                            • updateBook(UpdateBookRequest request) *
                                                            - *

                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                            + *

                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                            *
                                                              *
                                                            • updateBook(Book book) *
                                                            - *

                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                            + *

                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                            *
                                                              *
                                                            • updateBookCallable() *
                                                            @@ -287,18 +287,18 @@ *

                                                            Moves a book to another shelf, and returns the new book. The book * id of the new book may not be the same as the original book.

                                                            * - *

                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                            + *

                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                            *
                                                              *
                                                            • moveBook(MoveBookRequest request) *
                                                            - *

                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                            + *

                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                            *
                                                              *
                                                            • moveBook(BookName name) *
                                                            • moveBook(BookName name) *
                                                            • moveBook(String name) *
                                                            • moveBook(String name) *
                                                            - *

                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                            + *

                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                            *
                                                              *
                                                            • moveBookCallable() *
                                                            diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index 6bb3d76417..93534ed7c3 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -123,11 +123,11 @@ * ListBuckets *

                                                            Lists log buckets.

                                                            * - *

                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                            + *

                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                            *
                                                              *
                                                            • listBuckets(ListBucketsRequest request) *
                                                            - *

                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                            + *

                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                            *
                                                              *
                                                            • listBuckets(BillingAccountLocationName parent) *
                                                            • listBuckets(FolderLocationName parent) @@ -135,7 +135,7 @@ *
                                                            • listBuckets(OrganizationLocationName parent) *
                                                            • listBuckets(String parent) *
                                                            - *

                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                            + *

                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                            *
                                                              *
                                                            • listBucketsPagedCallable() *
                                                            • listBucketsCallable() @@ -146,11 +146,11 @@ * GetBucket *

                                                              Gets a log bucket.

                                                              * - *

                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                              + *

                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                              *
                                                                *
                                                              • getBucket(GetBucketRequest request) *
                                                              - *

                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                              + *

                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                              *
                                                                *
                                                              • getBucketCallable() *
                                                              @@ -161,11 +161,11 @@ *

                                                              Creates a log bucket that can be used to store log entries. After a bucket * has been created, the bucket's location cannot be changed.

                                                              * - *

                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                              + *

                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                              *
                                                                *
                                                              • createBucket(CreateBucketRequest request) *
                                                              - *

                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                              + *

                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                              *
                                                                *
                                                              • createBucketCallable() *
                                                              @@ -184,11 +184,11 @@ * * After a bucket has been created, the bucket's location cannot be changed.

                                                              * - *

                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                              + *

                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                              *
                                                                *
                                                              • updateBucket(UpdateBucketRequest request) *
                                                              - *

                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                              + *

                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                              *
                                                                *
                                                              • updateBucketCallable() *
                                                              @@ -202,11 +202,11 @@ * After 7 days, the bucket will be purged and all log entries in the bucket * will be permanently deleted.

                                                              * - *

                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                              + *

                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                              *
                                                                *
                                                              • deleteBucket(DeleteBucketRequest request) *
                                                              - *

                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                              + *

                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                              *
                                                                *
                                                              • deleteBucketCallable() *
                                                              @@ -217,11 +217,11 @@ *

                                                              Undeletes a log bucket. A bucket that has been deleted can be undeleted * within the grace period of 7 days.

                                                              * - *

                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                              + *

                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                              *
                                                                *
                                                              • undeleteBucket(UndeleteBucketRequest request) *
                                                              - *

                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                              + *

                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                              *
                                                                *
                                                              • undeleteBucketCallable() *
                                                              @@ -231,15 +231,15 @@ * ListViews *

                                                              Lists views on a log bucket.

                                                              * - *

                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                              + *

                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                              *
                                                                *
                                                              • listViews(ListViewsRequest request) *
                                                              - *

                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                              + *

                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                              *
                                                                *
                                                              • listViews(String parent) *
                                                              - *

                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                              + *

                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                              *
                                                                *
                                                              • listViewsPagedCallable() *
                                                              • listViewsCallable() @@ -250,11 +250,11 @@ * GetView *

                                                                Gets a view on a log bucket..

                                                                * - *

                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                + *

                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                *
                                                                  *
                                                                • getView(GetViewRequest request) *
                                                                - *

                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                + *

                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                *
                                                                  *
                                                                • getViewCallable() *
                                                                @@ -265,11 +265,11 @@ *

                                                                Creates a view over log entries in a log bucket. A bucket may contain a * maximum of 30 views.

                                                                * - *

                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                + *

                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                *
                                                                  *
                                                                • createView(CreateViewRequest request) *
                                                                - *

                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                + *

                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                *
                                                                  *
                                                                • createViewCallable() *
                                                                @@ -283,11 +283,11 @@ * a state where it can update the view. If this occurs, please try again in a * few minutes.

                                                                * - *

                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                + *

                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                *
                                                                  *
                                                                • updateView(UpdateViewRequest request) *
                                                                - *

                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                + *

                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                *
                                                                  *
                                                                • updateViewCallable() *
                                                                @@ -300,11 +300,11 @@ * a state where it can delete the view. If this occurs, please try again in a * few minutes.

                                                                * - *

                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                + *

                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                *
                                                                  *
                                                                • deleteView(DeleteViewRequest request) *
                                                                - *

                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                + *

                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                *
                                                                  *
                                                                • deleteViewCallable() *
                                                                @@ -314,11 +314,11 @@ * ListSinks *

                                                                Lists sinks.

                                                                * - *

                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                + *

                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                *
                                                                  *
                                                                • listSinks(ListSinksRequest request) *
                                                                - *

                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                + *

                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                *
                                                                  *
                                                                • listSinks(BillingAccountName parent) *
                                                                • listSinks(FolderName parent) @@ -326,7 +326,7 @@ *
                                                                • listSinks(ProjectName parent) *
                                                                • listSinks(String parent) *
                                                                - *

                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                + *

                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                *
                                                                  *
                                                                • listSinksPagedCallable() *
                                                                • listSinksCallable() @@ -337,16 +337,16 @@ * GetSink *

                                                                  Gets a sink.

                                                                  * - *

                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                  + *

                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                  *
                                                                    *
                                                                  • getSink(GetSinkRequest request) *
                                                                  - *

                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                  + *

                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                  *
                                                                    *
                                                                  • getSink(LogSinkName sinkName) *
                                                                  • getSink(String sinkName) *
                                                                  - *

                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                  + *

                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                  *
                                                                    *
                                                                  • getSinkCallable() *
                                                                  @@ -359,11 +359,11 @@ * `writer_identity` is not permitted to write to the destination. A sink can * export log entries only from the resource owning the sink.

                                                                  * - *

                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                  + *

                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                  *
                                                                    *
                                                                  • createSink(CreateSinkRequest request) *
                                                                  - *

                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                  + *

                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                  *
                                                                    *
                                                                  • createSink(BillingAccountName parent) *
                                                                  • createSink(FolderName parent) @@ -371,7 +371,7 @@ *
                                                                  • createSink(ProjectName parent) *
                                                                  • createSink(String parent) *
                                                                  - *

                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                  + *

                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                  *
                                                                    *
                                                                  • createSinkCallable() *
                                                                  @@ -385,18 +385,18 @@ * The updated sink might also have a new `writer_identity`; see the * `unique_writer_identity` field.

                                                                  * - *

                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                  + *

                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                  *
                                                                    *
                                                                  • updateSink(UpdateSinkRequest request) *
                                                                  - *

                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                  + *

                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                  *
                                                                    *
                                                                  • updateSink(LogSinkName sinkName) *
                                                                  • updateSink(String sinkName) *
                                                                  • updateSink(LogSinkName sinkName) *
                                                                  • updateSink(String sinkName) *
                                                                  - *

                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                  + *

                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                  *
                                                                    *
                                                                  • updateSinkCallable() *
                                                                  @@ -407,16 +407,16 @@ *

                                                                  Deletes a sink. If the sink has a unique `writer_identity`, then that * service account is also deleted.

                                                                  * - *

                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                  + *

                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                  *
                                                                    *
                                                                  • deleteSink(DeleteSinkRequest request) *
                                                                  - *

                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                  + *

                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                  *
                                                                    *
                                                                  • deleteSink(LogSinkName sinkName) *
                                                                  • deleteSink(String sinkName) *
                                                                  - *

                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                  + *

                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                  *
                                                                    *
                                                                  • deleteSinkCallable() *
                                                                  @@ -426,11 +426,11 @@ * ListExclusions *

                                                                  Lists all the exclusions on the _Default sink in a parent resource.

                                                                  * - *

                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                  + *

                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                  *
                                                                    *
                                                                  • listExclusions(ListExclusionsRequest request) *
                                                                  - *

                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                  + *

                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                  *
                                                                    *
                                                                  • listExclusions(BillingAccountName parent) *
                                                                  • listExclusions(FolderName parent) @@ -438,7 +438,7 @@ *
                                                                  • listExclusions(ProjectName parent) *
                                                                  • listExclusions(String parent) *
                                                                  - *

                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                  + *

                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                  *
                                                                    *
                                                                  • listExclusionsPagedCallable() *
                                                                  • listExclusionsCallable() @@ -449,16 +449,16 @@ * GetExclusion *

                                                                    Gets the description of an exclusion in the _Default sink.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • getExclusion(GetExclusionRequest request) *
                                                                    - *

                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                    + *

                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                    *
                                                                      *
                                                                    • getExclusion(LogExclusionName name) *
                                                                    • getExclusion(String name) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • getExclusionCallable() *
                                                                    @@ -470,11 +470,11 @@ * resource. Only log entries belonging to that resource can be excluded. You * can have up to 10 exclusions in a resource.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • createExclusion(CreateExclusionRequest request) *
                                                                    - *

                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                    + *

                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                    *
                                                                      *
                                                                    • createExclusion(BillingAccountName parent) *
                                                                    • createExclusion(FolderName parent) @@ -482,7 +482,7 @@ *
                                                                    • createExclusion(ProjectName parent) *
                                                                    • createExclusion(String parent) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • createExclusionCallable() *
                                                                    @@ -493,16 +493,16 @@ *

                                                                    Changes one or more properties of an existing exclusion in the _Default * sink.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • updateExclusion(UpdateExclusionRequest request) *
                                                                    - *

                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                    + *

                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                    *
                                                                      *
                                                                    • updateExclusion(LogExclusionName name) *
                                                                    • updateExclusion(String name) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • updateExclusionCallable() *
                                                                    @@ -512,16 +512,16 @@ * DeleteExclusion *

                                                                    Deletes an exclusion in the _Default sink.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • deleteExclusion(DeleteExclusionRequest request) *
                                                                    - *

                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                    + *

                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                    *
                                                                      *
                                                                    • deleteExclusion(LogExclusionName name) *
                                                                    • deleteExclusion(String name) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • deleteExclusionCallable() *
                                                                    @@ -540,11 +540,11 @@ * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) * for more information.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • getCmekSettings(GetCmekSettingsRequest request) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • getCmekSettingsCallable() *
                                                                    @@ -568,11 +568,11 @@ * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) * for more information.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • updateCmekSettings(UpdateCmekSettingsRequest request) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • updateCmekSettingsCallable() *
                                                                    @@ -591,16 +591,16 @@ * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) * for more information.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • getSettings(GetSettingsRequest request) *
                                                                    - *

                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                    + *

                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                    *
                                                                      *
                                                                    • getSettings(SettingsName name) *
                                                                    • getSettings(String name) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • getSettingsCallable() *
                                                                    @@ -625,15 +625,15 @@ * Router](https://cloud.google.com/logging/docs/routing/managed-encryption) * for more information.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • updateSettings(UpdateSettingsRequest request) *
                                                                    - *

                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                    + *

                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                    *
                                                                      *
                                                                    • updateSettings(Settings settings) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • updateSettingsCallable() *
                                                                    @@ -643,11 +643,11 @@ * CopyLogEntries *

                                                                    Copies a set of log entries from a log bucket to a Cloud Storage bucket.

                                                                    * - *

                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                    + *

                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                    *
                                                                      *
                                                                    • copyLogEntriesAsync(CopyLogEntriesRequest request) *
                                                                    - *

                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                    + *

                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                    *
                                                                      *
                                                                    • copyLogEntriesOperationCallable() *
                                                                    • copyLogEntriesCallable() diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index 6eb0cf1d49..aae564a54d 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -88,16 +88,16 @@ * the delete operation might not be deleted. Entries received after the * delete operation with a timestamp before the operation will be deleted.

                                                                      * - *

                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                      + *

                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                      *
                                                                        *
                                                                      • deleteLog(DeleteLogRequest request) *
                                                                      - *

                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                      + *

                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                      *
                                                                        *
                                                                      • deleteLog(LogName logName) *
                                                                      • deleteLog(String logName) *
                                                                      - *

                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                      + *

                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                      *
                                                                        *
                                                                      • deleteLogCallable() *
                                                                      @@ -113,16 +113,16 @@ * different resources (projects, organizations, billing accounts or * folders)

                                                                      * - *

                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                      + *

                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                      *
                                                                        *
                                                                      • writeLogEntries(WriteLogEntriesRequest request) *
                                                                      - *

                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                      + *

                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                      *
                                                                        *
                                                                      • writeLogEntries(LogName logName) *
                                                                      • writeLogEntries(String logName) *
                                                                      - *

                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                      + *

                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                      *
                                                                        *
                                                                      • writeLogEntriesCallable() *
                                                                      @@ -135,15 +135,15 @@ * entries, see [Exporting * Logs](https://cloud.google.com/logging/docs/export).

                                                                      * - *

                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                      + *

                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                      *
                                                                        *
                                                                      • listLogEntries(ListLogEntriesRequest request) *
                                                                      - *

                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                      + *

                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                      *
                                                                        *
                                                                      • listLogEntries(List resourceNames) *
                                                                      - *

                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                      + *

                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                      *
                                                                        *
                                                                      • listLogEntriesPagedCallable() *
                                                                      • listLogEntriesCallable() @@ -154,11 +154,11 @@ * ListMonitoredResourceDescriptors *

                                                                        Lists the descriptors for monitored resource types used by Logging.

                                                                        * - *

                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                        + *

                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                        *
                                                                          *
                                                                        • listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request) *
                                                                        - *

                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                        + *

                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                        *
                                                                          *
                                                                        • listMonitoredResourceDescriptorsPagedCallable() *
                                                                        • listMonitoredResourceDescriptorsCallable() @@ -170,11 +170,11 @@ *

                                                                          Lists the logs in projects, organizations, folders, or billing accounts. * Only logs that have entries are listed.

                                                                          * - *

                                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                          + *

                                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                          *
                                                                            *
                                                                          • listLogs(ListLogsRequest request) *
                                                                          - *

                                                                          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                          + *

                                                                          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                          *
                                                                            *
                                                                          • listLogs(BillingAccountName parent) *
                                                                          • listLogs(FolderName parent) @@ -182,7 +182,7 @@ *
                                                                          • listLogs(ProjectName parent) *
                                                                          • listLogs(String parent) *
                                                                          - *

                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                          + *

                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                          *
                                                                            *
                                                                          • listLogsPagedCallable() *
                                                                          • listLogsCallable() @@ -194,7 +194,7 @@ *

                                                                            Streaming read of log entries as they are ingested. Until the stream is * terminated, it will continue reading logs.

                                                                            * - *

                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                            + *

                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                            *
                                                                              *
                                                                            • tailLogEntriesCallable() *
                                                                            diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index f49f3818e9..fa1a977f41 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -73,16 +73,16 @@ * ListLogMetrics *

                                                                            Lists logs-based metrics.

                                                                            * - *

                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                            + *

                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                            *
                                                                              *
                                                                            • listLogMetrics(ListLogMetricsRequest request) *
                                                                            - *

                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                            + *

                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                            *
                                                                              *
                                                                            • listLogMetrics(ProjectName parent) *
                                                                            • listLogMetrics(String parent) *
                                                                            - *

                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                            + *

                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                            *
                                                                              *
                                                                            • listLogMetricsPagedCallable() *
                                                                            • listLogMetricsCallable() @@ -93,16 +93,16 @@ * GetLogMetric *

                                                                              Gets a logs-based metric.

                                                                              * - *

                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                              + *

                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                              *
                                                                                *
                                                                              • getLogMetric(GetLogMetricRequest request) *
                                                                              - *

                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                              + *

                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                              *
                                                                                *
                                                                              • getLogMetric(LogMetricName metricName) *
                                                                              • getLogMetric(String metricName) *
                                                                              - *

                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                              + *

                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                              *
                                                                                *
                                                                              • getLogMetricCallable() *
                                                                              @@ -112,16 +112,16 @@ * CreateLogMetric *

                                                                              Creates a logs-based metric.

                                                                              * - *

                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                              + *

                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                              *
                                                                                *
                                                                              • createLogMetric(CreateLogMetricRequest request) *
                                                                              - *

                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                              + *

                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                              *
                                                                                *
                                                                              • createLogMetric(ProjectName parent) *
                                                                              • createLogMetric(String parent) *
                                                                              - *

                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                              + *

                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                              *
                                                                                *
                                                                              • createLogMetricCallable() *
                                                                              @@ -131,16 +131,16 @@ * UpdateLogMetric *

                                                                              Creates or updates a logs-based metric.

                                                                              * - *

                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                              + *

                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                              *
                                                                                *
                                                                              • updateLogMetric(UpdateLogMetricRequest request) *
                                                                              - *

                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                              + *

                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                              *
                                                                                *
                                                                              • updateLogMetric(LogMetricName metricName) *
                                                                              • updateLogMetric(String metricName) *
                                                                              - *

                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                              + *

                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                              *
                                                                                *
                                                                              • updateLogMetricCallable() *
                                                                              @@ -150,16 +150,16 @@ * DeleteLogMetric *

                                                                              Deletes a logs-based metric.

                                                                              * - *

                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                              + *

                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                              *
                                                                                *
                                                                              • deleteLogMetric(DeleteLogMetricRequest request) *
                                                                              - *

                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                              + *

                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                              *
                                                                                *
                                                                              • deleteLogMetric(LogMetricName metricName) *
                                                                              • deleteLogMetric(String metricName) *
                                                                              - *

                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                              + *

                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                              *
                                                                                *
                                                                              • deleteLogMetricCallable() *
                                                                              diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index 057bb8b6fa..5124c42d4c 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -88,16 +88,16 @@ * CreateSchema *

                                                                              Creates a schema.

                                                                              * - *

                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                              + *

                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                              *
                                                                                *
                                                                              • createSchema(CreateSchemaRequest request) *
                                                                              - *

                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                              + *

                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                              *
                                                                                *
                                                                              • createSchema(ProjectName parent) *
                                                                              • createSchema(String parent) *
                                                                              - *

                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                              + *

                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                              *
                                                                                *
                                                                              • createSchemaCallable() *
                                                                              @@ -107,16 +107,16 @@ * GetSchema *

                                                                              Gets a schema.

                                                                              * - *

                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                              + *

                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                              *
                                                                                *
                                                                              • getSchema(GetSchemaRequest request) *
                                                                              - *

                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                              + *

                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                              *
                                                                                *
                                                                              • getSchema(SchemaName name) *
                                                                              • getSchema(String name) *
                                                                              - *

                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                              + *

                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                              *
                                                                                *
                                                                              • getSchemaCallable() *
                                                                              @@ -126,16 +126,16 @@ * ListSchemas *

                                                                              Lists schemas in a project.

                                                                              * - *

                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                              + *

                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                              *
                                                                                *
                                                                              • listSchemas(ListSchemasRequest request) *
                                                                              - *

                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                              + *

                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                              *
                                                                                *
                                                                              • listSchemas(ProjectName parent) *
                                                                              • listSchemas(String parent) *
                                                                              - *

                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                              + *

                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                              *
                                                                                *
                                                                              • listSchemasPagedCallable() *
                                                                              • listSchemasCallable() @@ -146,16 +146,16 @@ * ListSchemaRevisions *

                                                                                Lists all schema revisions for the named schema.

                                                                                * - *

                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                + *

                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                *
                                                                                  *
                                                                                • listSchemaRevisions(ListSchemaRevisionsRequest request) *
                                                                                - *

                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                + *

                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                *
                                                                                  *
                                                                                • listSchemaRevisions(SchemaName name) *
                                                                                • listSchemaRevisions(String name) *
                                                                                - *

                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                + *

                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                *
                                                                                  *
                                                                                • listSchemaRevisionsPagedCallable() *
                                                                                • listSchemaRevisionsCallable() @@ -166,16 +166,16 @@ * CommitSchema *

                                                                                  Commits a new schema revision to an existing schema.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • commitSchema(CommitSchemaRequest request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • commitSchema(SchemaName name) *
                                                                                  • commitSchema(String name) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • commitSchemaCallable() *
                                                                                  @@ -185,16 +185,16 @@ * RollbackSchema *

                                                                                  Creates a new schema revision that is a copy of the provided revision_id.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • rollbackSchema(RollbackSchemaRequest request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • rollbackSchema(SchemaName name) *
                                                                                  • rollbackSchema(String name) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • rollbackSchemaCallable() *
                                                                                  @@ -204,16 +204,16 @@ * DeleteSchemaRevision *

                                                                                  Deletes a specific schema revision.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • deleteSchemaRevision(DeleteSchemaRevisionRequest request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • deleteSchemaRevision(SchemaName name) *
                                                                                  • deleteSchemaRevision(String name) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • deleteSchemaRevisionCallable() *
                                                                                  @@ -223,16 +223,16 @@ * DeleteSchema *

                                                                                  Deletes a schema.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • deleteSchema(DeleteSchemaRequest request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • deleteSchema(SchemaName name) *
                                                                                  • deleteSchema(String name) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • deleteSchemaCallable() *
                                                                                  @@ -242,16 +242,16 @@ * ValidateSchema *

                                                                                  Validates a schema.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • validateSchema(ValidateSchemaRequest request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • validateSchema(ProjectName parent) *
                                                                                  • validateSchema(String parent) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • validateSchemaCallable() *
                                                                                  @@ -261,11 +261,11 @@ * ValidateMessage *

                                                                                  Validates a message against a schema.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • validateMessage(ValidateMessageRequest request) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • validateMessageCallable() *
                                                                                  @@ -279,11 +279,11 @@ * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` * errors.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • setIamPolicy(SetIamPolicyRequest request) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • setIamPolicyCallable() *
                                                                                  @@ -294,11 +294,11 @@ *

                                                                                  Gets the access control policy for a resource. Returns an empty policy * if the resource exists and does not have a policy set.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • getIamPolicy(GetIamPolicyRequest request) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • getIamPolicyCallable() *
                                                                                  @@ -314,11 +314,11 @@ * permission-aware UIs and command-line tools, not for authorization * checking. This operation may "fail open" without warning.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • testIamPermissionsCallable() *
                                                                                  diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index e62ffd1963..2f53b48dc3 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -114,18 +114,18 @@ * name is populated in the returned Subscription object. Note that for REST * API requests, you must specify a name in the request.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • createSubscription(Subscription request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • createSubscription(SubscriptionName name) *
                                                                                  • createSubscription(SubscriptionName name) *
                                                                                  • createSubscription(String name) *
                                                                                  • createSubscription(String name) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • createSubscriptionCallable() *
                                                                                  @@ -135,16 +135,16 @@ * GetSubscription *

                                                                                  Gets the configuration details of a subscription.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • getSubscription(GetSubscriptionRequest request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • getSubscription(SubscriptionName subscription) *
                                                                                  • getSubscription(String subscription) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • getSubscriptionCallable() *
                                                                                  @@ -155,11 +155,11 @@ *

                                                                                  Updates an existing subscription. Note that certain properties of a * subscription, such as its topic, are not modifiable.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • updateSubscription(UpdateSubscriptionRequest request) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • updateSubscriptionCallable() *
                                                                                  @@ -169,16 +169,16 @@ * ListSubscriptions *

                                                                                  Lists matching subscriptions.

                                                                                  * - *

                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                  + *

                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                  *
                                                                                    *
                                                                                  • listSubscriptions(ListSubscriptionsRequest request) *
                                                                                  - *

                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                  + *

                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                  *
                                                                                    *
                                                                                  • listSubscriptions(ProjectName project) *
                                                                                  • listSubscriptions(String project) *
                                                                                  - *

                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  + *

                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                  *
                                                                                    *
                                                                                  • listSubscriptionsPagedCallable() *
                                                                                  • listSubscriptionsCallable() @@ -193,16 +193,16 @@ * the same name, but the new one has no association with the old * subscription or its topic unless the same topic is specified.

                                                                                    * - *

                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                    + *

                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                    *
                                                                                      *
                                                                                    • deleteSubscription(DeleteSubscriptionRequest request) *
                                                                                    - *

                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                    + *

                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                    *
                                                                                      *
                                                                                    • deleteSubscription(SubscriptionName subscription) *
                                                                                    • deleteSubscription(String subscription) *
                                                                                    - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • deleteSubscriptionCallable() *
                                                                                    @@ -216,16 +216,16 @@ * processing was interrupted. Note that this does not modify the * subscription-level `ackDeadlineSeconds` used for subsequent messages.

                                                                                    * - *

                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                    + *

                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                    *
                                                                                      *
                                                                                    • modifyAckDeadline(ModifyAckDeadlineRequest request) *
                                                                                    - *

                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                    + *

                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                    *
                                                                                      *
                                                                                    • modifyAckDeadline(SubscriptionName subscription) *
                                                                                    • modifyAckDeadline(String subscription) *
                                                                                    - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • modifyAckDeadlineCallable() *
                                                                                    @@ -241,16 +241,16 @@ * but such a message may be redelivered later. Acknowledging a message more * than once will not result in an error.

                                                                                    * - *

                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                    + *

                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                    *
                                                                                      *
                                                                                    • acknowledge(AcknowledgeRequest request) *
                                                                                    - *

                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                    + *

                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                    *
                                                                                      *
                                                                                    • acknowledge(SubscriptionName subscription) *
                                                                                    • acknowledge(String subscription) *
                                                                                    - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • acknowledgeCallable() *
                                                                                    @@ -262,18 +262,18 @@ * there are too many concurrent pull requests pending for the given * subscription.

                                                                                    * - *

                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                    + *

                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                    *
                                                                                      *
                                                                                    • pull(PullRequest request) *
                                                                                    - *

                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                    + *

                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                    *
                                                                                      *
                                                                                    • pull(SubscriptionName subscription) *
                                                                                    • pull(String subscription) *
                                                                                    • pull(SubscriptionName subscription) *
                                                                                    • pull(String subscription) *
                                                                                    - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • pullCallable() *
                                                                                    @@ -289,7 +289,7 @@ * re-establish the stream. Flow control can be achieved by configuring the * underlying RPC channel.

                                                                                    * - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • streamingPullCallable() *
                                                                                    @@ -304,16 +304,16 @@ * attributes of a push subscription. Messages will accumulate for delivery * continuously through the call regardless of changes to the `PushConfig`.

                                                                                    * - *

                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                    + *

                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                    *
                                                                                      *
                                                                                    • modifyPushConfig(ModifyPushConfigRequest request) *
                                                                                    - *

                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                    + *

                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                    *
                                                                                      *
                                                                                    • modifyPushConfig(SubscriptionName subscription) *
                                                                                    • modifyPushConfig(String subscription) *
                                                                                    - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • modifyPushConfigCallable() *
                                                                                    @@ -327,16 +327,16 @@ * is, you can set the acknowledgment state of messages in an existing * subscription to the state captured by a snapshot.

                                                                                    * - *

                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                    + *

                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                    *
                                                                                      *
                                                                                    • getSnapshot(GetSnapshotRequest request) *
                                                                                    - *

                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                    + *

                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                    *
                                                                                      *
                                                                                    • getSnapshot(SnapshotName snapshot) *
                                                                                    • getSnapshot(String snapshot) *
                                                                                    - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • getSnapshotCallable() *
                                                                                    @@ -350,16 +350,16 @@ * the acknowledgment state of messages in an existing subscription to the * state captured by a snapshot.

                                                                                    * - *

                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                    + *

                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                    *
                                                                                      *
                                                                                    • listSnapshots(ListSnapshotsRequest request) *
                                                                                    - *

                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                    + *

                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                    *
                                                                                      *
                                                                                    • listSnapshots(ProjectName project) *
                                                                                    • listSnapshots(String project) *
                                                                                    - *

                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    + *

                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                    *
                                                                                      *
                                                                                    • listSnapshotsPagedCallable() *
                                                                                    • listSnapshotsCallable() @@ -385,18 +385,18 @@ * generated name is populated in the returned Snapshot object. Note that for * REST API requests, you must specify a name in the request.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • createSnapshot(CreateSnapshotRequest request) *
                                                                                      - *

                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                      + *

                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                      *
                                                                                        *
                                                                                      • createSnapshot(SnapshotName name) *
                                                                                      • createSnapshot(SnapshotName name) *
                                                                                      • createSnapshot(String name) *
                                                                                      • createSnapshot(String name) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • createSnapshotCallable() *
                                                                                      @@ -411,11 +411,11 @@ * acknowledgment state of messages in an existing subscription to the state * captured by a snapshot.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • updateSnapshot(UpdateSnapshotRequest request) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • updateSnapshotCallable() *
                                                                                      @@ -433,16 +433,16 @@ * created with the same name, but the new one has no association with the old * snapshot or its subscription, unless the same subscription is specified.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • deleteSnapshot(DeleteSnapshotRequest request) *
                                                                                      - *

                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                      + *

                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                      *
                                                                                        *
                                                                                      • deleteSnapshot(SnapshotName snapshot) *
                                                                                      • deleteSnapshot(String snapshot) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • deleteSnapshotCallable() *
                                                                                      @@ -458,11 +458,11 @@ * state captured by a snapshot. Note that both the subscription and the * snapshot must be on the same topic.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • seek(SeekRequest request) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • seekCallable() *
                                                                                      @@ -476,11 +476,11 @@ * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` * errors.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • setIamPolicyCallable() *
                                                                                      @@ -491,11 +491,11 @@ *

                                                                                      Gets the access control policy for a resource. Returns an empty policy * if the resource exists and does not have a policy set.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • getIamPolicyCallable() *
                                                                                      @@ -511,11 +511,11 @@ * permission-aware UIs and command-line tools, not for authorization * checking. This operation may "fail open" without warning.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • testIamPermissionsCallable() *
                                                                                      diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index 8e9277d22f..eefab82ea7 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -88,16 +88,16 @@ *

                                                                                      Creates the given topic with the given name. See the [resource name rules] * (https://cloud.google.com/pubsub/docs/admin#resource_names).

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • createTopic(Topic request) *
                                                                                      - *

                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                      + *

                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                      *
                                                                                        *
                                                                                      • createTopic(TopicName name) *
                                                                                      • createTopic(String name) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • createTopicCallable() *
                                                                                      @@ -108,11 +108,11 @@ *

                                                                                      Updates an existing topic. Note that certain properties of a * topic are not modifiable.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • updateTopic(UpdateTopicRequest request) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • updateTopicCallable() *
                                                                                      @@ -123,16 +123,16 @@ *

                                                                                      Adds one or more messages to the topic. Returns `NOT_FOUND` if the topic * does not exist.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • publish(PublishRequest request) *
                                                                                      - *

                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                      + *

                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                      *
                                                                                        *
                                                                                      • publish(TopicName topic) *
                                                                                      • publish(String topic) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • publishCallable() *
                                                                                      @@ -142,16 +142,16 @@ * GetTopic *

                                                                                      Gets the configuration of a topic.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • getTopic(GetTopicRequest request) *
                                                                                      - *

                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                      + *

                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                      *
                                                                                        *
                                                                                      • getTopic(TopicName topic) *
                                                                                      • getTopic(String topic) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • getTopicCallable() *
                                                                                      @@ -161,16 +161,16 @@ * ListTopics *

                                                                                      Lists matching topics.

                                                                                      * - *

                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                      + *

                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                      *
                                                                                        *
                                                                                      • listTopics(ListTopicsRequest request) *
                                                                                      - *

                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                      + *

                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                      *
                                                                                        *
                                                                                      • listTopics(ProjectName project) *
                                                                                      • listTopics(String project) *
                                                                                      - *

                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      + *

                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                      *
                                                                                        *
                                                                                      • listTopicsPagedCallable() *
                                                                                      • listTopicsCallable() @@ -181,16 +181,16 @@ * ListTopicSubscriptions *

                                                                                        Lists the names of the attached subscriptions on this topic.

                                                                                        * - *

                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                        + *

                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                        *
                                                                                          *
                                                                                        • listTopicSubscriptions(ListTopicSubscriptionsRequest request) *
                                                                                        - *

                                                                                        "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                        + *

                                                                                        "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                        *
                                                                                          *
                                                                                        • listTopicSubscriptions(TopicName topic) *
                                                                                        • listTopicSubscriptions(String topic) *
                                                                                        - *

                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                        + *

                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                        *
                                                                                          *
                                                                                        • listTopicSubscriptionsPagedCallable() *
                                                                                        • listTopicSubscriptionsCallable() @@ -205,16 +205,16 @@ * set the acknowledgment state of messages in an existing subscription to the * state captured by a snapshot.

                                                                                          * - *

                                                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                          + *

                                                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                          *
                                                                                            *
                                                                                          • listTopicSnapshots(ListTopicSnapshotsRequest request) *
                                                                                          - *

                                                                                          "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                          + *

                                                                                          "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                          *
                                                                                            *
                                                                                          • listTopicSnapshots(TopicName topic) *
                                                                                          • listTopicSnapshots(String topic) *
                                                                                          - *

                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                          + *

                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                          *
                                                                                            *
                                                                                          • listTopicSnapshotsPagedCallable() *
                                                                                          • listTopicSnapshotsCallable() @@ -229,16 +229,16 @@ * configuration or subscriptions. Existing subscriptions to this topic are * not deleted, but their `topic` field is set to `_deleted-topic_`.

                                                                                            * - *

                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                            + *

                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                            *
                                                                                              *
                                                                                            • deleteTopic(DeleteTopicRequest request) *
                                                                                            - *

                                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                            + *

                                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                            *
                                                                                              *
                                                                                            • deleteTopic(TopicName topic) *
                                                                                            • deleteTopic(String topic) *
                                                                                            - *

                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            + *

                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            *
                                                                                              *
                                                                                            • deleteTopicCallable() *
                                                                                            @@ -251,11 +251,11 @@ * will return FAILED_PRECONDITION. If the subscription is a push * subscription, pushes to the endpoint will stop.

                                                                                            * - *

                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                            + *

                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                            *
                                                                                              *
                                                                                            • detachSubscription(DetachSubscriptionRequest request) *
                                                                                            - *

                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            + *

                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            *
                                                                                              *
                                                                                            • detachSubscriptionCallable() *
                                                                                            @@ -269,11 +269,11 @@ * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` * errors.

                                                                                            * - *

                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                            + *

                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                            *
                                                                                              *
                                                                                            • setIamPolicy(SetIamPolicyRequest request) *
                                                                                            - *

                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            + *

                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            *
                                                                                              *
                                                                                            • setIamPolicyCallable() *
                                                                                            @@ -284,11 +284,11 @@ *

                                                                                            Gets the access control policy for a resource. Returns an empty policy * if the resource exists and does not have a policy set.

                                                                                            * - *

                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                            + *

                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                            *
                                                                                              *
                                                                                            • getIamPolicy(GetIamPolicyRequest request) *
                                                                                            - *

                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            + *

                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            *
                                                                                              *
                                                                                            • getIamPolicyCallable() *
                                                                                            @@ -304,11 +304,11 @@ * permission-aware UIs and command-line tools, not for authorization * checking. This operation may "fail open" without warning.

                                                                                            * - *

                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                            + *

                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                            *
                                                                                              *
                                                                                            • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                            - *

                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            + *

                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            *
                                                                                              *
                                                                                            • testIamPermissionsCallable() *
                                                                                            diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index 0fdef5ba2f..ea48e84e48 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -99,16 +99,16 @@ * If `location_id` is specified as `-` (wildcard), then all regions * available to the project are queried, and the results are aggregated.

                                                                                            * - *

                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                            + *

                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                            *
                                                                                              *
                                                                                            • listInstances(ListInstancesRequest request) *
                                                                                            - *

                                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                            + *

                                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                            *
                                                                                              *
                                                                                            • listInstances(LocationName parent) *
                                                                                            • listInstances(String parent) *
                                                                                            - *

                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            + *

                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                            *
                                                                                              *
                                                                                            • listInstancesPagedCallable() *
                                                                                            • listInstancesCallable() @@ -119,16 +119,16 @@ * GetInstance *

                                                                                              Gets the details of a specific Redis instance.

                                                                                              * - *

                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                              + *

                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                              *
                                                                                                *
                                                                                              • getInstance(GetInstanceRequest request) *
                                                                                              - *

                                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                              + *

                                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                              *
                                                                                                *
                                                                                              • getInstance(InstanceName name) *
                                                                                              • getInstance(String name) *
                                                                                              - *

                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                              + *

                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                              *
                                                                                                *
                                                                                              • getInstanceCallable() *
                                                                                              @@ -140,16 +140,16 @@ * instance the response will be empty. This information is not included in * the details returned to GetInstance.

                                                                                              * - *

                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                              + *

                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                              *
                                                                                                *
                                                                                              • getInstanceAuthString(GetInstanceAuthStringRequest request) *
                                                                                              - *

                                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                              + *

                                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                              *
                                                                                                *
                                                                                              • getInstanceAuthString(InstanceName name) *
                                                                                              • getInstanceAuthString(String name) *
                                                                                              - *

                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                              + *

                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                              *
                                                                                                *
                                                                                              • getInstanceAuthStringCallable() *
                                                                                              @@ -170,16 +170,16 @@ * The returned operation is automatically deleted after a few hours, so there * is no need to call DeleteOperation.

                                                                                              * - *

                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                              + *

                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                              *
                                                                                                *
                                                                                              • createInstanceAsync(CreateInstanceRequest request) *
                                                                                              - *

                                                                                              Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                              + *

                                                                                              Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                              *
                                                                                                *
                                                                                              • createInstanceAsync(LocationName parent) *
                                                                                              • createInstanceAsync(String parent) *
                                                                                              - *

                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                              + *

                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                              *
                                                                                                *
                                                                                              • createInstanceOperationCallable() *
                                                                                              • createInstanceCallable() @@ -194,15 +194,15 @@ * in the response field. The returned operation is automatically deleted * after a few hours, so there is no need to call DeleteOperation.

                                                                                                * - *

                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                + *

                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                *
                                                                                                  *
                                                                                                • updateInstanceAsync(UpdateInstanceRequest request) *
                                                                                                - *

                                                                                                Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                + *

                                                                                                Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                *
                                                                                                  *
                                                                                                • updateInstanceAsync(FieldMask updateMask) *
                                                                                                - *

                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                + *

                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                *
                                                                                                  *
                                                                                                • updateInstanceOperationCallable() *
                                                                                                • updateInstanceCallable() @@ -214,16 +214,16 @@ *

                                                                                                  Upgrades Redis instance to the newer Redis version specified in the * request.

                                                                                                  * - *

                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                  + *

                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                  *
                                                                                                    *
                                                                                                  • upgradeInstanceAsync(UpgradeInstanceRequest request) *
                                                                                                  - *

                                                                                                  Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                  + *

                                                                                                  Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                  *
                                                                                                    *
                                                                                                  • upgradeInstanceAsync(InstanceName name) *
                                                                                                  • upgradeInstanceAsync(String name) *
                                                                                                  - *

                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                  + *

                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                  *
                                                                                                    *
                                                                                                  • upgradeInstanceOperationCallable() *
                                                                                                  • upgradeInstanceCallable() @@ -241,15 +241,15 @@ * The returned operation is automatically deleted after a few hours, so * there is no need to call DeleteOperation.

                                                                                                    * - *

                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                    + *

                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                    *
                                                                                                      *
                                                                                                    • importInstanceAsync(ImportInstanceRequest request) *
                                                                                                    - *

                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                    + *

                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                    *
                                                                                                      *
                                                                                                    • importInstanceAsync(String name) *
                                                                                                    - *

                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                    + *

                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                    *
                                                                                                      *
                                                                                                    • importInstanceOperationCallable() *
                                                                                                    • importInstanceCallable() @@ -265,15 +265,15 @@ * The returned operation is automatically deleted after a few hours, so * there is no need to call DeleteOperation.

                                                                                                      * - *

                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                      + *

                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                      *
                                                                                                        *
                                                                                                      • exportInstanceAsync(ExportInstanceRequest request) *
                                                                                                      - *

                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                      + *

                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                      *
                                                                                                        *
                                                                                                      • exportInstanceAsync(String name) *
                                                                                                      - *

                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                      + *

                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                      *
                                                                                                        *
                                                                                                      • exportInstanceOperationCallable() *
                                                                                                      • exportInstanceCallable() @@ -285,16 +285,16 @@ *

                                                                                                        Initiates a failover of the primary node to current replica node for a * specific STANDARD tier Cloud Memorystore for Redis instance.

                                                                                                        * - *

                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                        + *

                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                        *
                                                                                                          *
                                                                                                        • failoverInstanceAsync(FailoverInstanceRequest request) *
                                                                                                        - *

                                                                                                        Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                        + *

                                                                                                        Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                        *
                                                                                                          *
                                                                                                        • failoverInstanceAsync(InstanceName name) *
                                                                                                        • failoverInstanceAsync(String name) *
                                                                                                        - *

                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                        + *

                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                        *
                                                                                                          *
                                                                                                        • failoverInstanceOperationCallable() *
                                                                                                        • failoverInstanceCallable() @@ -306,16 +306,16 @@ *

                                                                                                          Deletes a specific Redis instance. Instance stops serving and data is * deleted.

                                                                                                          * - *

                                                                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                          + *

                                                                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                          *
                                                                                                            *
                                                                                                          • deleteInstanceAsync(DeleteInstanceRequest request) *
                                                                                                          - *

                                                                                                          Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                          + *

                                                                                                          Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                          *
                                                                                                            *
                                                                                                          • deleteInstanceAsync(InstanceName name) *
                                                                                                          • deleteInstanceAsync(String name) *
                                                                                                          - *

                                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                          + *

                                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                          *
                                                                                                            *
                                                                                                          • deleteInstanceOperationCallable() *
                                                                                                          • deleteInstanceCallable() @@ -327,16 +327,16 @@ *

                                                                                                            Reschedule maintenance for a given instance in a given project and * location.

                                                                                                            * - *

                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                            + *

                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                            *
                                                                                                              *
                                                                                                            • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) *
                                                                                                            - *

                                                                                                            Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                            + *

                                                                                                            Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                            *
                                                                                                              *
                                                                                                            • rescheduleMaintenanceAsync(InstanceName name) *
                                                                                                            • rescheduleMaintenanceAsync(String name) *
                                                                                                            - *

                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                            + *

                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                            *
                                                                                                              *
                                                                                                            • rescheduleMaintenanceOperationCallable() *
                                                                                                            • rescheduleMaintenanceCallable() diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index cd97389ba8..18b61816db 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -87,16 +87,16 @@ * DeleteBucket *

                                                                                                              Permanently deletes an empty bucket.

                                                                                                              * - *

                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                              + *

                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                              *
                                                                                                                *
                                                                                                              • deleteBucket(DeleteBucketRequest request) *
                                                                                                              - *

                                                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                              + *

                                                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                              *
                                                                                                                *
                                                                                                              • deleteBucket(BucketName name) *
                                                                                                              • deleteBucket(String name) *
                                                                                                              - *

                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              + *

                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              *
                                                                                                                *
                                                                                                              • deleteBucketCallable() *
                                                                                                              @@ -106,16 +106,16 @@ * GetBucket *

                                                                                                              Returns metadata for the specified bucket.

                                                                                                              * - *

                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                              + *

                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                              *
                                                                                                                *
                                                                                                              • getBucket(GetBucketRequest request) *
                                                                                                              - *

                                                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                              + *

                                                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                              *
                                                                                                                *
                                                                                                              • getBucket(BucketName name) *
                                                                                                              • getBucket(String name) *
                                                                                                              - *

                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              + *

                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              *
                                                                                                                *
                                                                                                              • getBucketCallable() *
                                                                                                              @@ -125,16 +125,16 @@ * CreateBucket *

                                                                                                              Creates a new bucket.

                                                                                                              * - *

                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                              + *

                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                              *
                                                                                                                *
                                                                                                              • createBucket(CreateBucketRequest request) *
                                                                                                              - *

                                                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                              + *

                                                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                              *
                                                                                                                *
                                                                                                              • createBucket(ProjectName parent) *
                                                                                                              • createBucket(String parent) *
                                                                                                              - *

                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              + *

                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              *
                                                                                                                *
                                                                                                              • createBucketCallable() *
                                                                                                              @@ -144,16 +144,16 @@ * ListBuckets *

                                                                                                              Retrieves a list of buckets for a given project.

                                                                                                              * - *

                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                              + *

                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                              *
                                                                                                                *
                                                                                                              • listBuckets(ListBucketsRequest request) *
                                                                                                              - *

                                                                                                              "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                              + *

                                                                                                              "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                              *
                                                                                                                *
                                                                                                              • listBuckets(ProjectName parent) *
                                                                                                              • listBuckets(String parent) *
                                                                                                              - *

                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              + *

                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                              *
                                                                                                                *
                                                                                                              • listBucketsPagedCallable() *
                                                                                                              • listBucketsCallable() @@ -164,16 +164,16 @@ * LockBucketRetentionPolicy *

                                                                                                                Locks retention policy on a bucket.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • lockBucketRetentionPolicy(BucketName bucket) *
                                                                                                                • lockBucketRetentionPolicy(String bucket) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • lockBucketRetentionPolicyCallable() *
                                                                                                                @@ -186,16 +186,16 @@ * projects/_/buckets/ for a bucket or * projects/_/buckets//objects/ for an object.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • getIamPolicy(ResourceName resource) *
                                                                                                                • getIamPolicy(String resource) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • getIamPolicyCallable() *
                                                                                                                @@ -208,16 +208,16 @@ * projects/_/buckets/ for a bucket or * projects/_/buckets//objects/ for an object.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • setIamPolicy(ResourceName resource) *
                                                                                                                • setIamPolicy(String resource) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • setIamPolicyCallable() *
                                                                                                                @@ -231,16 +231,16 @@ * projects/_/buckets/ for a bucket or * projects/_/buckets//objects/ for an object.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • testIamPermissions(ResourceName resource) *
                                                                                                                • testIamPermissions(String resource) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • testIamPermissionsCallable() *
                                                                                                                @@ -250,15 +250,15 @@ * UpdateBucket *

                                                                                                                Updates a bucket. Equivalent to JSON API's storage.buckets.patch method.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • updateBucket(UpdateBucketRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • updateBucket(Bucket bucket) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • updateBucketCallable() *
                                                                                                                @@ -268,16 +268,16 @@ * DeleteNotification *

                                                                                                                Permanently deletes a notification subscription.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • deleteNotification(DeleteNotificationRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • deleteNotification(NotificationName name) *
                                                                                                                • deleteNotification(String name) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • deleteNotificationCallable() *
                                                                                                                @@ -287,16 +287,16 @@ * GetNotification *

                                                                                                                View a notification config.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • getNotification(GetNotificationRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • getNotification(BucketName name) *
                                                                                                                • getNotification(String name) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • getNotificationCallable() *
                                                                                                                @@ -309,16 +309,16 @@ * Pub/Sub topics. * See https://cloud.google.com/storage/docs/pubsub-notifications.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • createNotification(CreateNotificationRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • createNotification(ProjectName parent) *
                                                                                                                • createNotification(String parent) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • createNotificationCallable() *
                                                                                                                @@ -328,16 +328,16 @@ * ListNotifications *

                                                                                                                Retrieves a list of notification subscriptions for a given bucket.

                                                                                                                * - *

                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                + *

                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                *
                                                                                                                  *
                                                                                                                • listNotifications(ListNotificationsRequest request) *
                                                                                                                - *

                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                + *

                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                *
                                                                                                                  *
                                                                                                                • listNotifications(ProjectName parent) *
                                                                                                                • listNotifications(String parent) *
                                                                                                                - *

                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                + *

                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                *
                                                                                                                  *
                                                                                                                • listNotificationsPagedCallable() *
                                                                                                                • listNotificationsCallable() @@ -349,11 +349,11 @@ *

                                                                                                                  Concatenates a list of existing objects into a new object in the same * bucket.

                                                                                                                  * - *

                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                  + *

                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • composeObject(ComposeObjectRequest request) *
                                                                                                                  - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • composeObjectCallable() *
                                                                                                                  @@ -364,16 +364,16 @@ *

                                                                                                                  Deletes an object and its metadata. Deletions are permanent if versioning * is not enabled for the bucket, or if the `generation` parameter is used.

                                                                                                                  * - *

                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                  + *

                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • deleteObject(DeleteObjectRequest request) *
                                                                                                                  - *

                                                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                  + *

                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • deleteObject(String bucket) *
                                                                                                                  • deleteObject(String bucket) *
                                                                                                                  - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • deleteObjectCallable() *
                                                                                                                  @@ -383,15 +383,15 @@ * CancelResumableWrite *

                                                                                                                  Cancels an in-progress resumable upload.

                                                                                                                  * - *

                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                  + *

                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • cancelResumableWrite(CancelResumableWriteRequest request) *
                                                                                                                  - *

                                                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                  + *

                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • cancelResumableWrite(String uploadId) *
                                                                                                                  - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • cancelResumableWriteCallable() *
                                                                                                                  @@ -401,16 +401,16 @@ * GetObject *

                                                                                                                  Retrieves an object's metadata.

                                                                                                                  * - *

                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                  + *

                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • getObject(GetObjectRequest request) *
                                                                                                                  - *

                                                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                  + *

                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • getObject(String bucket) *
                                                                                                                  • getObject(String bucket) *
                                                                                                                  - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • getObjectCallable() *
                                                                                                                  @@ -420,7 +420,7 @@ * ReadObject *

                                                                                                                  Reads an object's data.

                                                                                                                  * - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • readObjectCallable() *
                                                                                                                  @@ -431,15 +431,15 @@ *

                                                                                                                  Updates an object's metadata. * Equivalent to JSON API's storage.objects.patch.

                                                                                                                  * - *

                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                  + *

                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • updateObject(UpdateObjectRequest request) *
                                                                                                                  - *

                                                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                  + *

                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • updateObject(Object object) *
                                                                                                                  - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • updateObjectCallable() *
                                                                                                                  @@ -500,7 +500,7 @@ * status, with a WriteObjectResponse containing the finalized object's * metadata.

                                                                                                                  * - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • writeObjectCallable() *
                                                                                                                  @@ -510,16 +510,16 @@ * ListObjects *

                                                                                                                  Retrieves a list of objects matching the criteria.

                                                                                                                  * - *

                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                  + *

                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • listObjects(ListObjectsRequest request) *
                                                                                                                  - *

                                                                                                                  "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                  + *

                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • listObjects(ProjectName parent) *
                                                                                                                  • listObjects(String parent) *
                                                                                                                  - *

                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  + *

                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                  *
                                                                                                                    *
                                                                                                                  • listObjectsPagedCallable() *
                                                                                                                  • listObjectsCallable() @@ -531,11 +531,11 @@ *

                                                                                                                    Rewrites a source object to a destination object. Optionally overrides * metadata.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • rewriteObject(RewriteObjectRequest request) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • rewriteObjectCallable() *
                                                                                                                    @@ -547,11 +547,11 @@ * what happens when the write operation becomes invalid, are * service-dependent.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • startResumableWrite(StartResumableWriteRequest request) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • startResumableWriteCallable() *
                                                                                                                    @@ -573,15 +573,15 @@ * object name, the sequence of returned `persisted_size` values will be * non-decreasing.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • queryWriteStatus(QueryWriteStatusRequest request) *
                                                                                                                    - *

                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                    + *

                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • queryWriteStatus(String uploadId) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • queryWriteStatusCallable() *
                                                                                                                    @@ -591,16 +591,16 @@ * GetServiceAccount *

                                                                                                                    Retrieves the name of a project's Google Cloud Storage service account.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • getServiceAccount(GetServiceAccountRequest request) *
                                                                                                                    - *

                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                    + *

                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • getServiceAccount(ProjectName project) *
                                                                                                                    • getServiceAccount(String project) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • getServiceAccountCallable() *
                                                                                                                    @@ -610,16 +610,16 @@ * CreateHmacKey *

                                                                                                                    Creates a new HMAC key for the given service account.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • createHmacKey(CreateHmacKeyRequest request) *
                                                                                                                    - *

                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                    + *

                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • createHmacKey(ProjectName project) *
                                                                                                                    • createHmacKey(String project) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • createHmacKeyCallable() *
                                                                                                                    @@ -629,16 +629,16 @@ * DeleteHmacKey *

                                                                                                                    Deletes a given HMAC key. Key must be in an INACTIVE state.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • deleteHmacKey(DeleteHmacKeyRequest request) *
                                                                                                                    - *

                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                    + *

                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • deleteHmacKey(String accessId) *
                                                                                                                    • deleteHmacKey(String accessId) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • deleteHmacKeyCallable() *
                                                                                                                    @@ -648,16 +648,16 @@ * GetHmacKey *

                                                                                                                    Gets an existing HMAC key metadata for the given id.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • getHmacKey(GetHmacKeyRequest request) *
                                                                                                                    - *

                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                    + *

                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • getHmacKey(String accessId) *
                                                                                                                    • getHmacKey(String accessId) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • getHmacKeyCallable() *
                                                                                                                    @@ -667,16 +667,16 @@ * ListHmacKeys *

                                                                                                                    Lists HMAC keys under a given project with the additional filters provided.

                                                                                                                    * - *

                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                    + *

                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • listHmacKeys(ListHmacKeysRequest request) *
                                                                                                                    - *

                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                    + *

                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • listHmacKeys(ProjectName project) *
                                                                                                                    • listHmacKeys(String project) *
                                                                                                                    - *

                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    + *

                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                    *
                                                                                                                      *
                                                                                                                    • listHmacKeysPagedCallable() *
                                                                                                                    • listHmacKeysCallable() @@ -687,15 +687,15 @@ * UpdateHmacKey *

                                                                                                                      Updates a given HMAC key state between ACTIVE and INACTIVE.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • updateHmacKey(UpdateHmacKeyRequest request) *
                                                                                                                      - *

                                                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                      + *

                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • updateHmacKey(HmacKeyMetadata hmacKey) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • updateHmacKeyCallable() *
                                                                                                                      From 4944068c787a98b0df186956c1e5563baeb88041 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Tue, 14 Nov 2023 09:50:40 -0500 Subject: [PATCH 17/21] refactor --- .../comment/ServiceClientCommentComposer.java | 57 ++++++------------- 1 file changed, 17 insertions(+), 40 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index 44d4f20a50..550baf55ed 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -245,52 +245,29 @@ private static String createTableOfMethods(List methodAndVari .append("

                                                                                                                      " + method.description + "

                                                                                                                      ") .append("\n") .append(" \n"); - if (method.hasRequestObjectVariants) { - tableBuilder - .append(" " + REQUEST_OBJECT_METHODS + " ") - .append("
                                                                                                                        \n") - .append("
                                                                                                                      • ") - .append(String.join("\n
                                                                                                                      • ", method.requestObjectVariants)) - .append("\n") - .append("
                                                                                                                      ") - .append("\n"); - } - if (method.hasFlattenedVariants) { - tableBuilder - .append(" " + FLATTENED_METHODS + " ") - .append("
                                                                                                                        \n") - .append("
                                                                                                                      • ") - .append(String.join("\n
                                                                                                                      • ", method.flattenedVariants)) - .append("\n") - .append("
                                                                                                                      ") - .append("\n"); - } - if (method.hasAsyncVariants) { - tableBuilder - .append(" " + ASYNC_METHODS + " ") - .append("
                                                                                                                        \n") - .append("
                                                                                                                      • ") - .append(String.join("\n
                                                                                                                      • ", method.asyncVariants)) - .append("\n") - .append("
                                                                                                                      ") - .append("\n"); - } - if (method.hasCallableVariants) { - tableBuilder - .append(" " + CALLABLE_METHODS + " ") - .append("
                                                                                                                        \n") - .append("
                                                                                                                      • ") - .append(String.join("\n
                                                                                                                      • ", method.callableVariants)) - .append("\n") - .append("
                                                                                                                      ") - .append("\n"); - } + generateUnorderedListMethodVariants(tableBuilder, REQUEST_OBJECT_METHODS, method.requestObjectVariants); + generateUnorderedListMethodVariants(tableBuilder, FLATTENED_METHODS, method.flattenedVariants); + generateUnorderedListMethodVariants(tableBuilder, ASYNC_METHODS, method.asyncVariants); + generateUnorderedListMethodVariants(tableBuilder, CALLABLE_METHODS, method.callableVariants); tableBuilder.append(" \n").append(" \n"); } tableBuilder.append(" \n"); return tableBuilder.toString(); } + private static void generateUnorderedListMethodVariants(StringBuilder tableBuilder, String methodType, List methodVariants) { + if (!methodVariants.isEmpty()) { + tableBuilder + .append(" " + methodType + " ") + .append("
                                                                                                                        \n") + .append("
                                                                                                                      • ") + .append(String.join("\n
                                                                                                                      • ", methodVariants)) + .append("\n") + .append("
                                                                                                                      ") + .append("\n"); + } + } + private static class MethodAndVariants { private final String method; private final String description; From 11f0c0343928bf08d959f9903fceeec44f288b91 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Tue, 14 Nov 2023 10:06:47 -0500 Subject: [PATCH 18/21] fix lint and showcase goldens --- .../comment/ServiceClientCommentComposer.java | 9 +- .../showcase/v1beta1/ComplianceClient.java | 60 ++++++------- .../google/showcase/v1beta1/EchoClient.java | 50 +++++------ .../showcase/v1beta1/IdentityClient.java | 46 +++++----- .../showcase/v1beta1/MessagingClient.java | 86 +++++++++---------- .../v1beta1/SequenceServiceClient.java | 52 +++++------ .../showcase/v1beta1/TestingClient.java | 52 +++++------ 7 files changed, 179 insertions(+), 176 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index 550baf55ed..f143a4347e 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -245,8 +245,10 @@ private static String createTableOfMethods(List methodAndVari .append("

                                                                                                                      " + method.description + "

                                                                                                                      ") .append("\n") .append(" \n"); - generateUnorderedListMethodVariants(tableBuilder, REQUEST_OBJECT_METHODS, method.requestObjectVariants); - generateUnorderedListMethodVariants(tableBuilder, FLATTENED_METHODS, method.flattenedVariants); + generateUnorderedListMethodVariants( + tableBuilder, REQUEST_OBJECT_METHODS, method.requestObjectVariants); + generateUnorderedListMethodVariants( + tableBuilder, FLATTENED_METHODS, method.flattenedVariants); generateUnorderedListMethodVariants(tableBuilder, ASYNC_METHODS, method.asyncVariants); generateUnorderedListMethodVariants(tableBuilder, CALLABLE_METHODS, method.callableVariants); tableBuilder.append(" \n").append(" \n"); @@ -255,7 +257,8 @@ private static String createTableOfMethods(List methodAndVari return tableBuilder.toString(); } - private static void generateUnorderedListMethodVariants(StringBuilder tableBuilder, String methodType, List methodVariants) { + private static void generateUnorderedListMethodVariants( + StringBuilder tableBuilder, String methodType, List methodVariants) { if (!methodVariants.isEmpty()) { tableBuilder .append(" " + methodType + " ") diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java index e1ba243756..abedf55175 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java @@ -89,11 +89,11 @@ *

                                                                                                                      This method echoes the ComplianceData request. This method exercises * sending the entire request object in the REST body.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBody(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBodyCallable() *
                                                                                                                      @@ -105,11 +105,11 @@ * sending the a message-type field in the REST body. Per AIP-127, only * top-level, non-repeated fields can be sent this way.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBodyInfo(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBodyInfoCallable() *
                                                                                                                      @@ -120,11 +120,11 @@ *

                                                                                                                      This method echoes the ComplianceData request. This method exercises * sending all request fields as query parameters.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataQuery(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataQueryCallable() *
                                                                                                                      @@ -136,11 +136,11 @@ * sending some parameters as "simple" path variables (i.e., of the form * "/bar/{foo}" rather than "/{foo=bar/*}"), and the rest as query parameters.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataSimplePath(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataSimplePathCallable() *
                                                                                                                      @@ -150,11 +150,11 @@ * RepeatDataPathResource *

                                                                                                                      Same as RepeatDataSimplePath, but with a path resource.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataPathResource(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataPathResourceCallable() *
                                                                                                                      @@ -164,11 +164,11 @@ * RepeatDataPathTrailingResource *

                                                                                                                      Same as RepeatDataSimplePath, but with a trailing resource.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataPathTrailingResource(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataPathTrailingResourceCallable() *
                                                                                                                      @@ -178,11 +178,11 @@ * RepeatDataBodyPut *

                                                                                                                      This method echoes the ComplianceData request, using the HTTP PUT method.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBodyPut(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBodyPutCallable() *
                                                                                                                      @@ -192,11 +192,11 @@ * RepeatDataBodyPatch *

                                                                                                                      This method echoes the ComplianceData request, using the HTTP PATCH method.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBodyPatch(RepeatRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • repeatDataBodyPatchCallable() *
                                                                                                                      @@ -211,11 +211,11 @@ * The values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run (this is needed for * VerifyEnum() to work) but are not guaranteed to be the same across separate Showcase server runs.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • getEnum(EnumRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • getEnumCallable() *
                                                                                                                      @@ -230,11 +230,11 @@ * This works because the values of enums sent by the server when a known or unknown value is requested will be the same within a single Showcase server run, * although they are not guaranteed to be the same across separate Showcase server runs.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • verifyEnum(EnumResponse request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • verifyEnumCallable() *
                                                                                                                      @@ -244,11 +244,11 @@ * ListLocations *

                                                                                                                      Lists information about the supported locations for this service.

                                                                                                                      * - *

                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                      + *

                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                      - *

                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      + *

                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                      *
                                                                                                                        *
                                                                                                                      • listLocationsPagedCallable() *
                                                                                                                      • listLocationsCallable() @@ -259,11 +259,11 @@ * GetLocation *

                                                                                                                        Gets information about a location.

                                                                                                                        * - *

                                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                        + *

                                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • getLocation(GetLocationRequest request) *
                                                                                                                        - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • getLocationCallable() *
                                                                                                                        @@ -276,11 +276,11 @@ * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

                                                                                                                        * - *

                                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                        + *

                                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                        - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • setIamPolicyCallable() *
                                                                                                                        @@ -292,11 +292,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                                                                                                        * - *

                                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                        + *

                                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                        - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • getIamPolicyCallable() *
                                                                                                                        @@ -312,11 +312,11 @@ * UIs and command-line tools, not for authorization checking. This operation * may "fail open" without warning.

                                                                                                                        * - *

                                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                        + *

                                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                        - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • testIamPermissionsCallable() *
                                                                                                                        diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java index b7bf1b3a9f..1d0576f352 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java @@ -91,11 +91,11 @@ * Echo *

                                                                                                                        This method simply echoes the request. This method showcases unary RPCs.

                                                                                                                        * - *

                                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                        + *

                                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • echo(EchoRequest request) *
                                                                                                                        - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • echoCallable() *
                                                                                                                        @@ -106,7 +106,7 @@ *

                                                                                                                        This method splits the given content into words and will pass each word back * through the stream. This method showcases server-side streaming RPCs.

                                                                                                                        * - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • expandCallable() *
                                                                                                                        @@ -118,7 +118,7 @@ * by the client, this method will return the a concatenation of the strings * passed to it. This method showcases client-side streaming RPCs.

                                                                                                                        * - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • collectCallable() *
                                                                                                                        @@ -130,7 +130,7 @@ * content back on the stream. This method showcases bidirectional * streaming RPCs.

                                                                                                                        * - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • chatCallable() *
                                                                                                                        @@ -141,11 +141,11 @@ *

                                                                                                                        This is similar to the Expand method but instead of returning a stream of * expanded words, this method returns a paged list of expanded words.

                                                                                                                        * - *

                                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                        + *

                                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • pagedExpand(PagedExpandRequest request) *
                                                                                                                        - *

                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        + *

                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                        *
                                                                                                                          *
                                                                                                                        • pagedExpandPagedCallable() *
                                                                                                                        • pagedExpandCallable() @@ -158,11 +158,11 @@ * max_results instead of page_size, as some legacy APIs still * do. New APIs should NOT use this pattern.

                                                                                                                          * - *

                                                                                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                          + *

                                                                                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                          *
                                                                                                                            *
                                                                                                                          • pagedExpandLegacy(PagedExpandLegacyRequest request) *
                                                                                                                          - *

                                                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                          + *

                                                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                          *
                                                                                                                            *
                                                                                                                          • pagedExpandLegacyCallable() *
                                                                                                                          @@ -176,11 +176,11 @@ * input. This paging result consisting of a map of lists is a pattern used by some legacy * APIs. New APIs should NOT use this pattern.

                                                                                                                          * - *

                                                                                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                          + *

                                                                                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                          *
                                                                                                                            *
                                                                                                                          • pagedExpandLegacyMapped(PagedExpandRequest request) *
                                                                                                                          - *

                                                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                          + *

                                                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                          *
                                                                                                                            *
                                                                                                                          • pagedExpandLegacyMappedPagedCallable() *
                                                                                                                          • pagedExpandLegacyMappedCallable() @@ -192,11 +192,11 @@ *

                                                                                                                            This method will wait for the requested amount of time and then return. * This method showcases how a client handles a request timeout.

                                                                                                                            * - *

                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                            + *

                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                            *
                                                                                                                              *
                                                                                                                            • waitAsync(WaitRequest request) *
                                                                                                                            - *

                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                            + *

                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                            *
                                                                                                                              *
                                                                                                                            • waitOperationCallable() *
                                                                                                                            • waitCallable() @@ -209,11 +209,11 @@ * and then return the response or error. * This method showcases how a client handles delays or retries.

                                                                                                                              * - *

                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                              + *

                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                              *
                                                                                                                                *
                                                                                                                              • block(BlockRequest request) *
                                                                                                                              - *

                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                              + *

                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                              *
                                                                                                                                *
                                                                                                                              • blockCallable() *
                                                                                                                              @@ -223,11 +223,11 @@ * ListLocations *

                                                                                                                              Lists information about the supported locations for this service.

                                                                                                                              * - *

                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                              + *

                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                              *
                                                                                                                                *
                                                                                                                              • listLocations(ListLocationsRequest request) *
                                                                                                                              - *

                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                              + *

                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                              *
                                                                                                                                *
                                                                                                                              • listLocationsPagedCallable() *
                                                                                                                              • listLocationsCallable() @@ -238,11 +238,11 @@ * GetLocation *

                                                                                                                                Gets information about a location.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • getLocation(GetLocationRequest request) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • getLocationCallable() *
                                                                                                                                @@ -255,11 +255,11 @@ * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • setIamPolicyCallable() *
                                                                                                                                @@ -271,11 +271,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • getIamPolicyCallable() *
                                                                                                                                @@ -291,11 +291,11 @@ * UIs and command-line tools, not for authorization checking. This operation * may "fail open" without warning.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • testIamPermissionsCallable() *
                                                                                                                                diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java index 320f1d282a..3eec92512b 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java @@ -75,16 +75,16 @@ * CreateUser *

                                                                                                                                Creates a user.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • createUser(CreateUserRequest request) *
                                                                                                                                - *

                                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                + *

                                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • createUser(String displayName) *
                                                                                                                                • createUser(String displayName) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • createUserCallable() *
                                                                                                                                @@ -94,16 +94,16 @@ * GetUser *

                                                                                                                                Retrieves the User with the given uri.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • getUser(GetUserRequest request) *
                                                                                                                                - *

                                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                + *

                                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • getUser(UserName name) *
                                                                                                                                • getUser(String name) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • getUserCallable() *
                                                                                                                                @@ -113,11 +113,11 @@ * UpdateUser *

                                                                                                                                Updates a user.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • updateUser(UpdateUserRequest request) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • updateUserCallable() *
                                                                                                                                @@ -127,16 +127,16 @@ * DeleteUser *

                                                                                                                                Deletes a user, their profile, and all of their authored messages.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • deleteUser(DeleteUserRequest request) *
                                                                                                                                - *

                                                                                                                                "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                + *

                                                                                                                                "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • deleteUser(UserName name) *
                                                                                                                                • deleteUser(String name) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • deleteUserCallable() *
                                                                                                                                @@ -146,11 +146,11 @@ * ListUsers *

                                                                                                                                Lists all users.

                                                                                                                                * - *

                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                + *

                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • listUsers(ListUsersRequest request) *
                                                                                                                                - *

                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                + *

                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                *
                                                                                                                                  *
                                                                                                                                • listUsersPagedCallable() *
                                                                                                                                • listUsersCallable() @@ -161,11 +161,11 @@ * ListLocations *

                                                                                                                                  Lists information about the supported locations for this service.

                                                                                                                                  * - *

                                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                  + *

                                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                  *
                                                                                                                                    *
                                                                                                                                  • listLocations(ListLocationsRequest request) *
                                                                                                                                  - *

                                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                  + *

                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                  *
                                                                                                                                    *
                                                                                                                                  • listLocationsPagedCallable() *
                                                                                                                                  • listLocationsCallable() @@ -176,11 +176,11 @@ * GetLocation *

                                                                                                                                    Gets information about a location.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • getLocation(GetLocationRequest request) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • getLocationCallable() *
                                                                                                                                    @@ -193,11 +193,11 @@ * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • setIamPolicyCallable() *
                                                                                                                                    @@ -209,11 +209,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • getIamPolicyCallable() *
                                                                                                                                    @@ -229,11 +229,11 @@ * UIs and command-line tools, not for authorization checking. This operation * may "fail open" without warning.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • testIamPermissionsCallable() *
                                                                                                                                    diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java index 7651d212e6..4135e55512 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java @@ -86,15 +86,15 @@ * CreateRoom *

                                                                                                                                    Creates a room.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • createRoom(CreateRoomRequest request) *
                                                                                                                                    - *

                                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                    + *

                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • createRoom(String displayName) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • createRoomCallable() *
                                                                                                                                    @@ -104,16 +104,16 @@ * GetRoom *

                                                                                                                                    Retrieves the Room with the given resource name.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • getRoom(GetRoomRequest request) *
                                                                                                                                    - *

                                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                    + *

                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • getRoom(RoomName name) *
                                                                                                                                    • getRoom(String name) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • getRoomCallable() *
                                                                                                                                    @@ -123,11 +123,11 @@ * UpdateRoom *

                                                                                                                                    Updates a room.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • updateRoom(UpdateRoomRequest request) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • updateRoomCallable() *
                                                                                                                                    @@ -137,16 +137,16 @@ * DeleteRoom *

                                                                                                                                    Deletes a room and all of its blurbs.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • deleteRoom(DeleteRoomRequest request) *
                                                                                                                                    - *

                                                                                                                                    "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                    + *

                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • deleteRoom(RoomName name) *
                                                                                                                                    • deleteRoom(String name) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • deleteRoomCallable() *
                                                                                                                                    @@ -156,11 +156,11 @@ * ListRooms *

                                                                                                                                    Lists all chat rooms.

                                                                                                                                    * - *

                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                    + *

                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • listRooms(ListRoomsRequest request) *
                                                                                                                                    - *

                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    + *

                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                    *
                                                                                                                                      *
                                                                                                                                    • listRoomsPagedCallable() *
                                                                                                                                    • listRoomsCallable() @@ -173,11 +173,11 @@ * message in that room. If the parent is a profile, the blurb is understood * to be a post on the profile.

                                                                                                                                      * - *

                                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                      + *

                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • createBlurb(CreateBlurbRequest request) *
                                                                                                                                      - *

                                                                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                      + *

                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • createBlurb(ProfileName parent) *
                                                                                                                                      • createBlurb(ProfileName parent) @@ -192,7 +192,7 @@ *
                                                                                                                                      • createBlurb(String parent) *
                                                                                                                                      • createBlurb(String parent) *
                                                                                                                                      - *

                                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      + *

                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • createBlurbCallable() *
                                                                                                                                      @@ -202,16 +202,16 @@ * GetBlurb *

                                                                                                                                      Retrieves the Blurb with the given resource name.

                                                                                                                                      * - *

                                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                      + *

                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • getBlurb(GetBlurbRequest request) *
                                                                                                                                      - *

                                                                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                      + *

                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • getBlurb(BlurbName name) *
                                                                                                                                      • getBlurb(String name) *
                                                                                                                                      - *

                                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      + *

                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • getBlurbCallable() *
                                                                                                                                      @@ -221,11 +221,11 @@ * UpdateBlurb *

                                                                                                                                      Updates a blurb.

                                                                                                                                      * - *

                                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                      + *

                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • updateBlurb(UpdateBlurbRequest request) *
                                                                                                                                      - *

                                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      + *

                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • updateBlurbCallable() *
                                                                                                                                      @@ -235,16 +235,16 @@ * DeleteBlurb *

                                                                                                                                      Deletes a blurb.

                                                                                                                                      * - *

                                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                      + *

                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • deleteBlurb(DeleteBlurbRequest request) *
                                                                                                                                      - *

                                                                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                      + *

                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • deleteBlurb(BlurbName name) *
                                                                                                                                      • deleteBlurb(String name) *
                                                                                                                                      - *

                                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      + *

                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • deleteBlurbCallable() *
                                                                                                                                      @@ -255,17 +255,17 @@ *

                                                                                                                                      Lists blurbs for a specific chat room or user profile depending on the * parent resource name.

                                                                                                                                      * - *

                                                                                                                                      Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                      + *

                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • listBlurbs(ListBlurbsRequest request) *
                                                                                                                                      - *

                                                                                                                                      "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                      + *

                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • listBlurbs(ProfileName parent) *
                                                                                                                                      • listBlurbs(RoomName parent) *
                                                                                                                                      • listBlurbs(String parent) *
                                                                                                                                      - *

                                                                                                                                      Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      + *

                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                      *
                                                                                                                                        *
                                                                                                                                      • listBlurbsPagedCallable() *
                                                                                                                                      • listBlurbsCallable() @@ -278,17 +278,17 @@ * for blurbs containing to words found in the query. Only posts that * contain an exact match of a queried word will be returned.

                                                                                                                                        * - *

                                                                                                                                        Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                        + *

                                                                                                                                        Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                        *
                                                                                                                                          *
                                                                                                                                        • searchBlurbsAsync(SearchBlurbsRequest request) *
                                                                                                                                        - *

                                                                                                                                        Methods that return long-running operations have "Async" method variants that return `OperationFuture` which is used to track polling of the service.

                                                                                                                                        + *

                                                                                                                                        Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                        *
                                                                                                                                          *
                                                                                                                                        • searchBlurbsAsync(ProfileName parent) *
                                                                                                                                        • searchBlurbsAsync(RoomName parent) *
                                                                                                                                        • searchBlurbsAsync(String parent) *
                                                                                                                                        - *

                                                                                                                                        Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                        + *

                                                                                                                                        Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                        *
                                                                                                                                          *
                                                                                                                                        • searchBlurbsOperationCallable() *
                                                                                                                                        • searchBlurbsCallable() @@ -300,7 +300,7 @@ *

                                                                                                                                          This returns a stream that emits the blurbs that are created for a * particular chat room or user profile.

                                                                                                                                          * - *

                                                                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          + *

                                                                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          *
                                                                                                                                            *
                                                                                                                                          • streamBlurbsCallable() *
                                                                                                                                          @@ -311,7 +311,7 @@ *

                                                                                                                                          This is a stream to create multiple blurbs. If an invalid blurb is * requested to be created, the stream will close with an error.

                                                                                                                                          * - *

                                                                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          + *

                                                                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          *
                                                                                                                                            *
                                                                                                                                          • sendBlurbsCallable() *
                                                                                                                                          @@ -324,7 +324,7 @@ * blurbs. If an invalid blurb is requested to be created, the stream will * close with an error.

                                                                                                                                          * - *

                                                                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          + *

                                                                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          *
                                                                                                                                            *
                                                                                                                                          • connectCallable() *
                                                                                                                                          @@ -334,11 +334,11 @@ * ListLocations *

                                                                                                                                          Lists information about the supported locations for this service.

                                                                                                                                          * - *

                                                                                                                                          Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                          + *

                                                                                                                                          Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                          *
                                                                                                                                            *
                                                                                                                                          • listLocations(ListLocationsRequest request) *
                                                                                                                                          - *

                                                                                                                                          Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          + *

                                                                                                                                          Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                          *
                                                                                                                                            *
                                                                                                                                          • listLocationsPagedCallable() *
                                                                                                                                          • listLocationsCallable() @@ -349,11 +349,11 @@ * GetLocation *

                                                                                                                                            Gets information about a location.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getLocation(GetLocationRequest request) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getLocationCallable() *
                                                                                                                                            @@ -366,11 +366,11 @@ * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • setIamPolicyCallable() *
                                                                                                                                            @@ -382,11 +382,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getIamPolicyCallable() *
                                                                                                                                            @@ -402,11 +402,11 @@ * UIs and command-line tools, not for authorization checking. This operation * may "fail open" without warning.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • testIamPermissionsCallable() *
                                                                                                                                            diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java index 870d155c13..77106b4e39 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java @@ -74,15 +74,15 @@ * CreateSequence *

                                                                                                                                            Creates a sequence.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • createSequence(CreateSequenceRequest request) *
                                                                                                                                            - *

                                                                                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                            + *

                                                                                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • createSequence(Sequence sequence) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • createSequenceCallable() *
                                                                                                                                            @@ -92,15 +92,15 @@ * CreateStreamingSequence *

                                                                                                                                            Creates a sequence.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • createStreamingSequence(CreateStreamingSequenceRequest request) *
                                                                                                                                            - *

                                                                                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                            + *

                                                                                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • createStreamingSequence(StreamingSequence streamingSequence) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • createStreamingSequenceCallable() *
                                                                                                                                            @@ -110,16 +110,16 @@ * GetSequenceReport *

                                                                                                                                            Retrieves a sequence.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getSequenceReport(GetSequenceReportRequest request) *
                                                                                                                                            - *

                                                                                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                            + *

                                                                                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getSequenceReport(SequenceReportName name) *
                                                                                                                                            • getSequenceReport(String name) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getSequenceReportCallable() *
                                                                                                                                            @@ -129,16 +129,16 @@ * GetStreamingSequenceReport *

                                                                                                                                            Retrieves a sequence.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getStreamingSequenceReport(GetStreamingSequenceReportRequest request) *
                                                                                                                                            - *

                                                                                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                            + *

                                                                                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getStreamingSequenceReport(StreamingSequenceReportName name) *
                                                                                                                                            • getStreamingSequenceReport(String name) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • getStreamingSequenceReportCallable() *
                                                                                                                                            @@ -148,16 +148,16 @@ * AttemptSequence *

                                                                                                                                            Attempts a sequence.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • attemptSequence(AttemptSequenceRequest request) *
                                                                                                                                            - *

                                                                                                                                            "Flattened" method variants have the fields of the request type converted into function parameters to enable multiple ways to call the same method.

                                                                                                                                            + *

                                                                                                                                            "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • attemptSequence(SequenceName name) *
                                                                                                                                            • attemptSequence(String name) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • attemptSequenceCallable() *
                                                                                                                                            @@ -167,7 +167,7 @@ * AttemptStreamingSequence *

                                                                                                                                            Attempts a streaming sequence.

                                                                                                                                            * - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • attemptStreamingSequenceCallable() *
                                                                                                                                            @@ -177,11 +177,11 @@ * ListLocations *

                                                                                                                                            Lists information about the supported locations for this service.

                                                                                                                                            * - *

                                                                                                                                            Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                            + *

                                                                                                                                            Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • listLocations(ListLocationsRequest request) *
                                                                                                                                            - *

                                                                                                                                            Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            + *

                                                                                                                                            Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                            *
                                                                                                                                              *
                                                                                                                                            • listLocationsPagedCallable() *
                                                                                                                                            • listLocationsCallable() @@ -192,11 +192,11 @@ * GetLocation *

                                                                                                                                              Gets information about a location.

                                                                                                                                              * - *

                                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                              + *

                                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • getLocation(GetLocationRequest request) *
                                                                                                                                              - *

                                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              + *

                                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • getLocationCallable() *
                                                                                                                                              @@ -209,11 +209,11 @@ * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

                                                                                                                                              * - *

                                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                              + *

                                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                              - *

                                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              + *

                                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • setIamPolicyCallable() *
                                                                                                                                              @@ -225,11 +225,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                                                                                                                              * - *

                                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                              + *

                                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                              - *

                                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              + *

                                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • getIamPolicyCallable() *
                                                                                                                                              @@ -245,11 +245,11 @@ * UIs and command-line tools, not for authorization checking. This operation * may "fail open" without warning.

                                                                                                                                              * - *

                                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                              + *

                                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                              - *

                                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              + *

                                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • testIamPermissionsCallable() *
                                                                                                                                              diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java index a0bd68aeb6..c54d23e72f 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java @@ -75,11 +75,11 @@ * CreateSession *

                                                                                                                                              Creates a new testing session.

                                                                                                                                              * - *

                                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                              + *

                                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • createSession(CreateSessionRequest request) *
                                                                                                                                              - *

                                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              + *

                                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • createSessionCallable() *
                                                                                                                                              @@ -89,11 +89,11 @@ * GetSession *

                                                                                                                                              Gets a testing session.

                                                                                                                                              * - *

                                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                              + *

                                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • getSession(GetSessionRequest request) *
                                                                                                                                              - *

                                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              + *

                                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • getSessionCallable() *
                                                                                                                                              @@ -103,11 +103,11 @@ * ListSessions *

                                                                                                                                              Lists the current test sessions.

                                                                                                                                              * - *

                                                                                                                                              Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                              + *

                                                                                                                                              Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • listSessions(ListSessionsRequest request) *
                                                                                                                                              - *

                                                                                                                                              Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              + *

                                                                                                                                              Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                              *
                                                                                                                                                *
                                                                                                                                              • listSessionsPagedCallable() *
                                                                                                                                              • listSessionsCallable() @@ -118,11 +118,11 @@ * DeleteSession *

                                                                                                                                                Delete a test session.

                                                                                                                                                * - *

                                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                + *

                                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                *
                                                                                                                                                  *
                                                                                                                                                • deleteSession(DeleteSessionRequest request) *
                                                                                                                                                - *

                                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                + *

                                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                *
                                                                                                                                                  *
                                                                                                                                                • deleteSessionCallable() *
                                                                                                                                                @@ -134,11 +134,11 @@ * This generates a report detailing which tests have been completed, * and an overall rollup.

                                                                                                                                                * - *

                                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                + *

                                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                *
                                                                                                                                                  *
                                                                                                                                                • reportSession(ReportSessionRequest request) *
                                                                                                                                                - *

                                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                + *

                                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                *
                                                                                                                                                  *
                                                                                                                                                • reportSessionCallable() *
                                                                                                                                                @@ -148,11 +148,11 @@ * ListTests *

                                                                                                                                                List the tests of a sessesion.

                                                                                                                                                * - *

                                                                                                                                                Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                + *

                                                                                                                                                Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                *
                                                                                                                                                  *
                                                                                                                                                • listTests(ListTestsRequest request) *
                                                                                                                                                - *

                                                                                                                                                Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                + *

                                                                                                                                                Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                *
                                                                                                                                                  *
                                                                                                                                                • listTestsPagedCallable() *
                                                                                                                                                • listTestsCallable() @@ -168,11 +168,11 @@ * * This method will error if attempting to delete a required test.

                                                                                                                                                  * - *

                                                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                  + *

                                                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                  *
                                                                                                                                                    *
                                                                                                                                                  • deleteTest(DeleteTestRequest request) *
                                                                                                                                                  - *

                                                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  + *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    *
                                                                                                                                                  • deleteTestCallable() *
                                                                                                                                                  @@ -185,11 +185,11 @@ * In cases where a test involves registering a final answer at the * end of the test, this method provides the means to do so.

                                                                                                                                                  * - *

                                                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                  + *

                                                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                  *
                                                                                                                                                    *
                                                                                                                                                  • verifyTest(VerifyTestRequest request) *
                                                                                                                                                  - *

                                                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  + *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    *
                                                                                                                                                  • verifyTestCallable() *
                                                                                                                                                  @@ -199,11 +199,11 @@ * ListLocations *

                                                                                                                                                  Lists information about the supported locations for this service.

                                                                                                                                                  * - *

                                                                                                                                                  Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                  + *

                                                                                                                                                  Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                  *
                                                                                                                                                    *
                                                                                                                                                  • listLocations(ListLocationsRequest request) *
                                                                                                                                                  - *

                                                                                                                                                  Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  + *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    *
                                                                                                                                                  • listLocationsPagedCallable() *
                                                                                                                                                  • listLocationsCallable() @@ -214,11 +214,11 @@ * GetLocation *

                                                                                                                                                    Gets information about a location.

                                                                                                                                                    * - *

                                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    + *

                                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • getLocation(GetLocationRequest request) *
                                                                                                                                                    - *

                                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    + *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • getLocationCallable() *
                                                                                                                                                    @@ -231,11 +231,11 @@ * * Can return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.

                                                                                                                                                    * - *

                                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    + *

                                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                    - *

                                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    + *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • setIamPolicyCallable() *
                                                                                                                                                    @@ -247,11 +247,11 @@ * Returns an empty policy if the resource exists and does not have a policy * set.

                                                                                                                                                    * - *

                                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    + *

                                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                    - *

                                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    + *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • getIamPolicyCallable() *
                                                                                                                                                    @@ -267,11 +267,11 @@ * UIs and command-line tools, not for authorization checking. This operation * may "fail open" without warning.

                                                                                                                                                    * - *

                                                                                                                                                    Request object method variants only takes one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    + *

                                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                    - *

                                                                                                                                                    Callable method variants take no parameters and returns an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    + *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      *
                                                                                                                                                    • testIamPermissionsCallable() *
                                                                                                                                                    From 61671e7db60db2aadaf2610244beb18f21b1b534 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Tue, 14 Nov 2023 10:31:46 -0500 Subject: [PATCH 19/21] update showcase goldens --- .../google/showcase/v1beta1/EchoClient.java | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java index 5d15fcdef2..7ccbf11d2e 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java @@ -102,6 +102,25 @@ * * * + * EchoErrorDetails + *

                                                                                                                                                    This method returns error details in a repeated "google.protobuf.Any" + * field. This method showcases handling errors thus encoded, particularly + * over REST transport. Note that GAPICs only allow the type + * "google.protobuf.Any" for field paths ending in "error.details", and, at + * run-time, the actual types for these fields must be one of the types in + * google/rpc/error_details.proto.

                                                                                                                                                    + * + *

                                                                                                                                                    Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                    + *
                                                                                                                                                      + *
                                                                                                                                                    • echoErrorDetails(EchoErrorDetailsRequest request) + *
                                                                                                                                                    + *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    + *
                                                                                                                                                      + *
                                                                                                                                                    • echoErrorDetailsCallable() + *
                                                                                                                                                    + * + * + * * Expand *

                                                                                                                                                    This method splits the given content into words and will pass each word back * through the stream. This method showcases server-side streaming RPCs.

                                                                                                                                                    From e37bf88fe3ad8871bdd5e037baa4676782ebd184 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Tue, 14 Nov 2023 11:53:49 -0500 Subject: [PATCH 20/21] include all parameters, not just first one --- gapic-generator-java/DEVELOPMENT.md | 9 ++++ .../comment/ServiceClientCommentComposer.java | 11 ++--- .../AbstractServiceClientClassComposer.java | 34 ++++++++++----- .../grpc/goldens/BookshopClient.golden | 4 +- .../composer/grpc/goldens/EchoClient.golden | 2 +- .../grpc/goldens/IdentityClient.golden | 6 +-- .../grpc/goldens/MessagingClient.golden | 14 +++---- .../grpcrest/goldens/EchoClient.golden | 4 +- .../showcase/v1beta1/IdentityClient.java | 4 +- .../showcase/v1beta1/MessagingClient.java | 32 +++++++------- .../cloud/asset/v1/AssetServiceClient.java | 14 +++---- .../data/v2/BaseBigtableDataClient.java | 28 ++++++------- .../compute/v1small/AddressesClient.java | 6 +-- .../v1small/RegionOperationsClient.java | 4 +- .../credentials/v1/IamCredentialsClient.java | 16 +++---- .../kms/v1/KeyManagementServiceClient.java | 40 +++++++++--------- .../library/v1/LibraryServiceClient.java | 22 +++++----- .../google/cloud/logging/v2/ConfigClient.java | 34 +++++++-------- .../cloud/logging/v2/LoggingClient.java | 6 +-- .../cloud/logging/v2/MetricsClient.java | 8 ++-- .../cloud/pubsub/v1/SchemaServiceClient.java | 20 ++++----- .../pubsub/v1/SubscriptionAdminClient.java | 36 ++++++++-------- .../cloud/pubsub/v1/TopicAdminClient.java | 4 +- .../cloud/redis/v1beta1/CloudRedisClient.java | 22 +++++----- .../com/google/storage/v2/StorageClient.java | 42 +++++++++---------- 25 files changed, 220 insertions(+), 202 deletions(-) diff --git a/gapic-generator-java/DEVELOPMENT.md b/gapic-generator-java/DEVELOPMENT.md index 7052d0d0ac..d097e491fc 100644 --- a/gapic-generator-java/DEVELOPMENT.md +++ b/gapic-generator-java/DEVELOPMENT.md @@ -50,6 +50,8 @@ than the "test" phase. To run integration test for gapic-generator-java, run this Bazel command in the root of the repository (where you have WORKSPACE file for Bazel.) +*Note* Make sure you run `mvn clean install` to gather any changes you have made before updating the integration tests. + ```sh # In the repository root directory bazelisk test //... # integration tests @@ -73,6 +75,13 @@ bazelisk test //... # integration tests bazelisk run //test/integration:update_redis ``` +- To update all integration tests you can use this command: + + ```sh + # In the repository root directory + bazelisk run //test/integration:update_asset && bazelisk run //test/integration:update_credentials && bazelisk run //test/integration:update_iam && bazelisk run //test/integration:update_kms && bazelisk run //test/integration:update_pubsub && bazelisk run //test/integration:update_logging && bazelisk run //test/integration:update_redis && bazelisk run //test/integration:update_storage && bazelisk run //test/integration:update_library && bazelisk run //test/integration:update_compute && bazelisk run //test/integration:update_bigtable && bazelisk run //test/integration:update_apigeeconnect + ``` + ## Running the Plugin under googleapis with local gapic-generator-java For running the Plugin with showcase protos and local gapic-generator-java, see diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index f143a4347e..dd15c3a019 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -274,10 +274,6 @@ private static void generateUnorderedListMethodVariants( private static class MethodAndVariants { private final String method; private final String description; - private final boolean hasFlattenedVariants; - private final boolean hasRequestObjectVariants; - private final boolean hasCallableVariants; - private final boolean hasAsyncVariants; private final List flattenedVariants; private final List requestObjectVariants; @@ -289,14 +285,13 @@ private MethodAndVariants(String method, String description, List method this.description = description; requestObjectVariants = methodVariants.stream().filter(s -> s.contains("request")).collect(toList()); - hasRequestObjectVariants = methodVariants.removeAll(requestObjectVariants); + methodVariants.removeAll(requestObjectVariants); callableVariants = methodVariants.stream().filter(s -> s.contains("Callable")).collect(toList()); - hasCallableVariants = methodVariants.removeAll(callableVariants); + methodVariants.removeAll(callableVariants); asyncVariants = methodVariants.stream().filter(s -> s.contains("Async")).collect(toList()); - hasAsyncVariants = methodVariants.removeAll(asyncVariants); + methodVariants.removeAll(asyncVariants); flattenedVariants = methodVariants; - hasFlattenedVariants = !flattenedVariants.isEmpty(); } } diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java index b97414fa66..1cf314c1a4 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java @@ -579,18 +579,32 @@ private List createGetterMethods( } private static String getJavaMethod(MethodDefinition m) { - if (m.arguments().isEmpty()) { - return m.methodIdentifier().name() + "()"; + StringBuilder methodSignature = new StringBuilder(); + + // Method name + methodSignature.append(m.methodIdentifier().name()).append("("); + + // Iterate through and add all parameters + List parameters = + m.arguments().stream().map(VariableExpr::variable).collect(Collectors.toList()); + + for (int i = 0; i < parameters.size(); i++) { + Variable param = parameters.get(i); + String paramType = + param.type().reference() != null ? param.type().reference().name() + " " : ""; + String paramName = param.identifier().name(); + + methodSignature.append(paramType).append(paramName); + + // Add a comma if there are more parameters + if (i < parameters.size() - 1) { + methodSignature.append(", "); + } } - Variable firstParam = m.arguments().get(0).variable(); - String firstParamType = - firstParam.type().reference() != null ? firstParam.type().reference().name() + " " : ""; - return m.methodIdentifier().name() - + "(" - + firstParamType - + firstParam.identifier().name() - + ")"; + methodSignature.append(")"); + + return methodSignature.toString(); } private static List createServiceMethods( diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden index 3c5af7be49..94d532d01a 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden @@ -46,8 +46,8 @@ import javax.annotation.Generated; *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • getBook(booksCount) - *
                                                                                                                                                  • getBook(String booksList) + *
                                                                                                                                                  • getBook(booksCount, List books) + *
                                                                                                                                                  • getBook(String booksList, List books) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden index 09389496f0..b4b324b1ee 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden @@ -74,7 +74,7 @@ import javax.annotation.Generated; *
                                                                                                                                                  • echo(String content) *
                                                                                                                                                  • echo(String name) *
                                                                                                                                                  • echo(String parent) - *
                                                                                                                                                  • echo(String content) + *
                                                                                                                                                  • echo(String content, Severity severity) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden index 76fecc2ed9..b2fa5b1062 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden @@ -55,9 +55,9 @@ import javax.annotation.Generated; *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • createUser(String parent) - *
                                                                                                                                                  • createUser(String parent) - *
                                                                                                                                                  • createUser(String parent) + *
                                                                                                                                                  • createUser(String parent, String displayName, String email) + *
                                                                                                                                                  • createUser(String parent, String displayName, String email, age, String nickname, enableNotifications, heightFeet) + *
                                                                                                                                                  • createUser(String parent, String displayName, String email, String hobbyName, String songName, weeklyFrequency, String companyName, String title, String subject, String artistName) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden index 78a7125a7b..daf7764625 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden @@ -62,7 +62,7 @@ import javax.annotation.Generated; *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • createRoom(String displayName) + *
                                                                                                                                                  • createRoom(String displayName, String description) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -147,12 +147,12 @@ import javax.annotation.Generated; *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • createBlurb(ProfileName parent) - *
                                                                                                                                                  • createBlurb(ProfileName parent) - *
                                                                                                                                                  • createBlurb(RoomName parent) - *
                                                                                                                                                  • createBlurb(RoomName parent) - *
                                                                                                                                                  • createBlurb(String parent) - *
                                                                                                                                                  • createBlurb(String parent) + *
                                                                                                                                                  • createBlurb(ProfileName parent, ByteString image) + *
                                                                                                                                                  • createBlurb(ProfileName parent, String text) + *
                                                                                                                                                  • createBlurb(RoomName parent, ByteString image) + *
                                                                                                                                                  • createBlurb(RoomName parent, String text) + *
                                                                                                                                                  • createBlurb(String parent, ByteString image) + *
                                                                                                                                                  • createBlurb(String parent, String text) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index aa92fd196c..38efab79da 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -69,7 +69,7 @@ import javax.annotation.Generated; *
                                                                                                                                                  • echo(String content) *
                                                                                                                                                  • echo(String name) *
                                                                                                                                                  • echo(String parent) - *
                                                                                                                                                  • echo(String content) + *
                                                                                                                                                  • echo(String content, Severity severity) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -217,7 +217,7 @@ import javax.annotation.Generated; *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • updateCase(Case case_) + *
                                                                                                                                                  • updateCase(Case case_, FieldMask updateMask) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java index 3eec92512b..cea8b7a53b 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java @@ -81,8 +81,8 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • createUser(String displayName) - *
                                                                                                                                                  • createUser(String displayName) + *
                                                                                                                                                  • createUser(String displayName, String email) + *
                                                                                                                                                  • createUser(String displayName, String email, age, String nickname, enableNotifications, heightFeet) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java index 4135e55512..4b8670f534 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java @@ -92,7 +92,7 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • createRoom(String displayName) + *
                                                                                                                                                  • createRoom(String displayName, String description) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -179,18 +179,18 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • createBlurb(ProfileName parent) - *
                                                                                                                                                  • createBlurb(ProfileName parent) - *
                                                                                                                                                  • createBlurb(ProfileName parent) - *
                                                                                                                                                  • createBlurb(ProfileName parent) - *
                                                                                                                                                  • createBlurb(RoomName parent) - *
                                                                                                                                                  • createBlurb(RoomName parent) - *
                                                                                                                                                  • createBlurb(RoomName parent) - *
                                                                                                                                                  • createBlurb(RoomName parent) - *
                                                                                                                                                  • createBlurb(String parent) - *
                                                                                                                                                  • createBlurb(String parent) - *
                                                                                                                                                  • createBlurb(String parent) - *
                                                                                                                                                  • createBlurb(String parent) + *
                                                                                                                                                  • createBlurb(ProfileName parent, UserName user, ByteString image) + *
                                                                                                                                                  • createBlurb(ProfileName parent, UserName user, String text) + *
                                                                                                                                                  • createBlurb(ProfileName parent, String user, ByteString image) + *
                                                                                                                                                  • createBlurb(ProfileName parent, String user, String text) + *
                                                                                                                                                  • createBlurb(RoomName parent, UserName user, ByteString image) + *
                                                                                                                                                  • createBlurb(RoomName parent, UserName user, String text) + *
                                                                                                                                                  • createBlurb(RoomName parent, String user, ByteString image) + *
                                                                                                                                                  • createBlurb(RoomName parent, String user, String text) + *
                                                                                                                                                  • createBlurb(String parent, UserName user, ByteString image) + *
                                                                                                                                                  • createBlurb(String parent, UserName user, String text) + *
                                                                                                                                                  • createBlurb(String parent, String user, ByteString image) + *
                                                                                                                                                  • createBlurb(String parent, String user, String text) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -284,9 +284,9 @@ *
                                                                                                                                                  *

                                                                                                                                                  Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • searchBlurbsAsync(ProfileName parent) - *
                                                                                                                                                  • searchBlurbsAsync(RoomName parent) - *
                                                                                                                                                  • searchBlurbsAsync(String parent) + *
                                                                                                                                                  • searchBlurbsAsync(ProfileName parent, String query) + *
                                                                                                                                                  • searchBlurbsAsync(RoomName parent, String query) + *
                                                                                                                                                  • searchBlurbsAsync(String parent, String query) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index 0e6b4f34a1..ae4b0091bc 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -245,7 +245,7 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • searchAllResources(String scope) + *
                                                                                                                                                  • searchAllResources(String scope, String query, List assetTypes) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -267,7 +267,7 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • searchAllIamPolicies(String scope) + *
                                                                                                                                                  • searchAllIamPolicies(String scope, String query) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -369,10 +369,10 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • createSavedQuery(FolderName parent) - *
                                                                                                                                                  • createSavedQuery(OrganizationName parent) - *
                                                                                                                                                  • createSavedQuery(ProjectName parent) - *
                                                                                                                                                  • createSavedQuery(String parent) + *
                                                                                                                                                  • createSavedQuery(FolderName parent, SavedQuery savedQuery, String savedQueryId) + *
                                                                                                                                                  • createSavedQuery(OrganizationName parent, SavedQuery savedQuery, String savedQueryId) + *
                                                                                                                                                  • createSavedQuery(ProjectName parent, SavedQuery savedQuery, String savedQueryId) + *
                                                                                                                                                  • createSavedQuery(String parent, SavedQuery savedQuery, String savedQueryId) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -431,7 +431,7 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • updateSavedQuery(SavedQuery savedQuery) + *
                                                                                                                                                  • updateSavedQuery(SavedQuery savedQuery, FieldMask updateMask) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index 20e26f3af5..8aae61adc0 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -114,10 +114,10 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • mutateRow(TableName tableName) - *
                                                                                                                                                  • mutateRow(String tableName) - *
                                                                                                                                                  • mutateRow(TableName tableName) - *
                                                                                                                                                  • mutateRow(String tableName) + *
                                                                                                                                                  • mutateRow(TableName tableName, ByteString rowKey, List mutations) + *
                                                                                                                                                  • mutateRow(String tableName, ByteString rowKey, List mutations) + *
                                                                                                                                                  • mutateRow(TableName tableName, ByteString rowKey, List mutations, String appProfileId) + *
                                                                                                                                                  • mutateRow(String tableName, ByteString rowKey, List mutations, String appProfileId) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -147,10 +147,10 @@ *
                                                                                                                                                  *

                                                                                                                                                  "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                  *
                                                                                                                                                    - *
                                                                                                                                                  • checkAndMutateRow(TableName tableName) - *
                                                                                                                                                  • checkAndMutateRow(String tableName) - *
                                                                                                                                                  • checkAndMutateRow(TableName tableName) - *
                                                                                                                                                  • checkAndMutateRow(String tableName) + *
                                                                                                                                                  • checkAndMutateRow(TableName tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations) + *
                                                                                                                                                  • checkAndMutateRow(String tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations) + *
                                                                                                                                                  • checkAndMutateRow(TableName tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations, String appProfileId) + *
                                                                                                                                                  • checkAndMutateRow(String tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations, String appProfileId) *
                                                                                                                                                  *

                                                                                                                                                  Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                  *
                                                                                                                                                    @@ -171,8 +171,8 @@ *
                                                                                                                                                      *
                                                                                                                                                    • pingAndWarm(InstanceName name) *
                                                                                                                                                    • pingAndWarm(String name) - *
                                                                                                                                                    • pingAndWarm(InstanceName name) - *
                                                                                                                                                    • pingAndWarm(String name) + *
                                                                                                                                                    • pingAndWarm(InstanceName name, String appProfileId) + *
                                                                                                                                                    • pingAndWarm(String name, String appProfileId) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -194,10 +194,10 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • readModifyWriteRow(TableName tableName) - *
                                                                                                                                                    • readModifyWriteRow(String tableName) - *
                                                                                                                                                    • readModifyWriteRow(TableName tableName) - *
                                                                                                                                                    • readModifyWriteRow(String tableName) + *
                                                                                                                                                    • readModifyWriteRow(TableName tableName, ByteString rowKey, List rules) + *
                                                                                                                                                    • readModifyWriteRow(String tableName, ByteString rowKey, List rules) + *
                                                                                                                                                    • readModifyWriteRow(TableName tableName, ByteString rowKey, List rules, String appProfileId) + *
                                                                                                                                                    • readModifyWriteRow(String tableName, ByteString rowKey, List rules, String appProfileId) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index d267add264..20e59e9a0e 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -97,7 +97,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • deleteAsync(String project) + *
                                                                                                                                                    • deleteAsync(String project, String region, String address) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -116,7 +116,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • insertAsync(String project) + *
                                                                                                                                                    • insertAsync(String project, String region, Address addressResource) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -135,7 +135,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • list(String project) + *
                                                                                                                                                    • list(String project, String region, String orderBy) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java index f5d01dc4b1..5875d0f243 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java @@ -64,7 +64,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • get(String project) + *
                                                                                                                                                    • get(String project, String region, String operation) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -86,7 +86,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • wait(String project) + *
                                                                                                                                                    • wait(String project, String region, String operation) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java index 76cc3f705d..7275a3501f 100644 --- a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java +++ b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java @@ -75,8 +75,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • generateAccessToken(ServiceAccountName name) - *
                                                                                                                                                    • generateAccessToken(String name) + *
                                                                                                                                                    • generateAccessToken(ServiceAccountName name, List delegates, List scope, Duration lifetime) + *
                                                                                                                                                    • generateAccessToken(String name, List delegates, List scope, Duration lifetime) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -94,8 +94,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • generateIdToken(ServiceAccountName name) - *
                                                                                                                                                    • generateIdToken(String name) + *
                                                                                                                                                    • generateIdToken(ServiceAccountName name, List delegates, String audience, includeEmail) + *
                                                                                                                                                    • generateIdToken(String name, List delegates, String audience, includeEmail) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -113,8 +113,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • signBlob(ServiceAccountName name) - *
                                                                                                                                                    • signBlob(String name) + *
                                                                                                                                                    • signBlob(ServiceAccountName name, List delegates, ByteString payload) + *
                                                                                                                                                    • signBlob(String name, List delegates, ByteString payload) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -132,8 +132,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • signJwt(ServiceAccountName name) - *
                                                                                                                                                    • signJwt(String name) + *
                                                                                                                                                    • signJwt(ServiceAccountName name, List delegates, String payload) + *
                                                                                                                                                    • signJwt(String name, List delegates, String payload) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index 400c8966d9..9667843cb4 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -279,8 +279,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createKeyRing(LocationName parent) - *
                                                                                                                                                    • createKeyRing(String parent) + *
                                                                                                                                                    • createKeyRing(LocationName parent, String keyRingId, KeyRing keyRing) + *
                                                                                                                                                    • createKeyRing(String parent, String keyRingId, KeyRing keyRing) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -303,8 +303,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createCryptoKey(KeyRingName parent) - *
                                                                                                                                                    • createCryptoKey(String parent) + *
                                                                                                                                                    • createCryptoKey(KeyRingName parent, String cryptoKeyId, CryptoKey cryptoKey) + *
                                                                                                                                                    • createCryptoKey(String parent, String cryptoKeyId, CryptoKey cryptoKey) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -327,8 +327,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createCryptoKeyVersion(CryptoKeyName parent) - *
                                                                                                                                                    • createCryptoKeyVersion(String parent) + *
                                                                                                                                                    • createCryptoKeyVersion(CryptoKeyName parent, CryptoKeyVersion cryptoKeyVersion) + *
                                                                                                                                                    • createCryptoKeyVersion(String parent, CryptoKeyVersion cryptoKeyVersion) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -369,8 +369,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createImportJob(KeyRingName parent) - *
                                                                                                                                                    • createImportJob(String parent) + *
                                                                                                                                                    • createImportJob(KeyRingName parent, String importJobId, ImportJob importJob) + *
                                                                                                                                                    • createImportJob(String parent, String importJobId, ImportJob importJob) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -388,7 +388,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateCryptoKey(CryptoKey cryptoKey) + *
                                                                                                                                                    • updateCryptoKey(CryptoKey cryptoKey, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -417,7 +417,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion) + *
                                                                                                                                                    • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -438,8 +438,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • encrypt(ResourceName name) - *
                                                                                                                                                    • encrypt(String name) + *
                                                                                                                                                    • encrypt(ResourceName name, ByteString plaintext) + *
                                                                                                                                                    • encrypt(String name, ByteString plaintext) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -460,8 +460,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • decrypt(CryptoKeyName name) - *
                                                                                                                                                    • decrypt(String name) + *
                                                                                                                                                    • decrypt(CryptoKeyName name, ByteString ciphertext) + *
                                                                                                                                                    • decrypt(String name, ByteString ciphertext) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -483,8 +483,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • asymmetricSign(CryptoKeyVersionName name) - *
                                                                                                                                                    • asymmetricSign(String name) + *
                                                                                                                                                    • asymmetricSign(CryptoKeyVersionName name, Digest digest) + *
                                                                                                                                                    • asymmetricSign(String name, Digest digest) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -506,8 +506,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • asymmetricDecrypt(CryptoKeyVersionName name) - *
                                                                                                                                                    • asymmetricDecrypt(String name) + *
                                                                                                                                                    • asymmetricDecrypt(CryptoKeyVersionName name, ByteString ciphertext) + *
                                                                                                                                                    • asymmetricDecrypt(String name, ByteString ciphertext) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -529,8 +529,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateCryptoKeyPrimaryVersion(CryptoKeyName name) - *
                                                                                                                                                    • updateCryptoKeyPrimaryVersion(String name) + *
                                                                                                                                                    • updateCryptoKeyPrimaryVersion(CryptoKeyName name, String cryptoKeyVersionId) + *
                                                                                                                                                    • updateCryptoKeyPrimaryVersion(String name, String cryptoKeyVersionId) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index 9f98ed17c0..4e0b80cc95 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -173,10 +173,10 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • mergeShelves(ShelfName name) - *
                                                                                                                                                    • mergeShelves(ShelfName name) - *
                                                                                                                                                    • mergeShelves(String name) - *
                                                                                                                                                    • mergeShelves(String name) + *
                                                                                                                                                    • mergeShelves(ShelfName name, ShelfName otherShelf) + *
                                                                                                                                                    • mergeShelves(ShelfName name, String otherShelf) + *
                                                                                                                                                    • mergeShelves(String name, ShelfName otherShelf) + *
                                                                                                                                                    • mergeShelves(String name, String otherShelf) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -194,8 +194,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createBook(ShelfName parent) - *
                                                                                                                                                    • createBook(String parent) + *
                                                                                                                                                    • createBook(ShelfName parent, Book book) + *
                                                                                                                                                    • createBook(String parent, Book book) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -274,7 +274,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateBook(Book book) + *
                                                                                                                                                    • updateBook(Book book, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -293,10 +293,10 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • moveBook(BookName name) - *
                                                                                                                                                    • moveBook(BookName name) - *
                                                                                                                                                    • moveBook(String name) - *
                                                                                                                                                    • moveBook(String name) + *
                                                                                                                                                    • moveBook(BookName name, ShelfName otherShelfName) + *
                                                                                                                                                    • moveBook(BookName name, String otherShelfName) + *
                                                                                                                                                    • moveBook(String name, ShelfName otherShelfName) + *
                                                                                                                                                    • moveBook(String name, String otherShelfName) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index 93534ed7c3..f4538279ff 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -365,11 +365,11 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createSink(BillingAccountName parent) - *
                                                                                                                                                    • createSink(FolderName parent) - *
                                                                                                                                                    • createSink(OrganizationName parent) - *
                                                                                                                                                    • createSink(ProjectName parent) - *
                                                                                                                                                    • createSink(String parent) + *
                                                                                                                                                    • createSink(BillingAccountName parent, LogSink sink) + *
                                                                                                                                                    • createSink(FolderName parent, LogSink sink) + *
                                                                                                                                                    • createSink(OrganizationName parent, LogSink sink) + *
                                                                                                                                                    • createSink(ProjectName parent, LogSink sink) + *
                                                                                                                                                    • createSink(String parent, LogSink sink) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -391,10 +391,10 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateSink(LogSinkName sinkName) - *
                                                                                                                                                    • updateSink(String sinkName) - *
                                                                                                                                                    • updateSink(LogSinkName sinkName) - *
                                                                                                                                                    • updateSink(String sinkName) + *
                                                                                                                                                    • updateSink(LogSinkName sinkName, LogSink sink) + *
                                                                                                                                                    • updateSink(String sinkName, LogSink sink) + *
                                                                                                                                                    • updateSink(LogSinkName sinkName, LogSink sink, FieldMask updateMask) + *
                                                                                                                                                    • updateSink(String sinkName, LogSink sink, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -476,11 +476,11 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createExclusion(BillingAccountName parent) - *
                                                                                                                                                    • createExclusion(FolderName parent) - *
                                                                                                                                                    • createExclusion(OrganizationName parent) - *
                                                                                                                                                    • createExclusion(ProjectName parent) - *
                                                                                                                                                    • createExclusion(String parent) + *
                                                                                                                                                    • createExclusion(BillingAccountName parent, LogExclusion exclusion) + *
                                                                                                                                                    • createExclusion(FolderName parent, LogExclusion exclusion) + *
                                                                                                                                                    • createExclusion(OrganizationName parent, LogExclusion exclusion) + *
                                                                                                                                                    • createExclusion(ProjectName parent, LogExclusion exclusion) + *
                                                                                                                                                    • createExclusion(String parent, LogExclusion exclusion) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -499,8 +499,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateExclusion(LogExclusionName name) - *
                                                                                                                                                    • updateExclusion(String name) + *
                                                                                                                                                    • updateExclusion(LogExclusionName name, LogExclusion exclusion, FieldMask updateMask) + *
                                                                                                                                                    • updateExclusion(String name, LogExclusion exclusion, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -631,7 +631,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateSettings(Settings settings) + *
                                                                                                                                                    • updateSettings(Settings settings, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index aae564a54d..ce6e5be9e6 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -119,8 +119,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • writeLogEntries(LogName logName) - *
                                                                                                                                                    • writeLogEntries(String logName) + *
                                                                                                                                                    • writeLogEntries(LogName logName, MonitoredResource resource, Map labels, List entries) + *
                                                                                                                                                    • writeLogEntries(String logName, MonitoredResource resource, Map labels, List entries) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -141,7 +141,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • listLogEntries(List resourceNames) + *
                                                                                                                                                    • listLogEntries(List resourceNames, String filter, String orderBy) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index fa1a977f41..afa0852655 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -118,8 +118,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createLogMetric(ProjectName parent) - *
                                                                                                                                                    • createLogMetric(String parent) + *
                                                                                                                                                    • createLogMetric(ProjectName parent, LogMetric metric) + *
                                                                                                                                                    • createLogMetric(String parent, LogMetric metric) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -137,8 +137,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateLogMetric(LogMetricName metricName) - *
                                                                                                                                                    • updateLogMetric(String metricName) + *
                                                                                                                                                    • updateLogMetric(LogMetricName metricName, LogMetric metric) + *
                                                                                                                                                    • updateLogMetric(String metricName, LogMetric metric) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index 5124c42d4c..04a97ca302 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -94,8 +94,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createSchema(ProjectName parent) - *
                                                                                                                                                    • createSchema(String parent) + *
                                                                                                                                                    • createSchema(ProjectName parent, Schema schema, String schemaId) + *
                                                                                                                                                    • createSchema(String parent, Schema schema, String schemaId) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -172,8 +172,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • commitSchema(SchemaName name) - *
                                                                                                                                                    • commitSchema(String name) + *
                                                                                                                                                    • commitSchema(SchemaName name, Schema schema) + *
                                                                                                                                                    • commitSchema(String name, Schema schema) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -191,8 +191,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • rollbackSchema(SchemaName name) - *
                                                                                                                                                    • rollbackSchema(String name) + *
                                                                                                                                                    • rollbackSchema(SchemaName name, String revisionId) + *
                                                                                                                                                    • rollbackSchema(String name, String revisionId) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -210,8 +210,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • deleteSchemaRevision(SchemaName name) - *
                                                                                                                                                    • deleteSchemaRevision(String name) + *
                                                                                                                                                    • deleteSchemaRevision(SchemaName name, String revisionId) + *
                                                                                                                                                    • deleteSchemaRevision(String name, String revisionId) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -248,8 +248,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • validateSchema(ProjectName parent) - *
                                                                                                                                                    • validateSchema(String parent) + *
                                                                                                                                                    • validateSchema(ProjectName parent, Schema schema) + *
                                                                                                                                                    • validateSchema(String parent, Schema schema) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 2f53b48dc3..7253bdc237 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -120,10 +120,10 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createSubscription(SubscriptionName name) - *
                                                                                                                                                    • createSubscription(SubscriptionName name) - *
                                                                                                                                                    • createSubscription(String name) - *
                                                                                                                                                    • createSubscription(String name) + *
                                                                                                                                                    • createSubscription(SubscriptionName name, TopicName topic, PushConfig pushConfig, ackDeadlineSeconds) + *
                                                                                                                                                    • createSubscription(SubscriptionName name, String topic, PushConfig pushConfig, ackDeadlineSeconds) + *
                                                                                                                                                    • createSubscription(String name, TopicName topic, PushConfig pushConfig, ackDeadlineSeconds) + *
                                                                                                                                                    • createSubscription(String name, String topic, PushConfig pushConfig, ackDeadlineSeconds) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -222,8 +222,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • modifyAckDeadline(SubscriptionName subscription) - *
                                                                                                                                                    • modifyAckDeadline(String subscription) + *
                                                                                                                                                    • modifyAckDeadline(SubscriptionName subscription, List ackIds, ackDeadlineSeconds) + *
                                                                                                                                                    • modifyAckDeadline(String subscription, List ackIds, ackDeadlineSeconds) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -247,8 +247,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • acknowledge(SubscriptionName subscription) - *
                                                                                                                                                    • acknowledge(String subscription) + *
                                                                                                                                                    • acknowledge(SubscriptionName subscription, List ackIds) + *
                                                                                                                                                    • acknowledge(String subscription, List ackIds) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -268,10 +268,10 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • pull(SubscriptionName subscription) - *
                                                                                                                                                    • pull(String subscription) - *
                                                                                                                                                    • pull(SubscriptionName subscription) - *
                                                                                                                                                    • pull(String subscription) + *
                                                                                                                                                    • pull(SubscriptionName subscription, maxMessages) + *
                                                                                                                                                    • pull(String subscription, maxMessages) + *
                                                                                                                                                    • pull(SubscriptionName subscription, returnImmediately, maxMessages) + *
                                                                                                                                                    • pull(String subscription, returnImmediately, maxMessages) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -310,8 +310,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • modifyPushConfig(SubscriptionName subscription) - *
                                                                                                                                                    • modifyPushConfig(String subscription) + *
                                                                                                                                                    • modifyPushConfig(SubscriptionName subscription, PushConfig pushConfig) + *
                                                                                                                                                    • modifyPushConfig(String subscription, PushConfig pushConfig) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -391,10 +391,10 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createSnapshot(SnapshotName name) - *
                                                                                                                                                    • createSnapshot(SnapshotName name) - *
                                                                                                                                                    • createSnapshot(String name) - *
                                                                                                                                                    • createSnapshot(String name) + *
                                                                                                                                                    • createSnapshot(SnapshotName name, SubscriptionName subscription) + *
                                                                                                                                                    • createSnapshot(SnapshotName name, String subscription) + *
                                                                                                                                                    • createSnapshot(String name, SubscriptionName subscription) + *
                                                                                                                                                    • createSnapshot(String name, String subscription) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index eefab82ea7..26e70821b1 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -129,8 +129,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • publish(TopicName topic) - *
                                                                                                                                                    • publish(String topic) + *
                                                                                                                                                    • publish(TopicName topic, List messages) + *
                                                                                                                                                    • publish(String topic, List messages) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index ea48e84e48..737a0c56cf 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -176,8 +176,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createInstanceAsync(LocationName parent) - *
                                                                                                                                                    • createInstanceAsync(String parent) + *
                                                                                                                                                    • createInstanceAsync(LocationName parent, String instanceId, Instance instance) + *
                                                                                                                                                    • createInstanceAsync(String parent, String instanceId, Instance instance) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -200,7 +200,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateInstanceAsync(FieldMask updateMask) + *
                                                                                                                                                    • updateInstanceAsync(FieldMask updateMask, Instance instance) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -220,8 +220,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • upgradeInstanceAsync(InstanceName name) - *
                                                                                                                                                    • upgradeInstanceAsync(String name) + *
                                                                                                                                                    • upgradeInstanceAsync(InstanceName name, String redisVersion) + *
                                                                                                                                                    • upgradeInstanceAsync(String name, String redisVersion) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -247,7 +247,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • importInstanceAsync(String name) + *
                                                                                                                                                    • importInstanceAsync(String name, InputConfig inputConfig) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -271,7 +271,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • exportInstanceAsync(String name) + *
                                                                                                                                                    • exportInstanceAsync(String name, OutputConfig outputConfig) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -291,8 +291,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • failoverInstanceAsync(InstanceName name) - *
                                                                                                                                                    • failoverInstanceAsync(String name) + *
                                                                                                                                                    • failoverInstanceAsync(InstanceName name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) + *
                                                                                                                                                    • failoverInstanceAsync(String name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -333,8 +333,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • rescheduleMaintenanceAsync(InstanceName name) - *
                                                                                                                                                    • rescheduleMaintenanceAsync(String name) + *
                                                                                                                                                    • rescheduleMaintenanceAsync(InstanceName name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) + *
                                                                                                                                                    • rescheduleMaintenanceAsync(String name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index 18b61816db..790ddf7b33 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -131,8 +131,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createBucket(ProjectName parent) - *
                                                                                                                                                    • createBucket(String parent) + *
                                                                                                                                                    • createBucket(ProjectName parent, Bucket bucket, String bucketId) + *
                                                                                                                                                    • createBucket(String parent, Bucket bucket, String bucketId) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -214,8 +214,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • setIamPolicy(ResourceName resource) - *
                                                                                                                                                    • setIamPolicy(String resource) + *
                                                                                                                                                    • setIamPolicy(ResourceName resource, Policy policy) + *
                                                                                                                                                    • setIamPolicy(String resource, Policy policy) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -237,8 +237,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • testIamPermissions(ResourceName resource) - *
                                                                                                                                                    • testIamPermissions(String resource) + *
                                                                                                                                                    • testIamPermissions(ResourceName resource, List permissions) + *
                                                                                                                                                    • testIamPermissions(String resource, List permissions) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -256,7 +256,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateBucket(Bucket bucket) + *
                                                                                                                                                    • updateBucket(Bucket bucket, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -315,8 +315,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createNotification(ProjectName parent) - *
                                                                                                                                                    • createNotification(String parent) + *
                                                                                                                                                    • createNotification(ProjectName parent, Notification notification) + *
                                                                                                                                                    • createNotification(String parent, Notification notification) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -370,8 +370,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • deleteObject(String bucket) - *
                                                                                                                                                    • deleteObject(String bucket) + *
                                                                                                                                                    • deleteObject(String bucket, String object) + *
                                                                                                                                                    • deleteObject(String bucket, String object, generation) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -407,8 +407,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • getObject(String bucket) - *
                                                                                                                                                    • getObject(String bucket) + *
                                                                                                                                                    • getObject(String bucket, String object) + *
                                                                                                                                                    • getObject(String bucket, String object, generation) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -437,7 +437,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateObject(Object object) + *
                                                                                                                                                    • updateObject(Object object, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -616,8 +616,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • createHmacKey(ProjectName project) - *
                                                                                                                                                    • createHmacKey(String project) + *
                                                                                                                                                    • createHmacKey(ProjectName project, String serviceAccountEmail) + *
                                                                                                                                                    • createHmacKey(String project, String serviceAccountEmail) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -635,8 +635,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • deleteHmacKey(String accessId) - *
                                                                                                                                                    • deleteHmacKey(String accessId) + *
                                                                                                                                                    • deleteHmacKey(String accessId, ProjectName project) + *
                                                                                                                                                    • deleteHmacKey(String accessId, String project) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -654,8 +654,8 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • getHmacKey(String accessId) - *
                                                                                                                                                    • getHmacKey(String accessId) + *
                                                                                                                                                    • getHmacKey(String accessId, ProjectName project) + *
                                                                                                                                                    • getHmacKey(String accessId, String project) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      @@ -693,7 +693,7 @@ *
                                                                                                                                                    *

                                                                                                                                                    "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                    *
                                                                                                                                                      - *
                                                                                                                                                    • updateHmacKey(HmacKeyMetadata hmacKey) + *
                                                                                                                                                    • updateHmacKey(HmacKeyMetadata hmacKey, FieldMask updateMask) *
                                                                                                                                                    *

                                                                                                                                                    Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                    *
                                                                                                                                                      From 32486e6d1cdcf126671432ddf039c9ecbb0ece23 Mon Sep 17 00:00:00 2001 From: Alice Li Date: Tue, 14 Nov 2023 16:15:38 -0500 Subject: [PATCH 21/21] include primitive types and update indentation --- .../comment/ServiceClientCommentComposer.java | 12 +- .../AbstractServiceClientClassComposer.java | 6 +- ...cServiceClientWithNestedClassImport.golden | 7 +- .../grpc/goldens/BookshopClient.golden | 11 +- .../goldens/DeprecatedServiceClient.golden | 13 +- .../composer/grpc/goldens/EchoClient.golden | 81 +++--- .../grpc/goldens/IdentityClient.golden | 47 +-- .../grpc/goldens/MessagingClient.golden | 123 ++++---- .../grpcrest/goldens/EchoClient.golden | 93 +++--- .../grpcrest/goldens/EchoEmpty.golden | 1 + .../grpcrest/goldens/WickedClient.golden | 15 +- .../showcase/v1beta1/ComplianceClient.java | 93 +++--- .../google/showcase/v1beta1/EchoClient.java | 93 +++--- .../showcase/v1beta1/IdentityClient.java | 77 ++--- .../showcase/v1beta1/MessagingClient.java | 171 +++++------ .../v1beta1/SequenceServiceClient.java | 83 +++--- .../showcase/v1beta1/TestingClient.java | 85 +++--- .../v1/ConnectionServiceClient.java | 13 +- .../cloud/apigeeconnect/v1/TetherClient.java | 5 +- .../cloud/asset/v1/AssetServiceClient.java | 181 ++++++------ .../data/v2/BaseBigtableDataClient.java | 69 ++--- .../compute/v1small/AddressesClient.java | 41 +-- .../v1small/RegionOperationsClient.java | 17 +- .../credentials/v1/IamCredentialsClient.java | 41 +-- .../com/google/iam/v1/IAMPolicyClient.java | 19 +- .../kms/v1/KeyManagementServiceClient.java | 257 ++++++++-------- .../library/v1/LibraryServiceClient.java | 115 ++++---- .../google/cloud/logging/v2/ConfigClient.java | 253 ++++++++-------- .../cloud/logging/v2/LoggingClient.java | 61 ++-- .../cloud/logging/v2/MetricsClient.java | 53 ++-- .../cloud/pubsub/v1/SchemaServiceClient.java | 119 ++++---- .../pubsub/v1/SubscriptionAdminClient.java | 177 +++++------ .../cloud/pubsub/v1/TopicAdminClient.java | 107 +++---- .../cloud/redis/v1beta1/CloudRedisClient.java | 123 ++++---- .../com/google/storage/v2/StorageClient.java | 275 +++++++++--------- 35 files changed, 1489 insertions(+), 1448 deletions(-) diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java index dd15c3a019..49ed6e168e 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/comment/ServiceClientCommentComposer.java @@ -251,9 +251,9 @@ private static String createTableOfMethods(List methodAndVari tableBuilder, FLATTENED_METHODS, method.flattenedVariants); generateUnorderedListMethodVariants(tableBuilder, ASYNC_METHODS, method.asyncVariants); generateUnorderedListMethodVariants(tableBuilder, CALLABLE_METHODS, method.callableVariants); - tableBuilder.append(" \n").append(" \n"); + tableBuilder.append(" \n").append(" \n"); } - tableBuilder.append(" \n"); + tableBuilder.append(" \n").append(" \n"); return tableBuilder.toString(); } @@ -263,8 +263,8 @@ private static void generateUnorderedListMethodVariants( tableBuilder .append(" " + methodType + " ") .append("
                                                                                                                                                        \n") - .append("
                                                                                                                                                      • ") - .append(String.join("\n
                                                                                                                                                      • ", methodVariants)) + .append("
                                                                                                                                                      • ") + .append(String.join("\n
                                                                                                                                                      • ", methodVariants)) .append("\n") .append("
                                                                                                                                                      ") .append("\n"); @@ -273,6 +273,8 @@ private static void generateUnorderedListMethodVariants( private static class MethodAndVariants { private final String method; + // Description may be empty. It comes from the proto comments above the method. If it is empty, + // then nothing will be displayed. private final String description; private final List flattenedVariants; @@ -285,6 +287,8 @@ private MethodAndVariants(String method, String description, List method this.description = description; requestObjectVariants = methodVariants.stream().filter(s -> s.contains("request")).collect(toList()); + // Flattened method variants do not have a suffix, so the easiest way to identify them is by + // removing all other method variant types. methodVariants.removeAll(requestObjectVariants); callableVariants = methodVariants.stream().filter(s -> s.contains("Callable")).collect(toList()); diff --git a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java index 1cf314c1a4..987cd9adc8 100644 --- a/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java +++ b/gapic-generator-java/src/main/java/com/google/api/generator/gapic/composer/common/AbstractServiceClientClassComposer.java @@ -588,10 +588,14 @@ private static String getJavaMethod(MethodDefinition m) { List parameters = m.arguments().stream().map(VariableExpr::variable).collect(Collectors.toList()); + // If reference is empty, that means the parameter is a non-Object type. Therefore, use the + // typeKind directly. for (int i = 0; i < parameters.size(); i++) { Variable param = parameters.get(i); String paramType = - param.type().reference() != null ? param.type().reference().name() + " " : ""; + param.type().reference() != null + ? param.type().reference().name() + " " + : param.type().typeKind().name().toLowerCase() + " "; String paramName = param.identifier().name(); methodSignature.append(paramType).append(paramName); diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden index 14024c64e6..2d21bb2e1e 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/engine/writer/goldens/GrpcServiceClientWithNestedClassImport.golden @@ -42,13 +42,14 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • nestedMessageMethod(Outer.Middle request) + *
                                                                                                                                                      • nestedMessageMethod(Outer.Middle request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • nestedMessageMethodCallable() + *
                                                                                                                                                      • nestedMessageMethodCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden index 94d532d01a..48f0b53808 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/BookshopClient.golden @@ -42,18 +42,19 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBook(GetBookRequest request) + *
                                                                                                                                                      • getBook(GetBookRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBook(booksCount, List books) - *
                                                                                                                                                      • getBook(String booksList, List books) + *
                                                                                                                                                      • getBook(int booksCount, List books) + *
                                                                                                                                                      • getBook(String booksList, List books) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBookCallable() + *
                                                                                                                                                      • getBookCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden index d08ce8a307..12b3308b17 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/DeprecatedServiceClient.golden @@ -41,13 +41,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • fastFibonacci(FibonacciRequest request) + *
                                                                                                                                                      • fastFibonacci(FibonacciRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • fastFibonacciCallable() + *
                                                                                                                                                      • fastFibonacciCallable() *
                                                                                                                                                      - * + * * * * SlowFibonacci @@ -55,13 +55,14 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • slowFibonacci(FibonacciRequest request) + *
                                                                                                                                                      • slowFibonacci(FibonacciRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • slowFibonacciCallable() + *
                                                                                                                                                      • slowFibonacciCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden index b4b324b1ee..8ba5cd0aa2 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/EchoClient.golden @@ -63,24 +63,24 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echo(EchoRequest request) + *
                                                                                                                                                      • echo(EchoRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echo() - *
                                                                                                                                                      • echo(ResourceName parent) - *
                                                                                                                                                      • echo(Status error) - *
                                                                                                                                                      • echo(FoobarName name) - *
                                                                                                                                                      • echo(String content) - *
                                                                                                                                                      • echo(String name) - *
                                                                                                                                                      • echo(String parent) - *
                                                                                                                                                      • echo(String content, Severity severity) + *
                                                                                                                                                      • echo() + *
                                                                                                                                                      • echo(ResourceName parent) + *
                                                                                                                                                      • echo(Status error) + *
                                                                                                                                                      • echo(FoobarName name) + *
                                                                                                                                                      • echo(String content) + *
                                                                                                                                                      • echo(String name) + *
                                                                                                                                                      • echo(String parent) + *
                                                                                                                                                      • echo(String content, Severity severity) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echoCallable() + *
                                                                                                                                                      • echoCallable() *
                                                                                                                                                      - * + * * * * Expand @@ -88,9 +88,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • expandCallable() + *
                                                                                                                                                      • expandCallable() *
                                                                                                                                                      - * + * * * * Collect @@ -98,9 +98,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • collectCallable() + *
                                                                                                                                                      • collectCallable() *
                                                                                                                                                      - * + * * * * Chat @@ -108,9 +108,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • chatCallable() + *
                                                                                                                                                      • chatCallable() *
                                                                                                                                                      - * + * * * * ChatAgain @@ -118,9 +118,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • chatAgainCallable() + *
                                                                                                                                                      • chatAgainCallable() *
                                                                                                                                                      - * + * * * * PagedExpand @@ -128,14 +128,14 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpand(PagedExpandRequest request) + *
                                                                                                                                                      • pagedExpand(PagedExpandRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpandPagedCallable() - *
                                                                                                                                                      • pagedExpandCallable() + *
                                                                                                                                                      • pagedExpandPagedCallable() + *
                                                                                                                                                      • pagedExpandCallable() *
                                                                                                                                                      - * + * * * * SimplePagedExpand @@ -143,18 +143,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • simplePagedExpand(PagedExpandRequest request) + *
                                                                                                                                                      • simplePagedExpand(PagedExpandRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • simplePagedExpand() + *
                                                                                                                                                      • simplePagedExpand() *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • simplePagedExpandPagedCallable() - *
                                                                                                                                                      • simplePagedExpandCallable() + *
                                                                                                                                                      • simplePagedExpandPagedCallable() + *
                                                                                                                                                      • simplePagedExpandCallable() *
                                                                                                                                                      - * + * * * * Wait @@ -162,19 +162,19 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitAsync(WaitRequest request) + *
                                                                                                                                                      • waitAsync(WaitRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitAsync(Duration ttl) - *
                                                                                                                                                      • waitAsync(Timestamp endTime) + *
                                                                                                                                                      • waitAsync(Duration ttl) + *
                                                                                                                                                      • waitAsync(Timestamp endTime) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitOperationCallable() - *
                                                                                                                                                      • waitCallable() + *
                                                                                                                                                      • waitOperationCallable() + *
                                                                                                                                                      • waitCallable() *
                                                                                                                                                      - * + * * * * Block @@ -182,13 +182,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • block(BlockRequest request) + *
                                                                                                                                                      • block(BlockRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • blockCallable() + *
                                                                                                                                                      • blockCallable() *
                                                                                                                                                      - * + * * * * CollideName @@ -196,13 +196,14 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • collideName(EchoRequest request) + *
                                                                                                                                                      • collideName(EchoRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • collideNameCallable() + *
                                                                                                                                                      • collideNameCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden index b2fa5b1062..0a21abc7da 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/IdentityClient.golden @@ -51,19 +51,19 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createUser(CreateUserRequest request) + *
                                                                                                                                                      • createUser(CreateUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createUser(String parent, String displayName, String email) - *
                                                                                                                                                      • createUser(String parent, String displayName, String email, age, String nickname, enableNotifications, heightFeet) - *
                                                                                                                                                      • createUser(String parent, String displayName, String email, String hobbyName, String songName, weeklyFrequency, String companyName, String title, String subject, String artistName) + *
                                                                                                                                                      • createUser(String parent, String displayName, String email) + *
                                                                                                                                                      • createUser(String parent, String displayName, String email, int age, String nickname, boolean enableNotifications, double heightFeet) + *
                                                                                                                                                      • createUser(String parent, String displayName, String email, String hobbyName, String songName, int weeklyFrequency, String companyName, String title, String subject, String artistName) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createUserCallable() + *
                                                                                                                                                      • createUserCallable() *
                                                                                                                                                      - * + * * * * GetUser @@ -71,18 +71,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getUser(GetUserRequest request) + *
                                                                                                                                                      • getUser(GetUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getUser(UserName name) - *
                                                                                                                                                      • getUser(String name) + *
                                                                                                                                                      • getUser(UserName name) + *
                                                                                                                                                      • getUser(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getUserCallable() + *
                                                                                                                                                      • getUserCallable() *
                                                                                                                                                      - * + * * * * UpdateUser @@ -90,13 +90,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateUser(UpdateUserRequest request) + *
                                                                                                                                                      • updateUser(UpdateUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateUserCallable() + *
                                                                                                                                                      • updateUserCallable() *
                                                                                                                                                      - * + * * * * DeleteUser @@ -104,18 +104,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteUser(DeleteUserRequest request) + *
                                                                                                                                                      • deleteUser(DeleteUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteUser(UserName name) - *
                                                                                                                                                      • deleteUser(String name) + *
                                                                                                                                                      • deleteUser(UserName name) + *
                                                                                                                                                      • deleteUser(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteUserCallable() + *
                                                                                                                                                      • deleteUserCallable() *
                                                                                                                                                      - * + * * * * ListUsers @@ -123,14 +123,15 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listUsers(ListUsersRequest request) + *
                                                                                                                                                      • listUsers(ListUsersRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listUsersPagedCallable() - *
                                                                                                                                                      • listUsersCallable() + *
                                                                                                                                                      • listUsersPagedCallable() + *
                                                                                                                                                      • listUsersCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden index daf7764625..5635b8ea96 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpc/goldens/MessagingClient.golden @@ -58,17 +58,17 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createRoom(CreateRoomRequest request) + *
                                                                                                                                                      • createRoom(CreateRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createRoom(String displayName, String description) + *
                                                                                                                                                      • createRoom(String displayName, String description) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createRoomCallable() + *
                                                                                                                                                      • createRoomCallable() *
                                                                                                                                                      - * + * * * * GetRoom @@ -76,18 +76,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getRoom(GetRoomRequest request) + *
                                                                                                                                                      • getRoom(GetRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getRoom(RoomName name) - *
                                                                                                                                                      • getRoom(String name) + *
                                                                                                                                                      • getRoom(RoomName name) + *
                                                                                                                                                      • getRoom(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getRoomCallable() + *
                                                                                                                                                      • getRoomCallable() *
                                                                                                                                                      - * + * * * * UpdateRoom @@ -95,13 +95,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateRoom(UpdateRoomRequest request) + *
                                                                                                                                                      • updateRoom(UpdateRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateRoomCallable() + *
                                                                                                                                                      • updateRoomCallable() *
                                                                                                                                                      - * + * * * * DeleteRoom @@ -109,18 +109,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteRoom(DeleteRoomRequest request) + *
                                                                                                                                                      • deleteRoom(DeleteRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteRoom(RoomName name) - *
                                                                                                                                                      • deleteRoom(String name) + *
                                                                                                                                                      • deleteRoom(RoomName name) + *
                                                                                                                                                      • deleteRoom(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteRoomCallable() + *
                                                                                                                                                      • deleteRoomCallable() *
                                                                                                                                                      - * + * * * * ListRooms @@ -128,14 +128,14 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listRooms(ListRoomsRequest request) + *
                                                                                                                                                      • listRooms(ListRoomsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listRoomsPagedCallable() - *
                                                                                                                                                      • listRoomsCallable() + *
                                                                                                                                                      • listRoomsPagedCallable() + *
                                                                                                                                                      • listRoomsCallable() *
                                                                                                                                                      - * + * * * * CreateBlurb @@ -143,22 +143,22 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBlurb(CreateBlurbRequest request) + *
                                                                                                                                                      • createBlurb(CreateBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBlurb(ProfileName parent, ByteString image) - *
                                                                                                                                                      • createBlurb(ProfileName parent, String text) - *
                                                                                                                                                      • createBlurb(RoomName parent, ByteString image) - *
                                                                                                                                                      • createBlurb(RoomName parent, String text) - *
                                                                                                                                                      • createBlurb(String parent, ByteString image) - *
                                                                                                                                                      • createBlurb(String parent, String text) + *
                                                                                                                                                      • createBlurb(ProfileName parent, ByteString image) + *
                                                                                                                                                      • createBlurb(ProfileName parent, String text) + *
                                                                                                                                                      • createBlurb(RoomName parent, ByteString image) + *
                                                                                                                                                      • createBlurb(RoomName parent, String text) + *
                                                                                                                                                      • createBlurb(String parent, ByteString image) + *
                                                                                                                                                      • createBlurb(String parent, String text) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBlurbCallable() + *
                                                                                                                                                      • createBlurbCallable() *
                                                                                                                                                      - * + * * * * GetBlurb @@ -166,18 +166,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBlurb(GetBlurbRequest request) + *
                                                                                                                                                      • getBlurb(GetBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBlurb(BlurbName name) - *
                                                                                                                                                      • getBlurb(String name) + *
                                                                                                                                                      • getBlurb(BlurbName name) + *
                                                                                                                                                      • getBlurb(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBlurbCallable() + *
                                                                                                                                                      • getBlurbCallable() *
                                                                                                                                                      - * + * * * * UpdateBlurb @@ -185,13 +185,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBlurb(UpdateBlurbRequest request) + *
                                                                                                                                                      • updateBlurb(UpdateBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBlurbCallable() + *
                                                                                                                                                      • updateBlurbCallable() *
                                                                                                                                                      - * + * * * * DeleteBlurb @@ -199,18 +199,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBlurb(DeleteBlurbRequest request) + *
                                                                                                                                                      • deleteBlurb(DeleteBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBlurb(BlurbName name) - *
                                                                                                                                                      • deleteBlurb(String name) + *
                                                                                                                                                      • deleteBlurb(BlurbName name) + *
                                                                                                                                                      • deleteBlurb(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBlurbCallable() + *
                                                                                                                                                      • deleteBlurbCallable() *
                                                                                                                                                      - * + * * * * ListBlurbs @@ -218,20 +218,20 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBlurbs(ListBlurbsRequest request) + *
                                                                                                                                                      • listBlurbs(ListBlurbsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBlurbs(ProfileName parent) - *
                                                                                                                                                      • listBlurbs(RoomName parent) - *
                                                                                                                                                      • listBlurbs(String parent) + *
                                                                                                                                                      • listBlurbs(ProfileName parent) + *
                                                                                                                                                      • listBlurbs(RoomName parent) + *
                                                                                                                                                      • listBlurbs(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBlurbsPagedCallable() - *
                                                                                                                                                      • listBlurbsCallable() + *
                                                                                                                                                      • listBlurbsPagedCallable() + *
                                                                                                                                                      • listBlurbsCallable() *
                                                                                                                                                      - * + * * * * SearchBlurbs @@ -239,18 +239,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchBlurbsAsync(SearchBlurbsRequest request) + *
                                                                                                                                                      • searchBlurbsAsync(SearchBlurbsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchBlurbsAsync(String query) + *
                                                                                                                                                      • searchBlurbsAsync(String query) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchBlurbsOperationCallable() - *
                                                                                                                                                      • searchBlurbsCallable() + *
                                                                                                                                                      • searchBlurbsOperationCallable() + *
                                                                                                                                                      • searchBlurbsCallable() *
                                                                                                                                                      - * + * * * * StreamBlurbs @@ -258,9 +258,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • streamBlurbsCallable() + *
                                                                                                                                                      • streamBlurbsCallable() *
                                                                                                                                                      - * + * * * * SendBlurbs @@ -268,9 +268,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • sendBlurbsCallable() + *
                                                                                                                                                      • sendBlurbsCallable() *
                                                                                                                                                      - * + * * * * Connect @@ -278,9 +278,10 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • connectCallable() + *
                                                                                                                                                      • connectCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden index 38efab79da..35f4eaf45b 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoClient.golden @@ -58,24 +58,24 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echo(EchoRequest request) + *
                                                                                                                                                      • echo(EchoRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echo() - *
                                                                                                                                                      • echo(ResourceName parent) - *
                                                                                                                                                      • echo(Status error) - *
                                                                                                                                                      • echo(FoobarName name) - *
                                                                                                                                                      • echo(String content) - *
                                                                                                                                                      • echo(String name) - *
                                                                                                                                                      • echo(String parent) - *
                                                                                                                                                      • echo(String content, Severity severity) + *
                                                                                                                                                      • echo() + *
                                                                                                                                                      • echo(ResourceName parent) + *
                                                                                                                                                      • echo(Status error) + *
                                                                                                                                                      • echo(FoobarName name) + *
                                                                                                                                                      • echo(String content) + *
                                                                                                                                                      • echo(String name) + *
                                                                                                                                                      • echo(String parent) + *
                                                                                                                                                      • echo(String content, Severity severity) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echoCallable() + *
                                                                                                                                                      • echoCallable() *
                                                                                                                                                      - * + * * * * Expand @@ -83,9 +83,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • expandCallable() + *
                                                                                                                                                      • expandCallable() *
                                                                                                                                                      - * + * * * * PagedExpand @@ -93,14 +93,14 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpand(PagedExpandRequest request) + *
                                                                                                                                                      • pagedExpand(PagedExpandRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpandPagedCallable() - *
                                                                                                                                                      • pagedExpandCallable() + *
                                                                                                                                                      • pagedExpandPagedCallable() + *
                                                                                                                                                      • pagedExpandCallable() *
                                                                                                                                                      - * + * * * * SimplePagedExpand @@ -108,18 +108,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • simplePagedExpand(PagedExpandRequest request) + *
                                                                                                                                                      • simplePagedExpand(PagedExpandRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • simplePagedExpand() + *
                                                                                                                                                      • simplePagedExpand() *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • simplePagedExpandPagedCallable() - *
                                                                                                                                                      • simplePagedExpandCallable() + *
                                                                                                                                                      • simplePagedExpandPagedCallable() + *
                                                                                                                                                      • simplePagedExpandCallable() *
                                                                                                                                                      - * + * * * * Wait @@ -127,19 +127,19 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitAsync(WaitRequest request) + *
                                                                                                                                                      • waitAsync(WaitRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitAsync(Duration ttl) - *
                                                                                                                                                      • waitAsync(Timestamp endTime) + *
                                                                                                                                                      • waitAsync(Duration ttl) + *
                                                                                                                                                      • waitAsync(Timestamp endTime) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitOperationCallable() - *
                                                                                                                                                      • waitCallable() + *
                                                                                                                                                      • waitOperationCallable() + *
                                                                                                                                                      • waitCallable() *
                                                                                                                                                      - * + * * * * Block @@ -147,13 +147,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • block(BlockRequest request) + *
                                                                                                                                                      • block(BlockRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • blockCallable() + *
                                                                                                                                                      • blockCallable() *
                                                                                                                                                      - * + * * * * CollideName @@ -161,13 +161,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • collideName(EchoRequest request) + *
                                                                                                                                                      • collideName(EchoRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • collideNameCallable() + *
                                                                                                                                                      • collideNameCallable() *
                                                                                                                                                      - * + * * * * NestedBinding @@ -175,13 +175,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • nestedBinding(EchoRequest request) + *
                                                                                                                                                      • nestedBinding(EchoRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • nestedBindingCallable() + *
                                                                                                                                                      • nestedBindingCallable() *
                                                                                                                                                      - * + * * * * Chat @@ -189,9 +189,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • chatCallable() + *
                                                                                                                                                      • chatCallable() *
                                                                                                                                                      - * + * * * * NoBinding @@ -199,13 +199,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • noBinding(EchoRequest request) + *
                                                                                                                                                      • noBinding(EchoRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • noBindingCallable() + *
                                                                                                                                                      • noBindingCallable() *
                                                                                                                                                      - * + * * * * UpdateCase @@ -213,17 +213,18 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCase(UpdateCaseRequest request) + *
                                                                                                                                                      • updateCase(UpdateCaseRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCase(Case case_, FieldMask updateMask) + *
                                                                                                                                                      • updateCase(Case case_, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCaseCallable() + *
                                                                                                                                                      • updateCaseCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden index dd0d881277..5076d1bee1 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/EchoEmpty.golden @@ -30,6 +30,7 @@ import javax.annotation.Generated; * Method * Description * Method Variants + * * * *

                                                                                                                                                      See the individual methods for example code. diff --git a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden index 738a146749..15f46c3f6a 100644 --- a/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden +++ b/gapic-generator-java/src/test/java/com/google/api/generator/gapic/composer/grpcrest/goldens/WickedClient.golden @@ -43,13 +43,13 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • craftEvilPlan(EvilRequest request) + *
                                                                                                                                                      • craftEvilPlan(EvilRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • craftEvilPlanCallable() + *
                                                                                                                                                      • craftEvilPlanCallable() *
                                                                                                                                                      - * + * * * * BrainstormEvilPlans @@ -57,9 +57,9 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • brainstormEvilPlansCallable() + *
                                                                                                                                                      • brainstormEvilPlansCallable() *
                                                                                                                                                      - * + * * * * PersuadeEvilPlan @@ -67,9 +67,10 @@ import javax.annotation.Generated; * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • persuadeEvilPlanCallable() + *
                                                                                                                                                      • persuadeEvilPlanCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java index abedf55175..b5b68a1383 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/ComplianceClient.java @@ -91,13 +91,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBody(RepeatRequest request) + *
                                                                                                                                                      • repeatDataBody(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBodyCallable() + *
                                                                                                                                                      • repeatDataBodyCallable() *
                                                                                                                                                      - * + * * * * RepeatDataBodyInfo @@ -107,13 +107,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBodyInfo(RepeatRequest request) + *
                                                                                                                                                      • repeatDataBodyInfo(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBodyInfoCallable() + *
                                                                                                                                                      • repeatDataBodyInfoCallable() *
                                                                                                                                                      - * + * * * * RepeatDataQuery @@ -122,13 +122,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataQuery(RepeatRequest request) + *
                                                                                                                                                      • repeatDataQuery(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataQueryCallable() + *
                                                                                                                                                      • repeatDataQueryCallable() *
                                                                                                                                                      - * + * * * * RepeatDataSimplePath @@ -138,13 +138,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataSimplePath(RepeatRequest request) + *
                                                                                                                                                      • repeatDataSimplePath(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataSimplePathCallable() + *
                                                                                                                                                      • repeatDataSimplePathCallable() *
                                                                                                                                                      - * + * * * * RepeatDataPathResource @@ -152,13 +152,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataPathResource(RepeatRequest request) + *
                                                                                                                                                      • repeatDataPathResource(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataPathResourceCallable() + *
                                                                                                                                                      • repeatDataPathResourceCallable() *
                                                                                                                                                      - * + * * * * RepeatDataPathTrailingResource @@ -166,13 +166,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataPathTrailingResource(RepeatRequest request) + *
                                                                                                                                                      • repeatDataPathTrailingResource(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataPathTrailingResourceCallable() + *
                                                                                                                                                      • repeatDataPathTrailingResourceCallable() *
                                                                                                                                                      - * + * * * * RepeatDataBodyPut @@ -180,13 +180,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBodyPut(RepeatRequest request) + *
                                                                                                                                                      • repeatDataBodyPut(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBodyPutCallable() + *
                                                                                                                                                      • repeatDataBodyPutCallable() *
                                                                                                                                                      - * + * * * * RepeatDataBodyPatch @@ -194,13 +194,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBodyPatch(RepeatRequest request) + *
                                                                                                                                                      • repeatDataBodyPatch(RepeatRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • repeatDataBodyPatchCallable() + *
                                                                                                                                                      • repeatDataBodyPatchCallable() *
                                                                                                                                                      - * + * * * * GetEnum @@ -213,13 +213,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getEnum(EnumRequest request) + *
                                                                                                                                                      • getEnum(EnumRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getEnumCallable() + *
                                                                                                                                                      • getEnumCallable() *
                                                                                                                                                      - * + * * * * VerifyEnum @@ -232,13 +232,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • verifyEnum(EnumResponse request) + *
                                                                                                                                                      • verifyEnum(EnumResponse request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • verifyEnumCallable() + *
                                                                                                                                                      • verifyEnumCallable() *
                                                                                                                                                      - * + * * * * ListLocations @@ -246,14 +246,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocations(ListLocationsRequest request) + *
                                                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocationsPagedCallable() - *
                                                                                                                                                      • listLocationsCallable() + *
                                                                                                                                                      • listLocationsPagedCallable() + *
                                                                                                                                                      • listLocationsCallable() *
                                                                                                                                                      - * + * * * * GetLocation @@ -261,13 +261,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocation(GetLocationRequest request) + *
                                                                                                                                                      • getLocation(GetLocationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocationCallable() + *
                                                                                                                                                      • getLocationCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -278,13 +278,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -294,13 +294,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -314,13 +314,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java index 7ccbf11d2e..fe9d0d186f 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/EchoClient.java @@ -93,13 +93,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echo(EchoRequest request) + *
                                                                                                                                                      • echo(EchoRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echoCallable() + *
                                                                                                                                                      • echoCallable() *
                                                                                                                                                      - * + * * * * EchoErrorDetails @@ -112,13 +112,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echoErrorDetails(EchoErrorDetailsRequest request) + *
                                                                                                                                                      • echoErrorDetails(EchoErrorDetailsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • echoErrorDetailsCallable() + *
                                                                                                                                                      • echoErrorDetailsCallable() *
                                                                                                                                                      - * + * * * * Expand @@ -127,9 +127,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • expandCallable() + *
                                                                                                                                                      • expandCallable() *
                                                                                                                                                      - * + * * * * Collect @@ -139,9 +139,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • collectCallable() + *
                                                                                                                                                      • collectCallable() *
                                                                                                                                                      - * + * * * * Chat @@ -151,9 +151,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • chatCallable() + *
                                                                                                                                                      • chatCallable() *
                                                                                                                                                      - * + * * * * PagedExpand @@ -162,14 +162,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpand(PagedExpandRequest request) + *
                                                                                                                                                      • pagedExpand(PagedExpandRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpandPagedCallable() - *
                                                                                                                                                      • pagedExpandCallable() + *
                                                                                                                                                      • pagedExpandPagedCallable() + *
                                                                                                                                                      • pagedExpandCallable() *
                                                                                                                                                      - * + * * * * PagedExpandLegacy @@ -179,13 +179,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpandLegacy(PagedExpandLegacyRequest request) + *
                                                                                                                                                      • pagedExpandLegacy(PagedExpandLegacyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpandLegacyCallable() + *
                                                                                                                                                      • pagedExpandLegacyCallable() *
                                                                                                                                                      - * + * * * * PagedExpandLegacyMapped @@ -197,14 +197,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpandLegacyMapped(PagedExpandRequest request) + *
                                                                                                                                                      • pagedExpandLegacyMapped(PagedExpandRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pagedExpandLegacyMappedPagedCallable() - *
                                                                                                                                                      • pagedExpandLegacyMappedCallable() + *
                                                                                                                                                      • pagedExpandLegacyMappedPagedCallable() + *
                                                                                                                                                      • pagedExpandLegacyMappedCallable() *
                                                                                                                                                      - * + * * * * Wait @@ -213,14 +213,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitAsync(WaitRequest request) + *
                                                                                                                                                      • waitAsync(WaitRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitOperationCallable() - *
                                                                                                                                                      • waitCallable() + *
                                                                                                                                                      • waitOperationCallable() + *
                                                                                                                                                      • waitCallable() *
                                                                                                                                                      - * + * * * * Block @@ -230,13 +230,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • block(BlockRequest request) + *
                                                                                                                                                      • block(BlockRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • blockCallable() + *
                                                                                                                                                      • blockCallable() *
                                                                                                                                                      - * + * * * * ListLocations @@ -244,14 +244,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocations(ListLocationsRequest request) + *
                                                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocationsPagedCallable() - *
                                                                                                                                                      • listLocationsCallable() + *
                                                                                                                                                      • listLocationsPagedCallable() + *
                                                                                                                                                      • listLocationsCallable() *
                                                                                                                                                      - * + * * * * GetLocation @@ -259,13 +259,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocation(GetLocationRequest request) + *
                                                                                                                                                      • getLocation(GetLocationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocationCallable() + *
                                                                                                                                                      • getLocationCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -276,13 +276,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -292,13 +292,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -312,13 +312,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java index cea8b7a53b..1f67d20e5b 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/IdentityClient.java @@ -77,18 +77,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createUser(CreateUserRequest request) + *
                                                                                                                                                      • createUser(CreateUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createUser(String displayName, String email) - *
                                                                                                                                                      • createUser(String displayName, String email, age, String nickname, enableNotifications, heightFeet) + *
                                                                                                                                                      • createUser(String displayName, String email) + *
                                                                                                                                                      • createUser(String displayName, String email, int age, String nickname, boolean enableNotifications, double heightFeet) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createUserCallable() + *
                                                                                                                                                      • createUserCallable() *
                                                                                                                                                      - * + * * * * GetUser @@ -96,18 +96,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getUser(GetUserRequest request) + *
                                                                                                                                                      • getUser(GetUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getUser(UserName name) - *
                                                                                                                                                      • getUser(String name) + *
                                                                                                                                                      • getUser(UserName name) + *
                                                                                                                                                      • getUser(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getUserCallable() + *
                                                                                                                                                      • getUserCallable() *
                                                                                                                                                      - * + * * * * UpdateUser @@ -115,13 +115,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateUser(UpdateUserRequest request) + *
                                                                                                                                                      • updateUser(UpdateUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateUserCallable() + *
                                                                                                                                                      • updateUserCallable() *
                                                                                                                                                      - * + * * * * DeleteUser @@ -129,18 +129,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteUser(DeleteUserRequest request) + *
                                                                                                                                                      • deleteUser(DeleteUserRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteUser(UserName name) - *
                                                                                                                                                      • deleteUser(String name) + *
                                                                                                                                                      • deleteUser(UserName name) + *
                                                                                                                                                      • deleteUser(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteUserCallable() + *
                                                                                                                                                      • deleteUserCallable() *
                                                                                                                                                      - * + * * * * ListUsers @@ -148,14 +148,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listUsers(ListUsersRequest request) + *
                                                                                                                                                      • listUsers(ListUsersRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listUsersPagedCallable() - *
                                                                                                                                                      • listUsersCallable() + *
                                                                                                                                                      • listUsersPagedCallable() + *
                                                                                                                                                      • listUsersCallable() *
                                                                                                                                                      - * + * * * * ListLocations @@ -163,14 +163,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocations(ListLocationsRequest request) + *
                                                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocationsPagedCallable() - *
                                                                                                                                                      • listLocationsCallable() + *
                                                                                                                                                      • listLocationsPagedCallable() + *
                                                                                                                                                      • listLocationsCallable() *
                                                                                                                                                      - * + * * * * GetLocation @@ -178,13 +178,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocation(GetLocationRequest request) + *
                                                                                                                                                      • getLocation(GetLocationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocationCallable() + *
                                                                                                                                                      • getLocationCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -195,13 +195,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -211,13 +211,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -231,13 +231,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java index 4b8670f534..408e5b077c 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/MessagingClient.java @@ -88,17 +88,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createRoom(CreateRoomRequest request) + *
                                                                                                                                                      • createRoom(CreateRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createRoom(String displayName, String description) + *
                                                                                                                                                      • createRoom(String displayName, String description) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createRoomCallable() + *
                                                                                                                                                      • createRoomCallable() *
                                                                                                                                                      - * + * * * * GetRoom @@ -106,18 +106,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getRoom(GetRoomRequest request) + *
                                                                                                                                                      • getRoom(GetRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getRoom(RoomName name) - *
                                                                                                                                                      • getRoom(String name) + *
                                                                                                                                                      • getRoom(RoomName name) + *
                                                                                                                                                      • getRoom(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getRoomCallable() + *
                                                                                                                                                      • getRoomCallable() *
                                                                                                                                                      - * + * * * * UpdateRoom @@ -125,13 +125,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateRoom(UpdateRoomRequest request) + *
                                                                                                                                                      • updateRoom(UpdateRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateRoomCallable() + *
                                                                                                                                                      • updateRoomCallable() *
                                                                                                                                                      - * + * * * * DeleteRoom @@ -139,18 +139,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteRoom(DeleteRoomRequest request) + *
                                                                                                                                                      • deleteRoom(DeleteRoomRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteRoom(RoomName name) - *
                                                                                                                                                      • deleteRoom(String name) + *
                                                                                                                                                      • deleteRoom(RoomName name) + *
                                                                                                                                                      • deleteRoom(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteRoomCallable() + *
                                                                                                                                                      • deleteRoomCallable() *
                                                                                                                                                      - * + * * * * ListRooms @@ -158,14 +158,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listRooms(ListRoomsRequest request) + *
                                                                                                                                                      • listRooms(ListRoomsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listRoomsPagedCallable() - *
                                                                                                                                                      • listRoomsCallable() + *
                                                                                                                                                      • listRoomsPagedCallable() + *
                                                                                                                                                      • listRoomsCallable() *
                                                                                                                                                      - * + * * * * CreateBlurb @@ -175,28 +175,28 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBlurb(CreateBlurbRequest request) + *
                                                                                                                                                      • createBlurb(CreateBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBlurb(ProfileName parent, UserName user, ByteString image) - *
                                                                                                                                                      • createBlurb(ProfileName parent, UserName user, String text) - *
                                                                                                                                                      • createBlurb(ProfileName parent, String user, ByteString image) - *
                                                                                                                                                      • createBlurb(ProfileName parent, String user, String text) - *
                                                                                                                                                      • createBlurb(RoomName parent, UserName user, ByteString image) - *
                                                                                                                                                      • createBlurb(RoomName parent, UserName user, String text) - *
                                                                                                                                                      • createBlurb(RoomName parent, String user, ByteString image) - *
                                                                                                                                                      • createBlurb(RoomName parent, String user, String text) - *
                                                                                                                                                      • createBlurb(String parent, UserName user, ByteString image) - *
                                                                                                                                                      • createBlurb(String parent, UserName user, String text) - *
                                                                                                                                                      • createBlurb(String parent, String user, ByteString image) - *
                                                                                                                                                      • createBlurb(String parent, String user, String text) + *
                                                                                                                                                      • createBlurb(ProfileName parent, UserName user, ByteString image) + *
                                                                                                                                                      • createBlurb(ProfileName parent, UserName user, String text) + *
                                                                                                                                                      • createBlurb(ProfileName parent, String user, ByteString image) + *
                                                                                                                                                      • createBlurb(ProfileName parent, String user, String text) + *
                                                                                                                                                      • createBlurb(RoomName parent, UserName user, ByteString image) + *
                                                                                                                                                      • createBlurb(RoomName parent, UserName user, String text) + *
                                                                                                                                                      • createBlurb(RoomName parent, String user, ByteString image) + *
                                                                                                                                                      • createBlurb(RoomName parent, String user, String text) + *
                                                                                                                                                      • createBlurb(String parent, UserName user, ByteString image) + *
                                                                                                                                                      • createBlurb(String parent, UserName user, String text) + *
                                                                                                                                                      • createBlurb(String parent, String user, ByteString image) + *
                                                                                                                                                      • createBlurb(String parent, String user, String text) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBlurbCallable() + *
                                                                                                                                                      • createBlurbCallable() *
                                                                                                                                                      - * + * * * * GetBlurb @@ -204,18 +204,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBlurb(GetBlurbRequest request) + *
                                                                                                                                                      • getBlurb(GetBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBlurb(BlurbName name) - *
                                                                                                                                                      • getBlurb(String name) + *
                                                                                                                                                      • getBlurb(BlurbName name) + *
                                                                                                                                                      • getBlurb(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBlurbCallable() + *
                                                                                                                                                      • getBlurbCallable() *
                                                                                                                                                      - * + * * * * UpdateBlurb @@ -223,13 +223,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBlurb(UpdateBlurbRequest request) + *
                                                                                                                                                      • updateBlurb(UpdateBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBlurbCallable() + *
                                                                                                                                                      • updateBlurbCallable() *
                                                                                                                                                      - * + * * * * DeleteBlurb @@ -237,18 +237,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBlurb(DeleteBlurbRequest request) + *
                                                                                                                                                      • deleteBlurb(DeleteBlurbRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBlurb(BlurbName name) - *
                                                                                                                                                      • deleteBlurb(String name) + *
                                                                                                                                                      • deleteBlurb(BlurbName name) + *
                                                                                                                                                      • deleteBlurb(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBlurbCallable() + *
                                                                                                                                                      • deleteBlurbCallable() *
                                                                                                                                                      - * + * * * * ListBlurbs @@ -257,20 +257,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBlurbs(ListBlurbsRequest request) + *
                                                                                                                                                      • listBlurbs(ListBlurbsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBlurbs(ProfileName parent) - *
                                                                                                                                                      • listBlurbs(RoomName parent) - *
                                                                                                                                                      • listBlurbs(String parent) + *
                                                                                                                                                      • listBlurbs(ProfileName parent) + *
                                                                                                                                                      • listBlurbs(RoomName parent) + *
                                                                                                                                                      • listBlurbs(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBlurbsPagedCallable() - *
                                                                                                                                                      • listBlurbsCallable() + *
                                                                                                                                                      • listBlurbsPagedCallable() + *
                                                                                                                                                      • listBlurbsCallable() *
                                                                                                                                                      - * + * * * * SearchBlurbs @@ -280,20 +280,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchBlurbsAsync(SearchBlurbsRequest request) + *
                                                                                                                                                      • searchBlurbsAsync(SearchBlurbsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchBlurbsAsync(ProfileName parent, String query) - *
                                                                                                                                                      • searchBlurbsAsync(RoomName parent, String query) - *
                                                                                                                                                      • searchBlurbsAsync(String parent, String query) + *
                                                                                                                                                      • searchBlurbsAsync(ProfileName parent, String query) + *
                                                                                                                                                      • searchBlurbsAsync(RoomName parent, String query) + *
                                                                                                                                                      • searchBlurbsAsync(String parent, String query) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchBlurbsOperationCallable() - *
                                                                                                                                                      • searchBlurbsCallable() + *
                                                                                                                                                      • searchBlurbsOperationCallable() + *
                                                                                                                                                      • searchBlurbsCallable() *
                                                                                                                                                      - * + * * * * StreamBlurbs @@ -302,9 +302,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • streamBlurbsCallable() + *
                                                                                                                                                      • streamBlurbsCallable() *
                                                                                                                                                      - * + * * * * SendBlurbs @@ -313,9 +313,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • sendBlurbsCallable() + *
                                                                                                                                                      • sendBlurbsCallable() *
                                                                                                                                                      - * + * * * * Connect @@ -326,9 +326,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • connectCallable() + *
                                                                                                                                                      • connectCallable() *
                                                                                                                                                      - * + * * * * ListLocations @@ -336,14 +336,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocations(ListLocationsRequest request) + *
                                                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocationsPagedCallable() - *
                                                                                                                                                      • listLocationsCallable() + *
                                                                                                                                                      • listLocationsPagedCallable() + *
                                                                                                                                                      • listLocationsCallable() *
                                                                                                                                                      - * + * * * * GetLocation @@ -351,13 +351,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocation(GetLocationRequest request) + *
                                                                                                                                                      • getLocation(GetLocationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocationCallable() + *
                                                                                                                                                      • getLocationCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -368,13 +368,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -384,13 +384,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -404,13 +404,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java index 0c7ab2242e..9ab9076c8a 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/SequenceServiceClient.java @@ -76,17 +76,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSequence(CreateSequenceRequest request) + *
                                                                                                                                                      • createSequence(CreateSequenceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSequence(Sequence sequence) + *
                                                                                                                                                      • createSequence(Sequence sequence) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSequenceCallable() + *
                                                                                                                                                      • createSequenceCallable() *
                                                                                                                                                      - * + * * * * CreateStreamingSequence @@ -94,17 +94,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createStreamingSequence(CreateStreamingSequenceRequest request) + *
                                                                                                                                                      • createStreamingSequence(CreateStreamingSequenceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createStreamingSequence(StreamingSequence streamingSequence) + *
                                                                                                                                                      • createStreamingSequence(StreamingSequence streamingSequence) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createStreamingSequenceCallable() + *
                                                                                                                                                      • createStreamingSequenceCallable() *
                                                                                                                                                      - * + * * * * GetSequenceReport @@ -112,18 +112,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSequenceReport(GetSequenceReportRequest request) + *
                                                                                                                                                      • getSequenceReport(GetSequenceReportRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSequenceReport(SequenceReportName name) - *
                                                                                                                                                      • getSequenceReport(String name) + *
                                                                                                                                                      • getSequenceReport(SequenceReportName name) + *
                                                                                                                                                      • getSequenceReport(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSequenceReportCallable() + *
                                                                                                                                                      • getSequenceReportCallable() *
                                                                                                                                                      - * + * * * * GetStreamingSequenceReport @@ -131,18 +131,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getStreamingSequenceReport(GetStreamingSequenceReportRequest request) + *
                                                                                                                                                      • getStreamingSequenceReport(GetStreamingSequenceReportRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getStreamingSequenceReport(StreamingSequenceReportName name) - *
                                                                                                                                                      • getStreamingSequenceReport(String name) + *
                                                                                                                                                      • getStreamingSequenceReport(StreamingSequenceReportName name) + *
                                                                                                                                                      • getStreamingSequenceReport(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getStreamingSequenceReportCallable() + *
                                                                                                                                                      • getStreamingSequenceReportCallable() *
                                                                                                                                                      - * + * * * * AttemptSequence @@ -150,18 +150,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • attemptSequence(AttemptSequenceRequest request) + *
                                                                                                                                                      • attemptSequence(AttemptSequenceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • attemptSequence(SequenceName name) - *
                                                                                                                                                      • attemptSequence(String name) + *
                                                                                                                                                      • attemptSequence(SequenceName name) + *
                                                                                                                                                      • attemptSequence(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • attemptSequenceCallable() + *
                                                                                                                                                      • attemptSequenceCallable() *
                                                                                                                                                      - * + * * * * AttemptStreamingSequence @@ -169,9 +169,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • attemptStreamingSequenceCallable() + *
                                                                                                                                                      • attemptStreamingSequenceCallable() *
                                                                                                                                                      - * + * * * * ListLocations @@ -179,14 +179,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocations(ListLocationsRequest request) + *
                                                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocationsPagedCallable() - *
                                                                                                                                                      • listLocationsCallable() + *
                                                                                                                                                      • listLocationsPagedCallable() + *
                                                                                                                                                      • listLocationsCallable() *
                                                                                                                                                      - * + * * * * GetLocation @@ -194,13 +194,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocation(GetLocationRequest request) + *
                                                                                                                                                      • getLocation(GetLocationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocationCallable() + *
                                                                                                                                                      • getLocationCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -211,13 +211,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -227,13 +227,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -247,13 +247,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java index c54d23e72f..2d6dc12ac6 100644 --- a/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java +++ b/showcase/gapic-showcase/src/main/java/com/google/showcase/v1beta1/TestingClient.java @@ -77,13 +77,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSession(CreateSessionRequest request) + *
                                                                                                                                                      • createSession(CreateSessionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSessionCallable() + *
                                                                                                                                                      • createSessionCallable() *
                                                                                                                                                      - * + * * * * GetSession @@ -91,13 +91,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSession(GetSessionRequest request) + *
                                                                                                                                                      • getSession(GetSessionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSessionCallable() + *
                                                                                                                                                      • getSessionCallable() *
                                                                                                                                                      - * + * * * * ListSessions @@ -105,14 +105,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSessions(ListSessionsRequest request) + *
                                                                                                                                                      • listSessions(ListSessionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSessionsPagedCallable() - *
                                                                                                                                                      • listSessionsCallable() + *
                                                                                                                                                      • listSessionsPagedCallable() + *
                                                                                                                                                      • listSessionsCallable() *
                                                                                                                                                      - * + * * * * DeleteSession @@ -120,13 +120,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSession(DeleteSessionRequest request) + *
                                                                                                                                                      • deleteSession(DeleteSessionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSessionCallable() + *
                                                                                                                                                      • deleteSessionCallable() *
                                                                                                                                                      - * + * * * * ReportSession @@ -136,13 +136,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • reportSession(ReportSessionRequest request) + *
                                                                                                                                                      • reportSession(ReportSessionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • reportSessionCallable() + *
                                                                                                                                                      • reportSessionCallable() *
                                                                                                                                                      - * + * * * * ListTests @@ -150,14 +150,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTests(ListTestsRequest request) + *
                                                                                                                                                      • listTests(ListTestsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTestsPagedCallable() - *
                                                                                                                                                      • listTestsCallable() + *
                                                                                                                                                      • listTestsPagedCallable() + *
                                                                                                                                                      • listTestsCallable() *
                                                                                                                                                      - * + * * * * DeleteTest @@ -170,13 +170,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteTest(DeleteTestRequest request) + *
                                                                                                                                                      • deleteTest(DeleteTestRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteTestCallable() + *
                                                                                                                                                      • deleteTestCallable() *
                                                                                                                                                      - * + * * * * VerifyTest @@ -187,13 +187,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • verifyTest(VerifyTestRequest request) + *
                                                                                                                                                      • verifyTest(VerifyTestRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • verifyTestCallable() + *
                                                                                                                                                      • verifyTestCallable() *
                                                                                                                                                      - * + * * * * ListLocations @@ -201,14 +201,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocations(ListLocationsRequest request) + *
                                                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocationsPagedCallable() - *
                                                                                                                                                      • listLocationsCallable() + *
                                                                                                                                                      • listLocationsPagedCallable() + *
                                                                                                                                                      • listLocationsCallable() *
                                                                                                                                                      - * + * * * * GetLocation @@ -216,13 +216,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocation(GetLocationRequest request) + *
                                                                                                                                                      • getLocation(GetLocationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocationCallable() + *
                                                                                                                                                      • getLocationCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -233,13 +233,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -249,13 +249,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -269,13 +269,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java index 871501ffce..159caa5e68 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/ConnectionServiceClient.java @@ -69,19 +69,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listConnections(ListConnectionsRequest request) + *
                                                                                                                                                      • listConnections(ListConnectionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listConnections(EndpointName parent) - *
                                                                                                                                                      • listConnections(String parent) + *
                                                                                                                                                      • listConnections(EndpointName parent) + *
                                                                                                                                                      • listConnections(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listConnectionsPagedCallable() - *
                                                                                                                                                      • listConnectionsCallable() + *
                                                                                                                                                      • listConnectionsPagedCallable() + *
                                                                                                                                                      • listConnectionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java index 9729017411..f9fff0caf7 100644 --- a/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java +++ b/test/integration/goldens/apigeeconnect/src/com/google/cloud/apigeeconnect/v1/TetherClient.java @@ -78,9 +78,10 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • egressCallable() + *
                                                                                                                                                      • egressCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java index ae4b0091bc..237a5b6147 100644 --- a/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java +++ b/test/integration/goldens/asset/src/com/google/cloud/asset/v1/AssetServiceClient.java @@ -89,14 +89,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • exportAssetsAsync(ExportAssetsRequest request) + *
                                                                                                                                                      • exportAssetsAsync(ExportAssetsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • exportAssetsOperationCallable() - *
                                                                                                                                                      • exportAssetsCallable() + *
                                                                                                                                                      • exportAssetsOperationCallable() + *
                                                                                                                                                      • exportAssetsCallable() *
                                                                                                                                                      - * + * * * * ListAssets @@ -105,19 +105,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listAssets(ListAssetsRequest request) + *
                                                                                                                                                      • listAssets(ListAssetsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listAssets(ResourceName parent) - *
                                                                                                                                                      • listAssets(String parent) + *
                                                                                                                                                      • listAssets(ResourceName parent) + *
                                                                                                                                                      • listAssets(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listAssetsPagedCallable() - *
                                                                                                                                                      • listAssetsCallable() + *
                                                                                                                                                      • listAssetsPagedCallable() + *
                                                                                                                                                      • listAssetsCallable() *
                                                                                                                                                      - * + * * * * BatchGetAssetsHistory @@ -131,13 +131,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) + *
                                                                                                                                                      • batchGetAssetsHistory(BatchGetAssetsHistoryRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • batchGetAssetsHistoryCallable() + *
                                                                                                                                                      • batchGetAssetsHistoryCallable() *
                                                                                                                                                      - * + * * * * CreateFeed @@ -146,17 +146,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createFeed(CreateFeedRequest request) + *
                                                                                                                                                      • createFeed(CreateFeedRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createFeed(String parent) + *
                                                                                                                                                      • createFeed(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createFeedCallable() + *
                                                                                                                                                      • createFeedCallable() *
                                                                                                                                                      - * + * * * * GetFeed @@ -164,18 +164,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getFeed(GetFeedRequest request) + *
                                                                                                                                                      • getFeed(GetFeedRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getFeed(FeedName name) - *
                                                                                                                                                      • getFeed(String name) + *
                                                                                                                                                      • getFeed(FeedName name) + *
                                                                                                                                                      • getFeed(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getFeedCallable() + *
                                                                                                                                                      • getFeedCallable() *
                                                                                                                                                      - * + * * * * ListFeeds @@ -183,17 +183,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listFeeds(ListFeedsRequest request) + *
                                                                                                                                                      • listFeeds(ListFeedsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listFeeds(String parent) + *
                                                                                                                                                      • listFeeds(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listFeedsCallable() + *
                                                                                                                                                      • listFeedsCallable() *
                                                                                                                                                      - * + * * * * UpdateFeed @@ -201,17 +201,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateFeed(UpdateFeedRequest request) + *
                                                                                                                                                      • updateFeed(UpdateFeedRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateFeed(Feed feed) + *
                                                                                                                                                      • updateFeed(Feed feed) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateFeedCallable() + *
                                                                                                                                                      • updateFeedCallable() *
                                                                                                                                                      - * + * * * * DeleteFeed @@ -219,18 +219,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteFeed(DeleteFeedRequest request) + *
                                                                                                                                                      • deleteFeed(DeleteFeedRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteFeed(FeedName name) - *
                                                                                                                                                      • deleteFeed(String name) + *
                                                                                                                                                      • deleteFeed(FeedName name) + *
                                                                                                                                                      • deleteFeed(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteFeedCallable() + *
                                                                                                                                                      • deleteFeedCallable() *
                                                                                                                                                      - * + * * * * SearchAllResources @@ -241,18 +241,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchAllResources(SearchAllResourcesRequest request) + *
                                                                                                                                                      • searchAllResources(SearchAllResourcesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchAllResources(String scope, String query, List assetTypes) + *
                                                                                                                                                      • searchAllResources(String scope, String query, List assetTypes) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchAllResourcesPagedCallable() - *
                                                                                                                                                      • searchAllResourcesCallable() + *
                                                                                                                                                      • searchAllResourcesPagedCallable() + *
                                                                                                                                                      • searchAllResourcesCallable() *
                                                                                                                                                      - * + * * * * SearchAllIamPolicies @@ -263,18 +263,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchAllIamPolicies(SearchAllIamPoliciesRequest request) + *
                                                                                                                                                      • searchAllIamPolicies(SearchAllIamPoliciesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchAllIamPolicies(String scope, String query) + *
                                                                                                                                                      • searchAllIamPolicies(String scope, String query) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • searchAllIamPoliciesPagedCallable() - *
                                                                                                                                                      • searchAllIamPoliciesCallable() + *
                                                                                                                                                      • searchAllIamPoliciesPagedCallable() + *
                                                                                                                                                      • searchAllIamPoliciesCallable() *
                                                                                                                                                      - * + * * * * AnalyzeIamPolicy @@ -283,13 +283,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • analyzeIamPolicy(AnalyzeIamPolicyRequest request) + *
                                                                                                                                                      • analyzeIamPolicy(AnalyzeIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • analyzeIamPolicyCallable() + *
                                                                                                                                                      • analyzeIamPolicyCallable() *
                                                                                                                                                      - * + * * * * AnalyzeIamPolicyLongrunning @@ -305,14 +305,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) + *
                                                                                                                                                      • analyzeIamPolicyLongrunningAsync(AnalyzeIamPolicyLongrunningRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • analyzeIamPolicyLongrunningOperationCallable() - *
                                                                                                                                                      • analyzeIamPolicyLongrunningCallable() + *
                                                                                                                                                      • analyzeIamPolicyLongrunningOperationCallable() + *
                                                                                                                                                      • analyzeIamPolicyLongrunningCallable() *
                                                                                                                                                      - * + * * * * AnalyzeMove @@ -324,13 +324,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • analyzeMove(AnalyzeMoveRequest request) + *
                                                                                                                                                      • analyzeMove(AnalyzeMoveRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • analyzeMoveCallable() + *
                                                                                                                                                      • analyzeMoveCallable() *
                                                                                                                                                      - * + * * * * QueryAssets @@ -351,13 +351,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • queryAssets(QueryAssetsRequest request) + *
                                                                                                                                                      • queryAssets(QueryAssetsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • queryAssetsCallable() + *
                                                                                                                                                      • queryAssetsCallable() *
                                                                                                                                                      - * + * * * * CreateSavedQuery @@ -365,20 +365,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSavedQuery(CreateSavedQueryRequest request) + *
                                                                                                                                                      • createSavedQuery(CreateSavedQueryRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSavedQuery(FolderName parent, SavedQuery savedQuery, String savedQueryId) - *
                                                                                                                                                      • createSavedQuery(OrganizationName parent, SavedQuery savedQuery, String savedQueryId) - *
                                                                                                                                                      • createSavedQuery(ProjectName parent, SavedQuery savedQuery, String savedQueryId) - *
                                                                                                                                                      • createSavedQuery(String parent, SavedQuery savedQuery, String savedQueryId) + *
                                                                                                                                                      • createSavedQuery(FolderName parent, SavedQuery savedQuery, String savedQueryId) + *
                                                                                                                                                      • createSavedQuery(OrganizationName parent, SavedQuery savedQuery, String savedQueryId) + *
                                                                                                                                                      • createSavedQuery(ProjectName parent, SavedQuery savedQuery, String savedQueryId) + *
                                                                                                                                                      • createSavedQuery(String parent, SavedQuery savedQuery, String savedQueryId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSavedQueryCallable() + *
                                                                                                                                                      • createSavedQueryCallable() *
                                                                                                                                                      - * + * * * * GetSavedQuery @@ -386,18 +386,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSavedQuery(GetSavedQueryRequest request) + *
                                                                                                                                                      • getSavedQuery(GetSavedQueryRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSavedQuery(SavedQueryName name) - *
                                                                                                                                                      • getSavedQuery(String name) + *
                                                                                                                                                      • getSavedQuery(SavedQueryName name) + *
                                                                                                                                                      • getSavedQuery(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSavedQueryCallable() + *
                                                                                                                                                      • getSavedQueryCallable() *
                                                                                                                                                      - * + * * * * ListSavedQueries @@ -405,21 +405,21 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSavedQueries(ListSavedQueriesRequest request) + *
                                                                                                                                                      • listSavedQueries(ListSavedQueriesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSavedQueries(FolderName parent) - *
                                                                                                                                                      • listSavedQueries(OrganizationName parent) - *
                                                                                                                                                      • listSavedQueries(ProjectName parent) - *
                                                                                                                                                      • listSavedQueries(String parent) + *
                                                                                                                                                      • listSavedQueries(FolderName parent) + *
                                                                                                                                                      • listSavedQueries(OrganizationName parent) + *
                                                                                                                                                      • listSavedQueries(ProjectName parent) + *
                                                                                                                                                      • listSavedQueries(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSavedQueriesPagedCallable() - *
                                                                                                                                                      • listSavedQueriesCallable() + *
                                                                                                                                                      • listSavedQueriesPagedCallable() + *
                                                                                                                                                      • listSavedQueriesCallable() *
                                                                                                                                                      - * + * * * * UpdateSavedQuery @@ -427,17 +427,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSavedQuery(UpdateSavedQueryRequest request) + *
                                                                                                                                                      • updateSavedQuery(UpdateSavedQueryRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSavedQuery(SavedQuery savedQuery, FieldMask updateMask) + *
                                                                                                                                                      • updateSavedQuery(SavedQuery savedQuery, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSavedQueryCallable() + *
                                                                                                                                                      • updateSavedQueryCallable() *
                                                                                                                                                      - * + * * * * DeleteSavedQuery @@ -445,18 +445,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSavedQuery(DeleteSavedQueryRequest request) + *
                                                                                                                                                      • deleteSavedQuery(DeleteSavedQueryRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSavedQuery(SavedQueryName name) - *
                                                                                                                                                      • deleteSavedQuery(String name) + *
                                                                                                                                                      • deleteSavedQuery(SavedQueryName name) + *
                                                                                                                                                      • deleteSavedQuery(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSavedQueryCallable() + *
                                                                                                                                                      • deleteSavedQueryCallable() *
                                                                                                                                                      - * + * * * * BatchGetEffectiveIamPolicies @@ -464,13 +464,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) + *
                                                                                                                                                      • batchGetEffectiveIamPolicies(BatchGetEffectiveIamPoliciesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • batchGetEffectiveIamPoliciesCallable() + *
                                                                                                                                                      • batchGetEffectiveIamPoliciesCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java index 8aae61adc0..7a919c82df 100644 --- a/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java +++ b/test/integration/goldens/bigtable/src/com/google/cloud/bigtable/data/v2/BaseBigtableDataClient.java @@ -86,9 +86,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • readRowsCallable() + *
                                                                                                                                                      • readRowsCallable() *
                                                                                                                                                      - * + * * * * SampleRowKeys @@ -99,9 +99,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • sampleRowKeysCallable() + *
                                                                                                                                                      • sampleRowKeysCallable() *
                                                                                                                                                      - * + * * * * MutateRow @@ -110,20 +110,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • mutateRow(MutateRowRequest request) + *
                                                                                                                                                      • mutateRow(MutateRowRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • mutateRow(TableName tableName, ByteString rowKey, List mutations) - *
                                                                                                                                                      • mutateRow(String tableName, ByteString rowKey, List mutations) - *
                                                                                                                                                      • mutateRow(TableName tableName, ByteString rowKey, List mutations, String appProfileId) - *
                                                                                                                                                      • mutateRow(String tableName, ByteString rowKey, List mutations, String appProfileId) + *
                                                                                                                                                      • mutateRow(TableName tableName, ByteString rowKey, List mutations) + *
                                                                                                                                                      • mutateRow(String tableName, ByteString rowKey, List mutations) + *
                                                                                                                                                      • mutateRow(TableName tableName, ByteString rowKey, List mutations, String appProfileId) + *
                                                                                                                                                      • mutateRow(String tableName, ByteString rowKey, List mutations, String appProfileId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • mutateRowCallable() + *
                                                                                                                                                      • mutateRowCallable() *
                                                                                                                                                      - * + * * * * MutateRows @@ -133,9 +133,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • mutateRowsCallable() + *
                                                                                                                                                      • mutateRowsCallable() *
                                                                                                                                                      - * + * * * * CheckAndMutateRow @@ -143,20 +143,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • checkAndMutateRow(CheckAndMutateRowRequest request) + *
                                                                                                                                                      • checkAndMutateRow(CheckAndMutateRowRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • checkAndMutateRow(TableName tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations) - *
                                                                                                                                                      • checkAndMutateRow(String tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations) - *
                                                                                                                                                      • checkAndMutateRow(TableName tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations, String appProfileId) - *
                                                                                                                                                      • checkAndMutateRow(String tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations, String appProfileId) + *
                                                                                                                                                      • checkAndMutateRow(TableName tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations) + *
                                                                                                                                                      • checkAndMutateRow(String tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations) + *
                                                                                                                                                      • checkAndMutateRow(TableName tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations, String appProfileId) + *
                                                                                                                                                      • checkAndMutateRow(String tableName, ByteString rowKey, RowFilter predicateFilter, List trueMutations, List falseMutations, String appProfileId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • checkAndMutateRowCallable() + *
                                                                                                                                                      • checkAndMutateRowCallable() *
                                                                                                                                                      - * + * * * * PingAndWarm @@ -165,20 +165,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pingAndWarm(PingAndWarmRequest request) + *
                                                                                                                                                      • pingAndWarm(PingAndWarmRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pingAndWarm(InstanceName name) - *
                                                                                                                                                      • pingAndWarm(String name) - *
                                                                                                                                                      • pingAndWarm(InstanceName name, String appProfileId) - *
                                                                                                                                                      • pingAndWarm(String name, String appProfileId) + *
                                                                                                                                                      • pingAndWarm(InstanceName name) + *
                                                                                                                                                      • pingAndWarm(String name) + *
                                                                                                                                                      • pingAndWarm(InstanceName name, String appProfileId) + *
                                                                                                                                                      • pingAndWarm(String name, String appProfileId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pingAndWarmCallable() + *
                                                                                                                                                      • pingAndWarmCallable() *
                                                                                                                                                      - * + * * * * ReadModifyWriteRow @@ -190,20 +190,21 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • readModifyWriteRow(ReadModifyWriteRowRequest request) + *
                                                                                                                                                      • readModifyWriteRow(ReadModifyWriteRowRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • readModifyWriteRow(TableName tableName, ByteString rowKey, List rules) - *
                                                                                                                                                      • readModifyWriteRow(String tableName, ByteString rowKey, List rules) - *
                                                                                                                                                      • readModifyWriteRow(TableName tableName, ByteString rowKey, List rules, String appProfileId) - *
                                                                                                                                                      • readModifyWriteRow(String tableName, ByteString rowKey, List rules, String appProfileId) + *
                                                                                                                                                      • readModifyWriteRow(TableName tableName, ByteString rowKey, List rules) + *
                                                                                                                                                      • readModifyWriteRow(String tableName, ByteString rowKey, List rules) + *
                                                                                                                                                      • readModifyWriteRow(TableName tableName, ByteString rowKey, List rules, String appProfileId) + *
                                                                                                                                                      • readModifyWriteRow(String tableName, ByteString rowKey, List rules, String appProfileId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • readModifyWriteRowCallable() + *
                                                                                                                                                      • readModifyWriteRowCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java index 20e59e9a0e..49d630f108 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/AddressesClient.java @@ -74,18 +74,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • aggregatedList(AggregatedListAddressesRequest request) + *
                                                                                                                                                      • aggregatedList(AggregatedListAddressesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • aggregatedList(String project) + *
                                                                                                                                                      • aggregatedList(String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • aggregatedListPagedCallable() - *
                                                                                                                                                      • aggregatedListCallable() + *
                                                                                                                                                      • aggregatedListPagedCallable() + *
                                                                                                                                                      • aggregatedListCallable() *
                                                                                                                                                      - * + * * * * Delete @@ -93,18 +93,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteAsync(DeleteAddressRequest request) + *
                                                                                                                                                      • deleteAsync(DeleteAddressRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteAsync(String project, String region, String address) + *
                                                                                                                                                      • deleteAsync(String project, String region, String address) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteOperationCallable() - *
                                                                                                                                                      • deleteCallable() + *
                                                                                                                                                      • deleteOperationCallable() + *
                                                                                                                                                      • deleteCallable() *
                                                                                                                                                      - * + * * * * Insert @@ -112,18 +112,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • insertAsync(InsertAddressRequest request) + *
                                                                                                                                                      • insertAsync(InsertAddressRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • insertAsync(String project, String region, Address addressResource) + *
                                                                                                                                                      • insertAsync(String project, String region, Address addressResource) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • insertOperationCallable() - *
                                                                                                                                                      • insertCallable() + *
                                                                                                                                                      • insertOperationCallable() + *
                                                                                                                                                      • insertCallable() *
                                                                                                                                                      - * + * * * * List @@ -131,18 +131,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • list(ListAddressesRequest request) + *
                                                                                                                                                      • list(ListAddressesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • list(String project, String region, String orderBy) + *
                                                                                                                                                      • list(String project, String region, String orderBy) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listPagedCallable() - *
                                                                                                                                                      • listCallable() + *
                                                                                                                                                      • listPagedCallable() + *
                                                                                                                                                      • listCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java index 5875d0f243..2dcf79a74b 100644 --- a/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java +++ b/test/integration/goldens/compute/src/com/google/cloud/compute/v1small/RegionOperationsClient.java @@ -60,17 +60,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • get(GetRegionOperationRequest request) + *
                                                                                                                                                      • get(GetRegionOperationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • get(String project, String region, String operation) + *
                                                                                                                                                      • get(String project, String region, String operation) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCallable() + *
                                                                                                                                                      • getCallable() *
                                                                                                                                                      - * + * * * * Wait @@ -82,17 +82,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • wait(WaitRegionOperationRequest request) + *
                                                                                                                                                      • wait(WaitRegionOperationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • wait(String project, String region, String operation) + *
                                                                                                                                                      • wait(String project, String region, String operation) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • waitCallable() + *
                                                                                                                                                      • waitCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java index 7275a3501f..4306642718 100644 --- a/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java +++ b/test/integration/goldens/credentials/src/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java @@ -71,18 +71,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • generateAccessToken(GenerateAccessTokenRequest request) + *
                                                                                                                                                      • generateAccessToken(GenerateAccessTokenRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • generateAccessToken(ServiceAccountName name, List delegates, List scope, Duration lifetime) - *
                                                                                                                                                      • generateAccessToken(String name, List delegates, List scope, Duration lifetime) + *
                                                                                                                                                      • generateAccessToken(ServiceAccountName name, List delegates, List scope, Duration lifetime) + *
                                                                                                                                                      • generateAccessToken(String name, List delegates, List scope, Duration lifetime) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • generateAccessTokenCallable() + *
                                                                                                                                                      • generateAccessTokenCallable() *
                                                                                                                                                      - * + * * * * GenerateIdToken @@ -90,18 +90,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • generateIdToken(GenerateIdTokenRequest request) + *
                                                                                                                                                      • generateIdToken(GenerateIdTokenRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • generateIdToken(ServiceAccountName name, List delegates, String audience, includeEmail) - *
                                                                                                                                                      • generateIdToken(String name, List delegates, String audience, includeEmail) + *
                                                                                                                                                      • generateIdToken(ServiceAccountName name, List delegates, String audience, boolean includeEmail) + *
                                                                                                                                                      • generateIdToken(String name, List delegates, String audience, boolean includeEmail) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • generateIdTokenCallable() + *
                                                                                                                                                      • generateIdTokenCallable() *
                                                                                                                                                      - * + * * * * SignBlob @@ -109,18 +109,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • signBlob(SignBlobRequest request) + *
                                                                                                                                                      • signBlob(SignBlobRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • signBlob(ServiceAccountName name, List delegates, ByteString payload) - *
                                                                                                                                                      • signBlob(String name, List delegates, ByteString payload) + *
                                                                                                                                                      • signBlob(ServiceAccountName name, List delegates, ByteString payload) + *
                                                                                                                                                      • signBlob(String name, List delegates, ByteString payload) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • signBlobCallable() + *
                                                                                                                                                      • signBlobCallable() *
                                                                                                                                                      - * + * * * * SignJwt @@ -128,18 +128,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • signJwt(SignJwtRequest request) + *
                                                                                                                                                      • signJwt(SignJwtRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • signJwt(ServiceAccountName name, List delegates, String payload) - *
                                                                                                                                                      • signJwt(String name, List delegates, String payload) + *
                                                                                                                                                      • signJwt(ServiceAccountName name, List delegates, String payload) + *
                                                                                                                                                      • signJwt(String name, List delegates, String payload) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • signJwtCallable() + *
                                                                                                                                                      • signJwtCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java index da072cde0e..066f37362b 100644 --- a/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java +++ b/test/integration/goldens/iam/src/com/google/iam/v1/IAMPolicyClient.java @@ -86,13 +86,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -102,13 +102,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -122,13 +122,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java index 9667843cb4..bccc7ff3d5 100644 --- a/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java +++ b/test/integration/goldens/kms/src/com/google/cloud/kms/v1/KeyManagementServiceClient.java @@ -91,19 +91,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listKeyRings(ListKeyRingsRequest request) + *
                                                                                                                                                      • listKeyRings(ListKeyRingsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listKeyRings(LocationName parent) - *
                                                                                                                                                      • listKeyRings(String parent) + *
                                                                                                                                                      • listKeyRings(LocationName parent) + *
                                                                                                                                                      • listKeyRings(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listKeyRingsPagedCallable() - *
                                                                                                                                                      • listKeyRingsCallable() + *
                                                                                                                                                      • listKeyRingsPagedCallable() + *
                                                                                                                                                      • listKeyRingsCallable() *
                                                                                                                                                      - * + * * * * ListCryptoKeys @@ -111,19 +111,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listCryptoKeys(ListCryptoKeysRequest request) + *
                                                                                                                                                      • listCryptoKeys(ListCryptoKeysRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listCryptoKeys(KeyRingName parent) - *
                                                                                                                                                      • listCryptoKeys(String parent) + *
                                                                                                                                                      • listCryptoKeys(KeyRingName parent) + *
                                                                                                                                                      • listCryptoKeys(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listCryptoKeysPagedCallable() - *
                                                                                                                                                      • listCryptoKeysCallable() + *
                                                                                                                                                      • listCryptoKeysPagedCallable() + *
                                                                                                                                                      • listCryptoKeysCallable() *
                                                                                                                                                      - * + * * * * ListCryptoKeyVersions @@ -131,19 +131,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) + *
                                                                                                                                                      • listCryptoKeyVersions(ListCryptoKeyVersionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listCryptoKeyVersions(CryptoKeyName parent) - *
                                                                                                                                                      • listCryptoKeyVersions(String parent) + *
                                                                                                                                                      • listCryptoKeyVersions(CryptoKeyName parent) + *
                                                                                                                                                      • listCryptoKeyVersions(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listCryptoKeyVersionsPagedCallable() - *
                                                                                                                                                      • listCryptoKeyVersionsCallable() + *
                                                                                                                                                      • listCryptoKeyVersionsPagedCallable() + *
                                                                                                                                                      • listCryptoKeyVersionsCallable() *
                                                                                                                                                      - * + * * * * ListImportJobs @@ -151,19 +151,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listImportJobs(ListImportJobsRequest request) + *
                                                                                                                                                      • listImportJobs(ListImportJobsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listImportJobs(KeyRingName parent) - *
                                                                                                                                                      • listImportJobs(String parent) + *
                                                                                                                                                      • listImportJobs(KeyRingName parent) + *
                                                                                                                                                      • listImportJobs(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listImportJobsPagedCallable() - *
                                                                                                                                                      • listImportJobsCallable() + *
                                                                                                                                                      • listImportJobsPagedCallable() + *
                                                                                                                                                      • listImportJobsCallable() *
                                                                                                                                                      - * + * * * * GetKeyRing @@ -171,18 +171,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getKeyRing(GetKeyRingRequest request) + *
                                                                                                                                                      • getKeyRing(GetKeyRingRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getKeyRing(KeyRingName name) - *
                                                                                                                                                      • getKeyRing(String name) + *
                                                                                                                                                      • getKeyRing(KeyRingName name) + *
                                                                                                                                                      • getKeyRing(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getKeyRingCallable() + *
                                                                                                                                                      • getKeyRingCallable() *
                                                                                                                                                      - * + * * * * GetCryptoKey @@ -192,18 +192,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCryptoKey(GetCryptoKeyRequest request) + *
                                                                                                                                                      • getCryptoKey(GetCryptoKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCryptoKey(CryptoKeyName name) - *
                                                                                                                                                      • getCryptoKey(String name) + *
                                                                                                                                                      • getCryptoKey(CryptoKeyName name) + *
                                                                                                                                                      • getCryptoKey(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCryptoKeyCallable() + *
                                                                                                                                                      • getCryptoKeyCallable() *
                                                                                                                                                      - * + * * * * GetCryptoKeyVersion @@ -212,18 +212,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) + *
                                                                                                                                                      • getCryptoKeyVersion(GetCryptoKeyVersionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCryptoKeyVersion(CryptoKeyVersionName name) - *
                                                                                                                                                      • getCryptoKeyVersion(String name) + *
                                                                                                                                                      • getCryptoKeyVersion(CryptoKeyVersionName name) + *
                                                                                                                                                      • getCryptoKeyVersion(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCryptoKeyVersionCallable() + *
                                                                                                                                                      • getCryptoKeyVersionCallable() *
                                                                                                                                                      - * + * * * * GetPublicKey @@ -236,18 +236,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getPublicKey(GetPublicKeyRequest request) + *
                                                                                                                                                      • getPublicKey(GetPublicKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getPublicKey(CryptoKeyVersionName name) - *
                                                                                                                                                      • getPublicKey(String name) + *
                                                                                                                                                      • getPublicKey(CryptoKeyVersionName name) + *
                                                                                                                                                      • getPublicKey(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getPublicKeyCallable() + *
                                                                                                                                                      • getPublicKeyCallable() *
                                                                                                                                                      - * + * * * * GetImportJob @@ -255,18 +255,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getImportJob(GetImportJobRequest request) + *
                                                                                                                                                      • getImportJob(GetImportJobRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getImportJob(ImportJobName name) - *
                                                                                                                                                      • getImportJob(String name) + *
                                                                                                                                                      • getImportJob(ImportJobName name) + *
                                                                                                                                                      • getImportJob(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getImportJobCallable() + *
                                                                                                                                                      • getImportJobCallable() *
                                                                                                                                                      - * + * * * * CreateKeyRing @@ -275,18 +275,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createKeyRing(CreateKeyRingRequest request) + *
                                                                                                                                                      • createKeyRing(CreateKeyRingRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createKeyRing(LocationName parent, String keyRingId, KeyRing keyRing) - *
                                                                                                                                                      • createKeyRing(String parent, String keyRingId, KeyRing keyRing) + *
                                                                                                                                                      • createKeyRing(LocationName parent, String keyRingId, KeyRing keyRing) + *
                                                                                                                                                      • createKeyRing(String parent, String keyRingId, KeyRing keyRing) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createKeyRingCallable() + *
                                                                                                                                                      • createKeyRingCallable() *
                                                                                                                                                      - * + * * * * CreateCryptoKey @@ -299,18 +299,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createCryptoKey(CreateCryptoKeyRequest request) + *
                                                                                                                                                      • createCryptoKey(CreateCryptoKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createCryptoKey(KeyRingName parent, String cryptoKeyId, CryptoKey cryptoKey) - *
                                                                                                                                                      • createCryptoKey(String parent, String cryptoKeyId, CryptoKey cryptoKey) + *
                                                                                                                                                      • createCryptoKey(KeyRingName parent, String cryptoKeyId, CryptoKey cryptoKey) + *
                                                                                                                                                      • createCryptoKey(String parent, String cryptoKeyId, CryptoKey cryptoKey) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createCryptoKeyCallable() + *
                                                                                                                                                      • createCryptoKeyCallable() *
                                                                                                                                                      - * + * * * * CreateCryptoKeyVersion @@ -323,18 +323,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createCryptoKeyVersion(CreateCryptoKeyVersionRequest request) + *
                                                                                                                                                      • createCryptoKeyVersion(CreateCryptoKeyVersionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createCryptoKeyVersion(CryptoKeyName parent, CryptoKeyVersion cryptoKeyVersion) - *
                                                                                                                                                      • createCryptoKeyVersion(String parent, CryptoKeyVersion cryptoKeyVersion) + *
                                                                                                                                                      • createCryptoKeyVersion(CryptoKeyName parent, CryptoKeyVersion cryptoKeyVersion) + *
                                                                                                                                                      • createCryptoKeyVersion(String parent, CryptoKeyVersion cryptoKeyVersion) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createCryptoKeyVersionCallable() + *
                                                                                                                                                      • createCryptoKeyVersionCallable() *
                                                                                                                                                      - * + * * * * ImportCryptoKeyVersion @@ -347,13 +347,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) + *
                                                                                                                                                      • importCryptoKeyVersion(ImportCryptoKeyVersionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • importCryptoKeyVersionCallable() + *
                                                                                                                                                      • importCryptoKeyVersionCallable() *
                                                                                                                                                      - * + * * * * CreateImportJob @@ -365,18 +365,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createImportJob(CreateImportJobRequest request) + *
                                                                                                                                                      • createImportJob(CreateImportJobRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createImportJob(KeyRingName parent, String importJobId, ImportJob importJob) - *
                                                                                                                                                      • createImportJob(String parent, String importJobId, ImportJob importJob) + *
                                                                                                                                                      • createImportJob(KeyRingName parent, String importJobId, ImportJob importJob) + *
                                                                                                                                                      • createImportJob(String parent, String importJobId, ImportJob importJob) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createImportJobCallable() + *
                                                                                                                                                      • createImportJobCallable() *
                                                                                                                                                      - * + * * * * UpdateCryptoKey @@ -384,17 +384,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKey(UpdateCryptoKeyRequest request) + *
                                                                                                                                                      • updateCryptoKey(UpdateCryptoKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKey(CryptoKey cryptoKey, FieldMask updateMask) + *
                                                                                                                                                      • updateCryptoKey(CryptoKey cryptoKey, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKeyCallable() + *
                                                                                                                                                      • updateCryptoKeyCallable() *
                                                                                                                                                      - * + * * * * UpdateCryptoKeyVersion @@ -413,17 +413,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKeyVersion(UpdateCryptoKeyVersionRequest request) + *
                                                                                                                                                      • updateCryptoKeyVersion(UpdateCryptoKeyVersionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion, FieldMask updateMask) + *
                                                                                                                                                      • updateCryptoKeyVersion(CryptoKeyVersion cryptoKeyVersion, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKeyVersionCallable() + *
                                                                                                                                                      • updateCryptoKeyVersionCallable() *
                                                                                                                                                      - * + * * * * Encrypt @@ -434,18 +434,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • encrypt(EncryptRequest request) + *
                                                                                                                                                      • encrypt(EncryptRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • encrypt(ResourceName name, ByteString plaintext) - *
                                                                                                                                                      • encrypt(String name, ByteString plaintext) + *
                                                                                                                                                      • encrypt(ResourceName name, ByteString plaintext) + *
                                                                                                                                                      • encrypt(String name, ByteString plaintext) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • encryptCallable() + *
                                                                                                                                                      • encryptCallable() *
                                                                                                                                                      - * + * * * * Decrypt @@ -456,18 +456,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • decrypt(DecryptRequest request) + *
                                                                                                                                                      • decrypt(DecryptRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • decrypt(CryptoKeyName name, ByteString ciphertext) - *
                                                                                                                                                      • decrypt(String name, ByteString ciphertext) + *
                                                                                                                                                      • decrypt(CryptoKeyName name, ByteString ciphertext) + *
                                                                                                                                                      • decrypt(String name, ByteString ciphertext) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • decryptCallable() + *
                                                                                                                                                      • decryptCallable() *
                                                                                                                                                      - * + * * * * AsymmetricSign @@ -479,18 +479,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • asymmetricSign(AsymmetricSignRequest request) + *
                                                                                                                                                      • asymmetricSign(AsymmetricSignRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • asymmetricSign(CryptoKeyVersionName name, Digest digest) - *
                                                                                                                                                      • asymmetricSign(String name, Digest digest) + *
                                                                                                                                                      • asymmetricSign(CryptoKeyVersionName name, Digest digest) + *
                                                                                                                                                      • asymmetricSign(String name, Digest digest) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • asymmetricSignCallable() + *
                                                                                                                                                      • asymmetricSignCallable() *
                                                                                                                                                      - * + * * * * AsymmetricDecrypt @@ -502,18 +502,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • asymmetricDecrypt(AsymmetricDecryptRequest request) + *
                                                                                                                                                      • asymmetricDecrypt(AsymmetricDecryptRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • asymmetricDecrypt(CryptoKeyVersionName name, ByteString ciphertext) - *
                                                                                                                                                      • asymmetricDecrypt(String name, ByteString ciphertext) + *
                                                                                                                                                      • asymmetricDecrypt(CryptoKeyVersionName name, ByteString ciphertext) + *
                                                                                                                                                      • asymmetricDecrypt(String name, ByteString ciphertext) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • asymmetricDecryptCallable() + *
                                                                                                                                                      • asymmetricDecryptCallable() *
                                                                                                                                                      - * + * * * * UpdateCryptoKeyPrimaryVersion @@ -525,18 +525,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) + *
                                                                                                                                                      • updateCryptoKeyPrimaryVersion(UpdateCryptoKeyPrimaryVersionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKeyPrimaryVersion(CryptoKeyName name, String cryptoKeyVersionId) - *
                                                                                                                                                      • updateCryptoKeyPrimaryVersion(String name, String cryptoKeyVersionId) + *
                                                                                                                                                      • updateCryptoKeyPrimaryVersion(CryptoKeyName name, String cryptoKeyVersionId) + *
                                                                                                                                                      • updateCryptoKeyPrimaryVersion(String name, String cryptoKeyVersionId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCryptoKeyPrimaryVersionCallable() + *
                                                                                                                                                      • updateCryptoKeyPrimaryVersionCallable() *
                                                                                                                                                      - * + * * * * DestroyCryptoKeyVersion @@ -561,18 +561,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) + *
                                                                                                                                                      • destroyCryptoKeyVersion(DestroyCryptoKeyVersionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • destroyCryptoKeyVersion(CryptoKeyVersionName name) - *
                                                                                                                                                      • destroyCryptoKeyVersion(String name) + *
                                                                                                                                                      • destroyCryptoKeyVersion(CryptoKeyVersionName name) + *
                                                                                                                                                      • destroyCryptoKeyVersion(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • destroyCryptoKeyVersionCallable() + *
                                                                                                                                                      • destroyCryptoKeyVersionCallable() *
                                                                                                                                                      - * + * * * * RestoreCryptoKeyVersion @@ -588,18 +588,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • restoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest request) + *
                                                                                                                                                      • restoreCryptoKeyVersion(RestoreCryptoKeyVersionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • restoreCryptoKeyVersion(CryptoKeyVersionName name) - *
                                                                                                                                                      • restoreCryptoKeyVersion(String name) + *
                                                                                                                                                      • restoreCryptoKeyVersion(CryptoKeyVersionName name) + *
                                                                                                                                                      • restoreCryptoKeyVersion(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • restoreCryptoKeyVersionCallable() + *
                                                                                                                                                      • restoreCryptoKeyVersionCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -609,13 +609,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * ListLocations @@ -623,14 +623,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocations(ListLocationsRequest request) + *
                                                                                                                                                      • listLocations(ListLocationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLocationsPagedCallable() - *
                                                                                                                                                      • listLocationsCallable() + *
                                                                                                                                                      • listLocationsPagedCallable() + *
                                                                                                                                                      • listLocationsCallable() *
                                                                                                                                                      - * + * * * * GetLocation @@ -638,13 +638,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocation(GetLocationRequest request) + *
                                                                                                                                                      • getLocation(GetLocationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLocationCallable() + *
                                                                                                                                                      • getLocationCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -652,13 +652,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java index 4e0b80cc95..9f1485abfa 100644 --- a/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java +++ b/test/integration/goldens/library/src/com/google/cloud/example/library/v1/LibraryServiceClient.java @@ -91,17 +91,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createShelf(CreateShelfRequest request) + *
                                                                                                                                                      • createShelf(CreateShelfRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createShelf(Shelf shelf) + *
                                                                                                                                                      • createShelf(Shelf shelf) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createShelfCallable() + *
                                                                                                                                                      • createShelfCallable() *
                                                                                                                                                      - * + * * * * GetShelf @@ -109,18 +109,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getShelf(GetShelfRequest request) + *
                                                                                                                                                      • getShelf(GetShelfRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getShelf(ShelfName name) - *
                                                                                                                                                      • getShelf(String name) + *
                                                                                                                                                      • getShelf(ShelfName name) + *
                                                                                                                                                      • getShelf(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getShelfCallable() + *
                                                                                                                                                      • getShelfCallable() *
                                                                                                                                                      - * + * * * * ListShelves @@ -129,14 +129,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listShelves(ListShelvesRequest request) + *
                                                                                                                                                      • listShelves(ListShelvesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listShelvesPagedCallable() - *
                                                                                                                                                      • listShelvesCallable() + *
                                                                                                                                                      • listShelvesPagedCallable() + *
                                                                                                                                                      • listShelvesCallable() *
                                                                                                                                                      - * + * * * * DeleteShelf @@ -144,18 +144,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteShelf(DeleteShelfRequest request) + *
                                                                                                                                                      • deleteShelf(DeleteShelfRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteShelf(ShelfName name) - *
                                                                                                                                                      • deleteShelf(String name) + *
                                                                                                                                                      • deleteShelf(ShelfName name) + *
                                                                                                                                                      • deleteShelf(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteShelfCallable() + *
                                                                                                                                                      • deleteShelfCallable() *
                                                                                                                                                      - * + * * * * MergeShelves @@ -169,20 +169,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • mergeShelves(MergeShelvesRequest request) + *
                                                                                                                                                      • mergeShelves(MergeShelvesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • mergeShelves(ShelfName name, ShelfName otherShelf) - *
                                                                                                                                                      • mergeShelves(ShelfName name, String otherShelf) - *
                                                                                                                                                      • mergeShelves(String name, ShelfName otherShelf) - *
                                                                                                                                                      • mergeShelves(String name, String otherShelf) + *
                                                                                                                                                      • mergeShelves(ShelfName name, ShelfName otherShelf) + *
                                                                                                                                                      • mergeShelves(ShelfName name, String otherShelf) + *
                                                                                                                                                      • mergeShelves(String name, ShelfName otherShelf) + *
                                                                                                                                                      • mergeShelves(String name, String otherShelf) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • mergeShelvesCallable() + *
                                                                                                                                                      • mergeShelvesCallable() *
                                                                                                                                                      - * + * * * * CreateBook @@ -190,18 +190,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBook(CreateBookRequest request) + *
                                                                                                                                                      • createBook(CreateBookRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBook(ShelfName parent, Book book) - *
                                                                                                                                                      • createBook(String parent, Book book) + *
                                                                                                                                                      • createBook(ShelfName parent, Book book) + *
                                                                                                                                                      • createBook(String parent, Book book) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBookCallable() + *
                                                                                                                                                      • createBookCallable() *
                                                                                                                                                      - * + * * * * GetBook @@ -209,18 +209,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBook(GetBookRequest request) + *
                                                                                                                                                      • getBook(GetBookRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBook(BookName name) - *
                                                                                                                                                      • getBook(String name) + *
                                                                                                                                                      • getBook(BookName name) + *
                                                                                                                                                      • getBook(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBookCallable() + *
                                                                                                                                                      • getBookCallable() *
                                                                                                                                                      - * + * * * * ListBooks @@ -230,19 +230,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBooks(ListBooksRequest request) + *
                                                                                                                                                      • listBooks(ListBooksRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBooks(ShelfName parent) - *
                                                                                                                                                      • listBooks(String parent) + *
                                                                                                                                                      • listBooks(ShelfName parent) + *
                                                                                                                                                      • listBooks(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBooksPagedCallable() - *
                                                                                                                                                      • listBooksCallable() + *
                                                                                                                                                      • listBooksPagedCallable() + *
                                                                                                                                                      • listBooksCallable() *
                                                                                                                                                      - * + * * * * DeleteBook @@ -250,18 +250,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBook(DeleteBookRequest request) + *
                                                                                                                                                      • deleteBook(DeleteBookRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBook(BookName name) - *
                                                                                                                                                      • deleteBook(String name) + *
                                                                                                                                                      • deleteBook(BookName name) + *
                                                                                                                                                      • deleteBook(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBookCallable() + *
                                                                                                                                                      • deleteBookCallable() *
                                                                                                                                                      - * + * * * * UpdateBook @@ -270,17 +270,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBook(UpdateBookRequest request) + *
                                                                                                                                                      • updateBook(UpdateBookRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBook(Book book, FieldMask updateMask) + *
                                                                                                                                                      • updateBook(Book book, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBookCallable() + *
                                                                                                                                                      • updateBookCallable() *
                                                                                                                                                      - * + * * * * MoveBook @@ -289,20 +289,21 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • moveBook(MoveBookRequest request) + *
                                                                                                                                                      • moveBook(MoveBookRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • moveBook(BookName name, ShelfName otherShelfName) - *
                                                                                                                                                      • moveBook(BookName name, String otherShelfName) - *
                                                                                                                                                      • moveBook(String name, ShelfName otherShelfName) - *
                                                                                                                                                      • moveBook(String name, String otherShelfName) + *
                                                                                                                                                      • moveBook(BookName name, ShelfName otherShelfName) + *
                                                                                                                                                      • moveBook(BookName name, String otherShelfName) + *
                                                                                                                                                      • moveBook(String name, ShelfName otherShelfName) + *
                                                                                                                                                      • moveBook(String name, String otherShelfName) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • moveBookCallable() + *
                                                                                                                                                      • moveBookCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java index f4538279ff..dc3f61327a 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/ConfigClient.java @@ -125,22 +125,22 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBuckets(ListBucketsRequest request) + *
                                                                                                                                                      • listBuckets(ListBucketsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBuckets(BillingAccountLocationName parent) - *
                                                                                                                                                      • listBuckets(FolderLocationName parent) - *
                                                                                                                                                      • listBuckets(LocationName parent) - *
                                                                                                                                                      • listBuckets(OrganizationLocationName parent) - *
                                                                                                                                                      • listBuckets(String parent) + *
                                                                                                                                                      • listBuckets(BillingAccountLocationName parent) + *
                                                                                                                                                      • listBuckets(FolderLocationName parent) + *
                                                                                                                                                      • listBuckets(LocationName parent) + *
                                                                                                                                                      • listBuckets(OrganizationLocationName parent) + *
                                                                                                                                                      • listBuckets(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBucketsPagedCallable() - *
                                                                                                                                                      • listBucketsCallable() + *
                                                                                                                                                      • listBucketsPagedCallable() + *
                                                                                                                                                      • listBucketsCallable() *
                                                                                                                                                      - * + * * * * GetBucket @@ -148,13 +148,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBucket(GetBucketRequest request) + *
                                                                                                                                                      • getBucket(GetBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBucketCallable() + *
                                                                                                                                                      • getBucketCallable() *
                                                                                                                                                      - * + * * * * CreateBucket @@ -163,13 +163,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBucket(CreateBucketRequest request) + *
                                                                                                                                                      • createBucket(CreateBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBucketCallable() + *
                                                                                                                                                      • createBucketCallable() *
                                                                                                                                                      - * + * * * * UpdateBucket @@ -186,13 +186,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBucket(UpdateBucketRequest request) + *
                                                                                                                                                      • updateBucket(UpdateBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBucketCallable() + *
                                                                                                                                                      • updateBucketCallable() *
                                                                                                                                                      - * + * * * * DeleteBucket @@ -204,13 +204,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBucket(DeleteBucketRequest request) + *
                                                                                                                                                      • deleteBucket(DeleteBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBucketCallable() + *
                                                                                                                                                      • deleteBucketCallable() *
                                                                                                                                                      - * + * * * * UndeleteBucket @@ -219,13 +219,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • undeleteBucket(UndeleteBucketRequest request) + *
                                                                                                                                                      • undeleteBucket(UndeleteBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • undeleteBucketCallable() + *
                                                                                                                                                      • undeleteBucketCallable() *
                                                                                                                                                      - * + * * * * ListViews @@ -233,18 +233,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listViews(ListViewsRequest request) + *
                                                                                                                                                      • listViews(ListViewsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listViews(String parent) + *
                                                                                                                                                      • listViews(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listViewsPagedCallable() - *
                                                                                                                                                      • listViewsCallable() + *
                                                                                                                                                      • listViewsPagedCallable() + *
                                                                                                                                                      • listViewsCallable() *
                                                                                                                                                      - * + * * * * GetView @@ -252,13 +252,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getView(GetViewRequest request) + *
                                                                                                                                                      • getView(GetViewRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getViewCallable() + *
                                                                                                                                                      • getViewCallable() *
                                                                                                                                                      - * + * * * * CreateView @@ -267,13 +267,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createView(CreateViewRequest request) + *
                                                                                                                                                      • createView(CreateViewRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createViewCallable() + *
                                                                                                                                                      • createViewCallable() *
                                                                                                                                                      - * + * * * * UpdateView @@ -285,13 +285,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateView(UpdateViewRequest request) + *
                                                                                                                                                      • updateView(UpdateViewRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateViewCallable() + *
                                                                                                                                                      • updateViewCallable() *
                                                                                                                                                      - * + * * * * DeleteView @@ -302,13 +302,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteView(DeleteViewRequest request) + *
                                                                                                                                                      • deleteView(DeleteViewRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteViewCallable() + *
                                                                                                                                                      • deleteViewCallable() *
                                                                                                                                                      - * + * * * * ListSinks @@ -316,22 +316,22 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSinks(ListSinksRequest request) + *
                                                                                                                                                      • listSinks(ListSinksRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSinks(BillingAccountName parent) - *
                                                                                                                                                      • listSinks(FolderName parent) - *
                                                                                                                                                      • listSinks(OrganizationName parent) - *
                                                                                                                                                      • listSinks(ProjectName parent) - *
                                                                                                                                                      • listSinks(String parent) + *
                                                                                                                                                      • listSinks(BillingAccountName parent) + *
                                                                                                                                                      • listSinks(FolderName parent) + *
                                                                                                                                                      • listSinks(OrganizationName parent) + *
                                                                                                                                                      • listSinks(ProjectName parent) + *
                                                                                                                                                      • listSinks(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSinksPagedCallable() - *
                                                                                                                                                      • listSinksCallable() + *
                                                                                                                                                      • listSinksPagedCallable() + *
                                                                                                                                                      • listSinksCallable() *
                                                                                                                                                      - * + * * * * GetSink @@ -339,18 +339,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSink(GetSinkRequest request) + *
                                                                                                                                                      • getSink(GetSinkRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSink(LogSinkName sinkName) - *
                                                                                                                                                      • getSink(String sinkName) + *
                                                                                                                                                      • getSink(LogSinkName sinkName) + *
                                                                                                                                                      • getSink(String sinkName) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSinkCallable() + *
                                                                                                                                                      • getSinkCallable() *
                                                                                                                                                      - * + * * * * CreateSink @@ -361,21 +361,21 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSink(CreateSinkRequest request) + *
                                                                                                                                                      • createSink(CreateSinkRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSink(BillingAccountName parent, LogSink sink) - *
                                                                                                                                                      • createSink(FolderName parent, LogSink sink) - *
                                                                                                                                                      • createSink(OrganizationName parent, LogSink sink) - *
                                                                                                                                                      • createSink(ProjectName parent, LogSink sink) - *
                                                                                                                                                      • createSink(String parent, LogSink sink) + *
                                                                                                                                                      • createSink(BillingAccountName parent, LogSink sink) + *
                                                                                                                                                      • createSink(FolderName parent, LogSink sink) + *
                                                                                                                                                      • createSink(OrganizationName parent, LogSink sink) + *
                                                                                                                                                      • createSink(ProjectName parent, LogSink sink) + *
                                                                                                                                                      • createSink(String parent, LogSink sink) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSinkCallable() + *
                                                                                                                                                      • createSinkCallable() *
                                                                                                                                                      - * + * * * * UpdateSink @@ -387,20 +387,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSink(UpdateSinkRequest request) + *
                                                                                                                                                      • updateSink(UpdateSinkRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSink(LogSinkName sinkName, LogSink sink) - *
                                                                                                                                                      • updateSink(String sinkName, LogSink sink) - *
                                                                                                                                                      • updateSink(LogSinkName sinkName, LogSink sink, FieldMask updateMask) - *
                                                                                                                                                      • updateSink(String sinkName, LogSink sink, FieldMask updateMask) + *
                                                                                                                                                      • updateSink(LogSinkName sinkName, LogSink sink) + *
                                                                                                                                                      • updateSink(String sinkName, LogSink sink) + *
                                                                                                                                                      • updateSink(LogSinkName sinkName, LogSink sink, FieldMask updateMask) + *
                                                                                                                                                      • updateSink(String sinkName, LogSink sink, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSinkCallable() + *
                                                                                                                                                      • updateSinkCallable() *
                                                                                                                                                      - * + * * * * DeleteSink @@ -409,18 +409,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSink(DeleteSinkRequest request) + *
                                                                                                                                                      • deleteSink(DeleteSinkRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSink(LogSinkName sinkName) - *
                                                                                                                                                      • deleteSink(String sinkName) + *
                                                                                                                                                      • deleteSink(LogSinkName sinkName) + *
                                                                                                                                                      • deleteSink(String sinkName) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSinkCallable() + *
                                                                                                                                                      • deleteSinkCallable() *
                                                                                                                                                      - * + * * * * ListExclusions @@ -428,22 +428,22 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listExclusions(ListExclusionsRequest request) + *
                                                                                                                                                      • listExclusions(ListExclusionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listExclusions(BillingAccountName parent) - *
                                                                                                                                                      • listExclusions(FolderName parent) - *
                                                                                                                                                      • listExclusions(OrganizationName parent) - *
                                                                                                                                                      • listExclusions(ProjectName parent) - *
                                                                                                                                                      • listExclusions(String parent) + *
                                                                                                                                                      • listExclusions(BillingAccountName parent) + *
                                                                                                                                                      • listExclusions(FolderName parent) + *
                                                                                                                                                      • listExclusions(OrganizationName parent) + *
                                                                                                                                                      • listExclusions(ProjectName parent) + *
                                                                                                                                                      • listExclusions(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listExclusionsPagedCallable() - *
                                                                                                                                                      • listExclusionsCallable() + *
                                                                                                                                                      • listExclusionsPagedCallable() + *
                                                                                                                                                      • listExclusionsCallable() *
                                                                                                                                                      - * + * * * * GetExclusion @@ -451,18 +451,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getExclusion(GetExclusionRequest request) + *
                                                                                                                                                      • getExclusion(GetExclusionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getExclusion(LogExclusionName name) - *
                                                                                                                                                      • getExclusion(String name) + *
                                                                                                                                                      • getExclusion(LogExclusionName name) + *
                                                                                                                                                      • getExclusion(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getExclusionCallable() + *
                                                                                                                                                      • getExclusionCallable() *
                                                                                                                                                      - * + * * * * CreateExclusion @@ -472,21 +472,21 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createExclusion(CreateExclusionRequest request) + *
                                                                                                                                                      • createExclusion(CreateExclusionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createExclusion(BillingAccountName parent, LogExclusion exclusion) - *
                                                                                                                                                      • createExclusion(FolderName parent, LogExclusion exclusion) - *
                                                                                                                                                      • createExclusion(OrganizationName parent, LogExclusion exclusion) - *
                                                                                                                                                      • createExclusion(ProjectName parent, LogExclusion exclusion) - *
                                                                                                                                                      • createExclusion(String parent, LogExclusion exclusion) + *
                                                                                                                                                      • createExclusion(BillingAccountName parent, LogExclusion exclusion) + *
                                                                                                                                                      • createExclusion(FolderName parent, LogExclusion exclusion) + *
                                                                                                                                                      • createExclusion(OrganizationName parent, LogExclusion exclusion) + *
                                                                                                                                                      • createExclusion(ProjectName parent, LogExclusion exclusion) + *
                                                                                                                                                      • createExclusion(String parent, LogExclusion exclusion) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createExclusionCallable() + *
                                                                                                                                                      • createExclusionCallable() *
                                                                                                                                                      - * + * * * * UpdateExclusion @@ -495,18 +495,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateExclusion(UpdateExclusionRequest request) + *
                                                                                                                                                      • updateExclusion(UpdateExclusionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateExclusion(LogExclusionName name, LogExclusion exclusion, FieldMask updateMask) - *
                                                                                                                                                      • updateExclusion(String name, LogExclusion exclusion, FieldMask updateMask) + *
                                                                                                                                                      • updateExclusion(LogExclusionName name, LogExclusion exclusion, FieldMask updateMask) + *
                                                                                                                                                      • updateExclusion(String name, LogExclusion exclusion, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateExclusionCallable() + *
                                                                                                                                                      • updateExclusionCallable() *
                                                                                                                                                      - * + * * * * DeleteExclusion @@ -514,18 +514,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteExclusion(DeleteExclusionRequest request) + *
                                                                                                                                                      • deleteExclusion(DeleteExclusionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteExclusion(LogExclusionName name) - *
                                                                                                                                                      • deleteExclusion(String name) + *
                                                                                                                                                      • deleteExclusion(LogExclusionName name) + *
                                                                                                                                                      • deleteExclusion(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteExclusionCallable() + *
                                                                                                                                                      • deleteExclusionCallable() *
                                                                                                                                                      - * + * * * * GetCmekSettings @@ -542,13 +542,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCmekSettings(GetCmekSettingsRequest request) + *
                                                                                                                                                      • getCmekSettings(GetCmekSettingsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getCmekSettingsCallable() + *
                                                                                                                                                      • getCmekSettingsCallable() *
                                                                                                                                                      - * + * * * * UpdateCmekSettings @@ -570,13 +570,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCmekSettings(UpdateCmekSettingsRequest request) + *
                                                                                                                                                      • updateCmekSettings(UpdateCmekSettingsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateCmekSettingsCallable() + *
                                                                                                                                                      • updateCmekSettingsCallable() *
                                                                                                                                                      - * + * * * * GetSettings @@ -593,18 +593,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSettings(GetSettingsRequest request) + *
                                                                                                                                                      • getSettings(GetSettingsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSettings(SettingsName name) - *
                                                                                                                                                      • getSettings(String name) + *
                                                                                                                                                      • getSettings(SettingsName name) + *
                                                                                                                                                      • getSettings(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSettingsCallable() + *
                                                                                                                                                      • getSettingsCallable() *
                                                                                                                                                      - * + * * * * UpdateSettings @@ -627,17 +627,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSettings(UpdateSettingsRequest request) + *
                                                                                                                                                      • updateSettings(UpdateSettingsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSettings(Settings settings, FieldMask updateMask) + *
                                                                                                                                                      • updateSettings(Settings settings, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSettingsCallable() + *
                                                                                                                                                      • updateSettingsCallable() *
                                                                                                                                                      - * + * * * * CopyLogEntries @@ -645,14 +645,15 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • copyLogEntriesAsync(CopyLogEntriesRequest request) + *
                                                                                                                                                      • copyLogEntriesAsync(CopyLogEntriesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • copyLogEntriesOperationCallable() - *
                                                                                                                                                      • copyLogEntriesCallable() + *
                                                                                                                                                      • copyLogEntriesOperationCallable() + *
                                                                                                                                                      • copyLogEntriesCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java index ce6e5be9e6..6690d5c40f 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/LoggingClient.java @@ -90,18 +90,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteLog(DeleteLogRequest request) + *
                                                                                                                                                      • deleteLog(DeleteLogRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteLog(LogName logName) - *
                                                                                                                                                      • deleteLog(String logName) + *
                                                                                                                                                      • deleteLog(LogName logName) + *
                                                                                                                                                      • deleteLog(String logName) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteLogCallable() + *
                                                                                                                                                      • deleteLogCallable() *
                                                                                                                                                      - * + * * * * WriteLogEntries @@ -115,18 +115,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • writeLogEntries(WriteLogEntriesRequest request) + *
                                                                                                                                                      • writeLogEntries(WriteLogEntriesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • writeLogEntries(LogName logName, MonitoredResource resource, Map labels, List entries) - *
                                                                                                                                                      • writeLogEntries(String logName, MonitoredResource resource, Map labels, List entries) + *
                                                                                                                                                      • writeLogEntries(LogName logName, MonitoredResource resource, Map labels, List entries) + *
                                                                                                                                                      • writeLogEntries(String logName, MonitoredResource resource, Map labels, List entries) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • writeLogEntriesCallable() + *
                                                                                                                                                      • writeLogEntriesCallable() *
                                                                                                                                                      - * + * * * * ListLogEntries @@ -137,18 +137,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogEntries(ListLogEntriesRequest request) + *
                                                                                                                                                      • listLogEntries(ListLogEntriesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogEntries(List resourceNames, String filter, String orderBy) + *
                                                                                                                                                      • listLogEntries(List resourceNames, String filter, String orderBy) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogEntriesPagedCallable() - *
                                                                                                                                                      • listLogEntriesCallable() + *
                                                                                                                                                      • listLogEntriesPagedCallable() + *
                                                                                                                                                      • listLogEntriesCallable() *
                                                                                                                                                      - * + * * * * ListMonitoredResourceDescriptors @@ -156,14 +156,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request) + *
                                                                                                                                                      • listMonitoredResourceDescriptors(ListMonitoredResourceDescriptorsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listMonitoredResourceDescriptorsPagedCallable() - *
                                                                                                                                                      • listMonitoredResourceDescriptorsCallable() + *
                                                                                                                                                      • listMonitoredResourceDescriptorsPagedCallable() + *
                                                                                                                                                      • listMonitoredResourceDescriptorsCallable() *
                                                                                                                                                      - * + * * * * ListLogs @@ -172,22 +172,22 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogs(ListLogsRequest request) + *
                                                                                                                                                      • listLogs(ListLogsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogs(BillingAccountName parent) - *
                                                                                                                                                      • listLogs(FolderName parent) - *
                                                                                                                                                      • listLogs(OrganizationName parent) - *
                                                                                                                                                      • listLogs(ProjectName parent) - *
                                                                                                                                                      • listLogs(String parent) + *
                                                                                                                                                      • listLogs(BillingAccountName parent) + *
                                                                                                                                                      • listLogs(FolderName parent) + *
                                                                                                                                                      • listLogs(OrganizationName parent) + *
                                                                                                                                                      • listLogs(ProjectName parent) + *
                                                                                                                                                      • listLogs(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogsPagedCallable() - *
                                                                                                                                                      • listLogsCallable() + *
                                                                                                                                                      • listLogsPagedCallable() + *
                                                                                                                                                      • listLogsCallable() *
                                                                                                                                                      - * + * * * * TailLogEntries @@ -196,9 +196,10 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • tailLogEntriesCallable() + *
                                                                                                                                                      • tailLogEntriesCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java index afa0852655..ac38b44464 100644 --- a/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java +++ b/test/integration/goldens/logging/src/com/google/cloud/logging/v2/MetricsClient.java @@ -75,19 +75,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogMetrics(ListLogMetricsRequest request) + *
                                                                                                                                                      • listLogMetrics(ListLogMetricsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogMetrics(ProjectName parent) - *
                                                                                                                                                      • listLogMetrics(String parent) + *
                                                                                                                                                      • listLogMetrics(ProjectName parent) + *
                                                                                                                                                      • listLogMetrics(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listLogMetricsPagedCallable() - *
                                                                                                                                                      • listLogMetricsCallable() + *
                                                                                                                                                      • listLogMetricsPagedCallable() + *
                                                                                                                                                      • listLogMetricsCallable() *
                                                                                                                                                      - * + * * * * GetLogMetric @@ -95,18 +95,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLogMetric(GetLogMetricRequest request) + *
                                                                                                                                                      • getLogMetric(GetLogMetricRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLogMetric(LogMetricName metricName) - *
                                                                                                                                                      • getLogMetric(String metricName) + *
                                                                                                                                                      • getLogMetric(LogMetricName metricName) + *
                                                                                                                                                      • getLogMetric(String metricName) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getLogMetricCallable() + *
                                                                                                                                                      • getLogMetricCallable() *
                                                                                                                                                      - * + * * * * CreateLogMetric @@ -114,18 +114,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createLogMetric(CreateLogMetricRequest request) + *
                                                                                                                                                      • createLogMetric(CreateLogMetricRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createLogMetric(ProjectName parent, LogMetric metric) - *
                                                                                                                                                      • createLogMetric(String parent, LogMetric metric) + *
                                                                                                                                                      • createLogMetric(ProjectName parent, LogMetric metric) + *
                                                                                                                                                      • createLogMetric(String parent, LogMetric metric) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createLogMetricCallable() + *
                                                                                                                                                      • createLogMetricCallable() *
                                                                                                                                                      - * + * * * * UpdateLogMetric @@ -133,18 +133,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateLogMetric(UpdateLogMetricRequest request) + *
                                                                                                                                                      • updateLogMetric(UpdateLogMetricRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateLogMetric(LogMetricName metricName, LogMetric metric) - *
                                                                                                                                                      • updateLogMetric(String metricName, LogMetric metric) + *
                                                                                                                                                      • updateLogMetric(LogMetricName metricName, LogMetric metric) + *
                                                                                                                                                      • updateLogMetric(String metricName, LogMetric metric) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateLogMetricCallable() + *
                                                                                                                                                      • updateLogMetricCallable() *
                                                                                                                                                      - * + * * * * DeleteLogMetric @@ -152,18 +152,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteLogMetric(DeleteLogMetricRequest request) + *
                                                                                                                                                      • deleteLogMetric(DeleteLogMetricRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteLogMetric(LogMetricName metricName) - *
                                                                                                                                                      • deleteLogMetric(String metricName) + *
                                                                                                                                                      • deleteLogMetric(LogMetricName metricName) + *
                                                                                                                                                      • deleteLogMetric(String metricName) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteLogMetricCallable() + *
                                                                                                                                                      • deleteLogMetricCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java index 04a97ca302..0b191d15cc 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SchemaServiceClient.java @@ -90,18 +90,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSchema(CreateSchemaRequest request) + *
                                                                                                                                                      • createSchema(CreateSchemaRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSchema(ProjectName parent, Schema schema, String schemaId) - *
                                                                                                                                                      • createSchema(String parent, Schema schema, String schemaId) + *
                                                                                                                                                      • createSchema(ProjectName parent, Schema schema, String schemaId) + *
                                                                                                                                                      • createSchema(String parent, Schema schema, String schemaId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSchemaCallable() + *
                                                                                                                                                      • createSchemaCallable() *
                                                                                                                                                      - * + * * * * GetSchema @@ -109,18 +109,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSchema(GetSchemaRequest request) + *
                                                                                                                                                      • getSchema(GetSchemaRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSchema(SchemaName name) - *
                                                                                                                                                      • getSchema(String name) + *
                                                                                                                                                      • getSchema(SchemaName name) + *
                                                                                                                                                      • getSchema(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSchemaCallable() + *
                                                                                                                                                      • getSchemaCallable() *
                                                                                                                                                      - * + * * * * ListSchemas @@ -128,19 +128,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSchemas(ListSchemasRequest request) + *
                                                                                                                                                      • listSchemas(ListSchemasRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSchemas(ProjectName parent) - *
                                                                                                                                                      • listSchemas(String parent) + *
                                                                                                                                                      • listSchemas(ProjectName parent) + *
                                                                                                                                                      • listSchemas(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSchemasPagedCallable() - *
                                                                                                                                                      • listSchemasCallable() + *
                                                                                                                                                      • listSchemasPagedCallable() + *
                                                                                                                                                      • listSchemasCallable() *
                                                                                                                                                      - * + * * * * ListSchemaRevisions @@ -148,19 +148,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSchemaRevisions(ListSchemaRevisionsRequest request) + *
                                                                                                                                                      • listSchemaRevisions(ListSchemaRevisionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSchemaRevisions(SchemaName name) - *
                                                                                                                                                      • listSchemaRevisions(String name) + *
                                                                                                                                                      • listSchemaRevisions(SchemaName name) + *
                                                                                                                                                      • listSchemaRevisions(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSchemaRevisionsPagedCallable() - *
                                                                                                                                                      • listSchemaRevisionsCallable() + *
                                                                                                                                                      • listSchemaRevisionsPagedCallable() + *
                                                                                                                                                      • listSchemaRevisionsCallable() *
                                                                                                                                                      - * + * * * * CommitSchema @@ -168,18 +168,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • commitSchema(CommitSchemaRequest request) + *
                                                                                                                                                      • commitSchema(CommitSchemaRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • commitSchema(SchemaName name, Schema schema) - *
                                                                                                                                                      • commitSchema(String name, Schema schema) + *
                                                                                                                                                      • commitSchema(SchemaName name, Schema schema) + *
                                                                                                                                                      • commitSchema(String name, Schema schema) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • commitSchemaCallable() + *
                                                                                                                                                      • commitSchemaCallable() *
                                                                                                                                                      - * + * * * * RollbackSchema @@ -187,18 +187,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rollbackSchema(RollbackSchemaRequest request) + *
                                                                                                                                                      • rollbackSchema(RollbackSchemaRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rollbackSchema(SchemaName name, String revisionId) - *
                                                                                                                                                      • rollbackSchema(String name, String revisionId) + *
                                                                                                                                                      • rollbackSchema(SchemaName name, String revisionId) + *
                                                                                                                                                      • rollbackSchema(String name, String revisionId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rollbackSchemaCallable() + *
                                                                                                                                                      • rollbackSchemaCallable() *
                                                                                                                                                      - * + * * * * DeleteSchemaRevision @@ -206,18 +206,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSchemaRevision(DeleteSchemaRevisionRequest request) + *
                                                                                                                                                      • deleteSchemaRevision(DeleteSchemaRevisionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSchemaRevision(SchemaName name, String revisionId) - *
                                                                                                                                                      • deleteSchemaRevision(String name, String revisionId) + *
                                                                                                                                                      • deleteSchemaRevision(SchemaName name, String revisionId) + *
                                                                                                                                                      • deleteSchemaRevision(String name, String revisionId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSchemaRevisionCallable() + *
                                                                                                                                                      • deleteSchemaRevisionCallable() *
                                                                                                                                                      - * + * * * * DeleteSchema @@ -225,18 +225,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSchema(DeleteSchemaRequest request) + *
                                                                                                                                                      • deleteSchema(DeleteSchemaRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSchema(SchemaName name) - *
                                                                                                                                                      • deleteSchema(String name) + *
                                                                                                                                                      • deleteSchema(SchemaName name) + *
                                                                                                                                                      • deleteSchema(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSchemaCallable() + *
                                                                                                                                                      • deleteSchemaCallable() *
                                                                                                                                                      - * + * * * * ValidateSchema @@ -244,18 +244,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • validateSchema(ValidateSchemaRequest request) + *
                                                                                                                                                      • validateSchema(ValidateSchemaRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • validateSchema(ProjectName parent, Schema schema) - *
                                                                                                                                                      • validateSchema(String parent, Schema schema) + *
                                                                                                                                                      • validateSchema(ProjectName parent, Schema schema) + *
                                                                                                                                                      • validateSchema(String parent, Schema schema) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • validateSchemaCallable() + *
                                                                                                                                                      • validateSchemaCallable() *
                                                                                                                                                      - * + * * * * ValidateMessage @@ -263,13 +263,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • validateMessage(ValidateMessageRequest request) + *
                                                                                                                                                      • validateMessage(ValidateMessageRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • validateMessageCallable() + *
                                                                                                                                                      • validateMessageCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -281,13 +281,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -296,13 +296,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -316,13 +316,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java index 7253bdc237..e400953590 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/SubscriptionAdminClient.java @@ -116,20 +116,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSubscription(Subscription request) + *
                                                                                                                                                      • createSubscription(Subscription request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSubscription(SubscriptionName name, TopicName topic, PushConfig pushConfig, ackDeadlineSeconds) - *
                                                                                                                                                      • createSubscription(SubscriptionName name, String topic, PushConfig pushConfig, ackDeadlineSeconds) - *
                                                                                                                                                      • createSubscription(String name, TopicName topic, PushConfig pushConfig, ackDeadlineSeconds) - *
                                                                                                                                                      • createSubscription(String name, String topic, PushConfig pushConfig, ackDeadlineSeconds) + *
                                                                                                                                                      • createSubscription(SubscriptionName name, TopicName topic, PushConfig pushConfig, int ackDeadlineSeconds) + *
                                                                                                                                                      • createSubscription(SubscriptionName name, String topic, PushConfig pushConfig, int ackDeadlineSeconds) + *
                                                                                                                                                      • createSubscription(String name, TopicName topic, PushConfig pushConfig, int ackDeadlineSeconds) + *
                                                                                                                                                      • createSubscription(String name, String topic, PushConfig pushConfig, int ackDeadlineSeconds) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSubscriptionCallable() + *
                                                                                                                                                      • createSubscriptionCallable() *
                                                                                                                                                      - * + * * * * GetSubscription @@ -137,18 +137,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSubscription(GetSubscriptionRequest request) + *
                                                                                                                                                      • getSubscription(GetSubscriptionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSubscription(SubscriptionName subscription) - *
                                                                                                                                                      • getSubscription(String subscription) + *
                                                                                                                                                      • getSubscription(SubscriptionName subscription) + *
                                                                                                                                                      • getSubscription(String subscription) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSubscriptionCallable() + *
                                                                                                                                                      • getSubscriptionCallable() *
                                                                                                                                                      - * + * * * * UpdateSubscription @@ -157,13 +157,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSubscription(UpdateSubscriptionRequest request) + *
                                                                                                                                                      • updateSubscription(UpdateSubscriptionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSubscriptionCallable() + *
                                                                                                                                                      • updateSubscriptionCallable() *
                                                                                                                                                      - * + * * * * ListSubscriptions @@ -171,19 +171,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSubscriptions(ListSubscriptionsRequest request) + *
                                                                                                                                                      • listSubscriptions(ListSubscriptionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSubscriptions(ProjectName project) - *
                                                                                                                                                      • listSubscriptions(String project) + *
                                                                                                                                                      • listSubscriptions(ProjectName project) + *
                                                                                                                                                      • listSubscriptions(String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSubscriptionsPagedCallable() - *
                                                                                                                                                      • listSubscriptionsCallable() + *
                                                                                                                                                      • listSubscriptionsPagedCallable() + *
                                                                                                                                                      • listSubscriptionsCallable() *
                                                                                                                                                      - * + * * * * DeleteSubscription @@ -195,18 +195,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSubscription(DeleteSubscriptionRequest request) + *
                                                                                                                                                      • deleteSubscription(DeleteSubscriptionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSubscription(SubscriptionName subscription) - *
                                                                                                                                                      • deleteSubscription(String subscription) + *
                                                                                                                                                      • deleteSubscription(SubscriptionName subscription) + *
                                                                                                                                                      • deleteSubscription(String subscription) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSubscriptionCallable() + *
                                                                                                                                                      • deleteSubscriptionCallable() *
                                                                                                                                                      - * + * * * * ModifyAckDeadline @@ -218,18 +218,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • modifyAckDeadline(ModifyAckDeadlineRequest request) + *
                                                                                                                                                      • modifyAckDeadline(ModifyAckDeadlineRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • modifyAckDeadline(SubscriptionName subscription, List ackIds, ackDeadlineSeconds) - *
                                                                                                                                                      • modifyAckDeadline(String subscription, List ackIds, ackDeadlineSeconds) + *
                                                                                                                                                      • modifyAckDeadline(SubscriptionName subscription, List ackIds, int ackDeadlineSeconds) + *
                                                                                                                                                      • modifyAckDeadline(String subscription, List ackIds, int ackDeadlineSeconds) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • modifyAckDeadlineCallable() + *
                                                                                                                                                      • modifyAckDeadlineCallable() *
                                                                                                                                                      - * + * * * * Acknowledge @@ -243,18 +243,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • acknowledge(AcknowledgeRequest request) + *
                                                                                                                                                      • acknowledge(AcknowledgeRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • acknowledge(SubscriptionName subscription, List ackIds) - *
                                                                                                                                                      • acknowledge(String subscription, List ackIds) + *
                                                                                                                                                      • acknowledge(SubscriptionName subscription, List ackIds) + *
                                                                                                                                                      • acknowledge(String subscription, List ackIds) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • acknowledgeCallable() + *
                                                                                                                                                      • acknowledgeCallable() *
                                                                                                                                                      - * + * * * * Pull @@ -264,20 +264,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pull(PullRequest request) + *
                                                                                                                                                      • pull(PullRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pull(SubscriptionName subscription, maxMessages) - *
                                                                                                                                                      • pull(String subscription, maxMessages) - *
                                                                                                                                                      • pull(SubscriptionName subscription, returnImmediately, maxMessages) - *
                                                                                                                                                      • pull(String subscription, returnImmediately, maxMessages) + *
                                                                                                                                                      • pull(SubscriptionName subscription, int maxMessages) + *
                                                                                                                                                      • pull(String subscription, int maxMessages) + *
                                                                                                                                                      • pull(SubscriptionName subscription, boolean returnImmediately, int maxMessages) + *
                                                                                                                                                      • pull(String subscription, boolean returnImmediately, int maxMessages) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • pullCallable() + *
                                                                                                                                                      • pullCallable() *
                                                                                                                                                      - * + * * * * StreamingPull @@ -291,9 +291,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • streamingPullCallable() + *
                                                                                                                                                      • streamingPullCallable() *
                                                                                                                                                      - * + * * * * ModifyPushConfig @@ -306,18 +306,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • modifyPushConfig(ModifyPushConfigRequest request) + *
                                                                                                                                                      • modifyPushConfig(ModifyPushConfigRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • modifyPushConfig(SubscriptionName subscription, PushConfig pushConfig) - *
                                                                                                                                                      • modifyPushConfig(String subscription, PushConfig pushConfig) + *
                                                                                                                                                      • modifyPushConfig(SubscriptionName subscription, PushConfig pushConfig) + *
                                                                                                                                                      • modifyPushConfig(String subscription, PushConfig pushConfig) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • modifyPushConfigCallable() + *
                                                                                                                                                      • modifyPushConfigCallable() *
                                                                                                                                                      - * + * * * * GetSnapshot @@ -329,18 +329,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSnapshot(GetSnapshotRequest request) + *
                                                                                                                                                      • getSnapshot(GetSnapshotRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSnapshot(SnapshotName snapshot) - *
                                                                                                                                                      • getSnapshot(String snapshot) + *
                                                                                                                                                      • getSnapshot(SnapshotName snapshot) + *
                                                                                                                                                      • getSnapshot(String snapshot) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getSnapshotCallable() + *
                                                                                                                                                      • getSnapshotCallable() *
                                                                                                                                                      - * + * * * * ListSnapshots @@ -352,19 +352,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSnapshots(ListSnapshotsRequest request) + *
                                                                                                                                                      • listSnapshots(ListSnapshotsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSnapshots(ProjectName project) - *
                                                                                                                                                      • listSnapshots(String project) + *
                                                                                                                                                      • listSnapshots(ProjectName project) + *
                                                                                                                                                      • listSnapshots(String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listSnapshotsPagedCallable() - *
                                                                                                                                                      • listSnapshotsCallable() + *
                                                                                                                                                      • listSnapshotsPagedCallable() + *
                                                                                                                                                      • listSnapshotsCallable() *
                                                                                                                                                      - * + * * * * CreateSnapshot @@ -387,20 +387,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSnapshot(CreateSnapshotRequest request) + *
                                                                                                                                                      • createSnapshot(CreateSnapshotRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSnapshot(SnapshotName name, SubscriptionName subscription) - *
                                                                                                                                                      • createSnapshot(SnapshotName name, String subscription) - *
                                                                                                                                                      • createSnapshot(String name, SubscriptionName subscription) - *
                                                                                                                                                      • createSnapshot(String name, String subscription) + *
                                                                                                                                                      • createSnapshot(SnapshotName name, SubscriptionName subscription) + *
                                                                                                                                                      • createSnapshot(SnapshotName name, String subscription) + *
                                                                                                                                                      • createSnapshot(String name, SubscriptionName subscription) + *
                                                                                                                                                      • createSnapshot(String name, String subscription) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createSnapshotCallable() + *
                                                                                                                                                      • createSnapshotCallable() *
                                                                                                                                                      - * + * * * * UpdateSnapshot @@ -413,13 +413,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSnapshot(UpdateSnapshotRequest request) + *
                                                                                                                                                      • updateSnapshot(UpdateSnapshotRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateSnapshotCallable() + *
                                                                                                                                                      • updateSnapshotCallable() *
                                                                                                                                                      - * + * * * * DeleteSnapshot @@ -435,18 +435,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSnapshot(DeleteSnapshotRequest request) + *
                                                                                                                                                      • deleteSnapshot(DeleteSnapshotRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSnapshot(SnapshotName snapshot) - *
                                                                                                                                                      • deleteSnapshot(String snapshot) + *
                                                                                                                                                      • deleteSnapshot(SnapshotName snapshot) + *
                                                                                                                                                      • deleteSnapshot(String snapshot) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteSnapshotCallable() + *
                                                                                                                                                      • deleteSnapshotCallable() *
                                                                                                                                                      - * + * * * * Seek @@ -460,13 +460,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • seek(SeekRequest request) + *
                                                                                                                                                      • seek(SeekRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • seekCallable() + *
                                                                                                                                                      • seekCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -478,13 +478,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -493,13 +493,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -513,13 +513,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java index 26e70821b1..7d6e4b9249 100644 --- a/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java +++ b/test/integration/goldens/pubsub/src/com/google/cloud/pubsub/v1/TopicAdminClient.java @@ -90,18 +90,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createTopic(Topic request) + *
                                                                                                                                                      • createTopic(Topic request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createTopic(TopicName name) - *
                                                                                                                                                      • createTopic(String name) + *
                                                                                                                                                      • createTopic(TopicName name) + *
                                                                                                                                                      • createTopic(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createTopicCallable() + *
                                                                                                                                                      • createTopicCallable() *
                                                                                                                                                      - * + * * * * UpdateTopic @@ -110,13 +110,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateTopic(UpdateTopicRequest request) + *
                                                                                                                                                      • updateTopic(UpdateTopicRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateTopicCallable() + *
                                                                                                                                                      • updateTopicCallable() *
                                                                                                                                                      - * + * * * * Publish @@ -125,18 +125,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • publish(PublishRequest request) + *
                                                                                                                                                      • publish(PublishRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • publish(TopicName topic, List messages) - *
                                                                                                                                                      • publish(String topic, List messages) + *
                                                                                                                                                      • publish(TopicName topic, List messages) + *
                                                                                                                                                      • publish(String topic, List messages) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • publishCallable() + *
                                                                                                                                                      • publishCallable() *
                                                                                                                                                      - * + * * * * GetTopic @@ -144,18 +144,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getTopic(GetTopicRequest request) + *
                                                                                                                                                      • getTopic(GetTopicRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getTopic(TopicName topic) - *
                                                                                                                                                      • getTopic(String topic) + *
                                                                                                                                                      • getTopic(TopicName topic) + *
                                                                                                                                                      • getTopic(String topic) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getTopicCallable() + *
                                                                                                                                                      • getTopicCallable() *
                                                                                                                                                      - * + * * * * ListTopics @@ -163,19 +163,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopics(ListTopicsRequest request) + *
                                                                                                                                                      • listTopics(ListTopicsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopics(ProjectName project) - *
                                                                                                                                                      • listTopics(String project) + *
                                                                                                                                                      • listTopics(ProjectName project) + *
                                                                                                                                                      • listTopics(String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopicsPagedCallable() - *
                                                                                                                                                      • listTopicsCallable() + *
                                                                                                                                                      • listTopicsPagedCallable() + *
                                                                                                                                                      • listTopicsCallable() *
                                                                                                                                                      - * + * * * * ListTopicSubscriptions @@ -183,19 +183,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopicSubscriptions(ListTopicSubscriptionsRequest request) + *
                                                                                                                                                      • listTopicSubscriptions(ListTopicSubscriptionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopicSubscriptions(TopicName topic) - *
                                                                                                                                                      • listTopicSubscriptions(String topic) + *
                                                                                                                                                      • listTopicSubscriptions(TopicName topic) + *
                                                                                                                                                      • listTopicSubscriptions(String topic) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopicSubscriptionsPagedCallable() - *
                                                                                                                                                      • listTopicSubscriptionsCallable() + *
                                                                                                                                                      • listTopicSubscriptionsPagedCallable() + *
                                                                                                                                                      • listTopicSubscriptionsCallable() *
                                                                                                                                                      - * + * * * * ListTopicSnapshots @@ -207,19 +207,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopicSnapshots(ListTopicSnapshotsRequest request) + *
                                                                                                                                                      • listTopicSnapshots(ListTopicSnapshotsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopicSnapshots(TopicName topic) - *
                                                                                                                                                      • listTopicSnapshots(String topic) + *
                                                                                                                                                      • listTopicSnapshots(TopicName topic) + *
                                                                                                                                                      • listTopicSnapshots(String topic) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listTopicSnapshotsPagedCallable() - *
                                                                                                                                                      • listTopicSnapshotsCallable() + *
                                                                                                                                                      • listTopicSnapshotsPagedCallable() + *
                                                                                                                                                      • listTopicSnapshotsCallable() *
                                                                                                                                                      - * + * * * * DeleteTopic @@ -231,18 +231,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteTopic(DeleteTopicRequest request) + *
                                                                                                                                                      • deleteTopic(DeleteTopicRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteTopic(TopicName topic) - *
                                                                                                                                                      • deleteTopic(String topic) + *
                                                                                                                                                      • deleteTopic(TopicName topic) + *
                                                                                                                                                      • deleteTopic(String topic) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteTopicCallable() + *
                                                                                                                                                      • deleteTopicCallable() *
                                                                                                                                                      - * + * * * * DetachSubscription @@ -253,13 +253,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • detachSubscription(DetachSubscriptionRequest request) + *
                                                                                                                                                      • detachSubscription(DetachSubscriptionRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • detachSubscriptionCallable() + *
                                                                                                                                                      • detachSubscriptionCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -271,13 +271,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -286,13 +286,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -306,13 +306,14 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java index 737a0c56cf..64ce17a14e 100644 --- a/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java +++ b/test/integration/goldens/redis/src/com/google/cloud/redis/v1beta1/CloudRedisClient.java @@ -101,19 +101,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listInstances(ListInstancesRequest request) + *
                                                                                                                                                      • listInstances(ListInstancesRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listInstances(LocationName parent) - *
                                                                                                                                                      • listInstances(String parent) + *
                                                                                                                                                      • listInstances(LocationName parent) + *
                                                                                                                                                      • listInstances(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listInstancesPagedCallable() - *
                                                                                                                                                      • listInstancesCallable() + *
                                                                                                                                                      • listInstancesPagedCallable() + *
                                                                                                                                                      • listInstancesCallable() *
                                                                                                                                                      - * + * * * * GetInstance @@ -121,18 +121,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getInstance(GetInstanceRequest request) + *
                                                                                                                                                      • getInstance(GetInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getInstance(InstanceName name) - *
                                                                                                                                                      • getInstance(String name) + *
                                                                                                                                                      • getInstance(InstanceName name) + *
                                                                                                                                                      • getInstance(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getInstanceCallable() + *
                                                                                                                                                      • getInstanceCallable() *
                                                                                                                                                      - * + * * * * GetInstanceAuthString @@ -142,18 +142,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getInstanceAuthString(GetInstanceAuthStringRequest request) + *
                                                                                                                                                      • getInstanceAuthString(GetInstanceAuthStringRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getInstanceAuthString(InstanceName name) - *
                                                                                                                                                      • getInstanceAuthString(String name) + *
                                                                                                                                                      • getInstanceAuthString(InstanceName name) + *
                                                                                                                                                      • getInstanceAuthString(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getInstanceAuthStringCallable() + *
                                                                                                                                                      • getInstanceAuthStringCallable() *
                                                                                                                                                      - * + * * * * CreateInstance @@ -172,19 +172,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createInstanceAsync(CreateInstanceRequest request) + *
                                                                                                                                                      • createInstanceAsync(CreateInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createInstanceAsync(LocationName parent, String instanceId, Instance instance) - *
                                                                                                                                                      • createInstanceAsync(String parent, String instanceId, Instance instance) + *
                                                                                                                                                      • createInstanceAsync(LocationName parent, String instanceId, Instance instance) + *
                                                                                                                                                      • createInstanceAsync(String parent, String instanceId, Instance instance) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createInstanceOperationCallable() - *
                                                                                                                                                      • createInstanceCallable() + *
                                                                                                                                                      • createInstanceOperationCallable() + *
                                                                                                                                                      • createInstanceCallable() *
                                                                                                                                                      - * + * * * * UpdateInstance @@ -196,18 +196,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateInstanceAsync(UpdateInstanceRequest request) + *
                                                                                                                                                      • updateInstanceAsync(UpdateInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateInstanceAsync(FieldMask updateMask, Instance instance) + *
                                                                                                                                                      • updateInstanceAsync(FieldMask updateMask, Instance instance) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateInstanceOperationCallable() - *
                                                                                                                                                      • updateInstanceCallable() + *
                                                                                                                                                      • updateInstanceOperationCallable() + *
                                                                                                                                                      • updateInstanceCallable() *
                                                                                                                                                      - * + * * * * UpgradeInstance @@ -216,19 +216,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • upgradeInstanceAsync(UpgradeInstanceRequest request) + *
                                                                                                                                                      • upgradeInstanceAsync(UpgradeInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • upgradeInstanceAsync(InstanceName name, String redisVersion) - *
                                                                                                                                                      • upgradeInstanceAsync(String name, String redisVersion) + *
                                                                                                                                                      • upgradeInstanceAsync(InstanceName name, String redisVersion) + *
                                                                                                                                                      • upgradeInstanceAsync(String name, String redisVersion) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • upgradeInstanceOperationCallable() - *
                                                                                                                                                      • upgradeInstanceCallable() + *
                                                                                                                                                      • upgradeInstanceOperationCallable() + *
                                                                                                                                                      • upgradeInstanceCallable() *
                                                                                                                                                      - * + * * * * ImportInstance @@ -243,18 +243,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • importInstanceAsync(ImportInstanceRequest request) + *
                                                                                                                                                      • importInstanceAsync(ImportInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • importInstanceAsync(String name, InputConfig inputConfig) + *
                                                                                                                                                      • importInstanceAsync(String name, InputConfig inputConfig) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • importInstanceOperationCallable() - *
                                                                                                                                                      • importInstanceCallable() + *
                                                                                                                                                      • importInstanceOperationCallable() + *
                                                                                                                                                      • importInstanceCallable() *
                                                                                                                                                      - * + * * * * ExportInstance @@ -267,18 +267,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • exportInstanceAsync(ExportInstanceRequest request) + *
                                                                                                                                                      • exportInstanceAsync(ExportInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • exportInstanceAsync(String name, OutputConfig outputConfig) + *
                                                                                                                                                      • exportInstanceAsync(String name, OutputConfig outputConfig) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • exportInstanceOperationCallable() - *
                                                                                                                                                      • exportInstanceCallable() + *
                                                                                                                                                      • exportInstanceOperationCallable() + *
                                                                                                                                                      • exportInstanceCallable() *
                                                                                                                                                      - * + * * * * FailoverInstance @@ -287,19 +287,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • failoverInstanceAsync(FailoverInstanceRequest request) + *
                                                                                                                                                      • failoverInstanceAsync(FailoverInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • failoverInstanceAsync(InstanceName name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) - *
                                                                                                                                                      • failoverInstanceAsync(String name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) + *
                                                                                                                                                      • failoverInstanceAsync(InstanceName name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) + *
                                                                                                                                                      • failoverInstanceAsync(String name, FailoverInstanceRequest.DataProtectionMode dataProtectionMode) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • failoverInstanceOperationCallable() - *
                                                                                                                                                      • failoverInstanceCallable() + *
                                                                                                                                                      • failoverInstanceOperationCallable() + *
                                                                                                                                                      • failoverInstanceCallable() *
                                                                                                                                                      - * + * * * * DeleteInstance @@ -308,19 +308,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteInstanceAsync(DeleteInstanceRequest request) + *
                                                                                                                                                      • deleteInstanceAsync(DeleteInstanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteInstanceAsync(InstanceName name) - *
                                                                                                                                                      • deleteInstanceAsync(String name) + *
                                                                                                                                                      • deleteInstanceAsync(InstanceName name) + *
                                                                                                                                                      • deleteInstanceAsync(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteInstanceOperationCallable() - *
                                                                                                                                                      • deleteInstanceCallable() + *
                                                                                                                                                      • deleteInstanceOperationCallable() + *
                                                                                                                                                      • deleteInstanceCallable() *
                                                                                                                                                      - * + * * * * RescheduleMaintenance @@ -329,19 +329,20 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) + *
                                                                                                                                                      • rescheduleMaintenanceAsync(RescheduleMaintenanceRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Methods that return long-running operations have "Async" method variants that return `OperationFuture`, which is used to track polling of the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rescheduleMaintenanceAsync(InstanceName name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) - *
                                                                                                                                                      • rescheduleMaintenanceAsync(String name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) + *
                                                                                                                                                      • rescheduleMaintenanceAsync(InstanceName name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) + *
                                                                                                                                                      • rescheduleMaintenanceAsync(String name, RescheduleMaintenanceRequest.RescheduleType rescheduleType, Timestamp scheduleTime) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rescheduleMaintenanceOperationCallable() - *
                                                                                                                                                      • rescheduleMaintenanceCallable() + *
                                                                                                                                                      • rescheduleMaintenanceOperationCallable() + *
                                                                                                                                                      • rescheduleMaintenanceCallable() *
                                                                                                                                                      - * + * + * * * * diff --git a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java index 790ddf7b33..361af38658 100644 --- a/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java +++ b/test/integration/goldens/storage/src/com/google/storage/v2/StorageClient.java @@ -89,18 +89,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBucket(DeleteBucketRequest request) + *
                                                                                                                                                      • deleteBucket(DeleteBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBucket(BucketName name) - *
                                                                                                                                                      • deleteBucket(String name) + *
                                                                                                                                                      • deleteBucket(BucketName name) + *
                                                                                                                                                      • deleteBucket(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteBucketCallable() + *
                                                                                                                                                      • deleteBucketCallable() *
                                                                                                                                                      - * + * * * * GetBucket @@ -108,18 +108,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBucket(GetBucketRequest request) + *
                                                                                                                                                      • getBucket(GetBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBucket(BucketName name) - *
                                                                                                                                                      • getBucket(String name) + *
                                                                                                                                                      • getBucket(BucketName name) + *
                                                                                                                                                      • getBucket(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getBucketCallable() + *
                                                                                                                                                      • getBucketCallable() *
                                                                                                                                                      - * + * * * * CreateBucket @@ -127,18 +127,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBucket(CreateBucketRequest request) + *
                                                                                                                                                      • createBucket(CreateBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBucket(ProjectName parent, Bucket bucket, String bucketId) - *
                                                                                                                                                      • createBucket(String parent, Bucket bucket, String bucketId) + *
                                                                                                                                                      • createBucket(ProjectName parent, Bucket bucket, String bucketId) + *
                                                                                                                                                      • createBucket(String parent, Bucket bucket, String bucketId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createBucketCallable() + *
                                                                                                                                                      • createBucketCallable() *
                                                                                                                                                      - * + * * * * ListBuckets @@ -146,19 +146,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBuckets(ListBucketsRequest request) + *
                                                                                                                                                      • listBuckets(ListBucketsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBuckets(ProjectName parent) - *
                                                                                                                                                      • listBuckets(String parent) + *
                                                                                                                                                      • listBuckets(ProjectName parent) + *
                                                                                                                                                      • listBuckets(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listBucketsPagedCallable() - *
                                                                                                                                                      • listBucketsCallable() + *
                                                                                                                                                      • listBucketsPagedCallable() + *
                                                                                                                                                      • listBucketsCallable() *
                                                                                                                                                      - * + * * * * LockBucketRetentionPolicy @@ -166,18 +166,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) + *
                                                                                                                                                      • lockBucketRetentionPolicy(LockBucketRetentionPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • lockBucketRetentionPolicy(BucketName bucket) - *
                                                                                                                                                      • lockBucketRetentionPolicy(String bucket) + *
                                                                                                                                                      • lockBucketRetentionPolicy(BucketName bucket) + *
                                                                                                                                                      • lockBucketRetentionPolicy(String bucket) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • lockBucketRetentionPolicyCallable() + *
                                                                                                                                                      • lockBucketRetentionPolicyCallable() *
                                                                                                                                                      - * + * * * * GetIamPolicy @@ -188,18 +188,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) + *
                                                                                                                                                      • getIamPolicy(GetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicy(ResourceName resource) - *
                                                                                                                                                      • getIamPolicy(String resource) + *
                                                                                                                                                      • getIamPolicy(ResourceName resource) + *
                                                                                                                                                      • getIamPolicy(String resource) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getIamPolicyCallable() + *
                                                                                                                                                      • getIamPolicyCallable() *
                                                                                                                                                      - * + * * * * SetIamPolicy @@ -210,18 +210,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) + *
                                                                                                                                                      • setIamPolicy(SetIamPolicyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicy(ResourceName resource, Policy policy) - *
                                                                                                                                                      • setIamPolicy(String resource, Policy policy) + *
                                                                                                                                                      • setIamPolicy(ResourceName resource, Policy policy) + *
                                                                                                                                                      • setIamPolicy(String resource, Policy policy) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • setIamPolicyCallable() + *
                                                                                                                                                      • setIamPolicyCallable() *
                                                                                                                                                      - * + * * * * TestIamPermissions @@ -233,18 +233,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) + *
                                                                                                                                                      • testIamPermissions(TestIamPermissionsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissions(ResourceName resource, List permissions) - *
                                                                                                                                                      • testIamPermissions(String resource, List permissions) + *
                                                                                                                                                      • testIamPermissions(ResourceName resource, List permissions) + *
                                                                                                                                                      • testIamPermissions(String resource, List permissions) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • testIamPermissionsCallable() + *
                                                                                                                                                      • testIamPermissionsCallable() *
                                                                                                                                                      - * + * * * * UpdateBucket @@ -252,17 +252,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBucket(UpdateBucketRequest request) + *
                                                                                                                                                      • updateBucket(UpdateBucketRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBucket(Bucket bucket, FieldMask updateMask) + *
                                                                                                                                                      • updateBucket(Bucket bucket, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateBucketCallable() + *
                                                                                                                                                      • updateBucketCallable() *
                                                                                                                                                      - * + * * * * DeleteNotification @@ -270,18 +270,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteNotification(DeleteNotificationRequest request) + *
                                                                                                                                                      • deleteNotification(DeleteNotificationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteNotification(NotificationName name) - *
                                                                                                                                                      • deleteNotification(String name) + *
                                                                                                                                                      • deleteNotification(NotificationName name) + *
                                                                                                                                                      • deleteNotification(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteNotificationCallable() + *
                                                                                                                                                      • deleteNotificationCallable() *
                                                                                                                                                      - * + * * * * GetNotification @@ -289,18 +289,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getNotification(GetNotificationRequest request) + *
                                                                                                                                                      • getNotification(GetNotificationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getNotification(BucketName name) - *
                                                                                                                                                      • getNotification(String name) + *
                                                                                                                                                      • getNotification(BucketName name) + *
                                                                                                                                                      • getNotification(String name) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getNotificationCallable() + *
                                                                                                                                                      • getNotificationCallable() *
                                                                                                                                                      - * + * * * * CreateNotification @@ -311,18 +311,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createNotification(CreateNotificationRequest request) + *
                                                                                                                                                      • createNotification(CreateNotificationRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createNotification(ProjectName parent, Notification notification) - *
                                                                                                                                                      • createNotification(String parent, Notification notification) + *
                                                                                                                                                      • createNotification(ProjectName parent, Notification notification) + *
                                                                                                                                                      • createNotification(String parent, Notification notification) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createNotificationCallable() + *
                                                                                                                                                      • createNotificationCallable() *
                                                                                                                                                      - * + * * * * ListNotifications @@ -330,19 +330,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listNotifications(ListNotificationsRequest request) + *
                                                                                                                                                      • listNotifications(ListNotificationsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listNotifications(ProjectName parent) - *
                                                                                                                                                      • listNotifications(String parent) + *
                                                                                                                                                      • listNotifications(ProjectName parent) + *
                                                                                                                                                      • listNotifications(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listNotificationsPagedCallable() - *
                                                                                                                                                      • listNotificationsCallable() + *
                                                                                                                                                      • listNotificationsPagedCallable() + *
                                                                                                                                                      • listNotificationsCallable() *
                                                                                                                                                      - * + * * * * ComposeObject @@ -351,13 +351,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • composeObject(ComposeObjectRequest request) + *
                                                                                                                                                      • composeObject(ComposeObjectRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • composeObjectCallable() + *
                                                                                                                                                      • composeObjectCallable() *
                                                                                                                                                      - * + * * * * DeleteObject @@ -366,18 +366,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteObject(DeleteObjectRequest request) + *
                                                                                                                                                      • deleteObject(DeleteObjectRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteObject(String bucket, String object) - *
                                                                                                                                                      • deleteObject(String bucket, String object, generation) + *
                                                                                                                                                      • deleteObject(String bucket, String object) + *
                                                                                                                                                      • deleteObject(String bucket, String object, long generation) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteObjectCallable() + *
                                                                                                                                                      • deleteObjectCallable() *
                                                                                                                                                      - * + * * * * CancelResumableWrite @@ -385,17 +385,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • cancelResumableWrite(CancelResumableWriteRequest request) + *
                                                                                                                                                      • cancelResumableWrite(CancelResumableWriteRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • cancelResumableWrite(String uploadId) + *
                                                                                                                                                      • cancelResumableWrite(String uploadId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • cancelResumableWriteCallable() + *
                                                                                                                                                      • cancelResumableWriteCallable() *
                                                                                                                                                      - * + * * * * GetObject @@ -403,18 +403,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getObject(GetObjectRequest request) + *
                                                                                                                                                      • getObject(GetObjectRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getObject(String bucket, String object) - *
                                                                                                                                                      • getObject(String bucket, String object, generation) + *
                                                                                                                                                      • getObject(String bucket, String object) + *
                                                                                                                                                      • getObject(String bucket, String object, long generation) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getObjectCallable() + *
                                                                                                                                                      • getObjectCallable() *
                                                                                                                                                      - * + * * * * ReadObject @@ -422,9 +422,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • readObjectCallable() + *
                                                                                                                                                      • readObjectCallable() *
                                                                                                                                                      - * + * * * * UpdateObject @@ -433,17 +433,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateObject(UpdateObjectRequest request) + *
                                                                                                                                                      • updateObject(UpdateObjectRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateObject(Object object, FieldMask updateMask) + *
                                                                                                                                                      • updateObject(Object object, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateObjectCallable() + *
                                                                                                                                                      • updateObjectCallable() *
                                                                                                                                                      - * + * * * * WriteObject @@ -502,9 +502,9 @@ * *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • writeObjectCallable() + *
                                                                                                                                                      • writeObjectCallable() *
                                                                                                                                                      - * + * * * * ListObjects @@ -512,19 +512,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listObjects(ListObjectsRequest request) + *
                                                                                                                                                      • listObjects(ListObjectsRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listObjects(ProjectName parent) - *
                                                                                                                                                      • listObjects(String parent) + *
                                                                                                                                                      • listObjects(ProjectName parent) + *
                                                                                                                                                      • listObjects(String parent) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listObjectsPagedCallable() - *
                                                                                                                                                      • listObjectsCallable() + *
                                                                                                                                                      • listObjectsPagedCallable() + *
                                                                                                                                                      • listObjectsCallable() *
                                                                                                                                                      - * + * * * * RewriteObject @@ -533,13 +533,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rewriteObject(RewriteObjectRequest request) + *
                                                                                                                                                      • rewriteObject(RewriteObjectRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • rewriteObjectCallable() + *
                                                                                                                                                      • rewriteObjectCallable() *
                                                                                                                                                      - * + * * * * StartResumableWrite @@ -549,13 +549,13 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • startResumableWrite(StartResumableWriteRequest request) + *
                                                                                                                                                      • startResumableWrite(StartResumableWriteRequest request) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • startResumableWriteCallable() + *
                                                                                                                                                      • startResumableWriteCallable() *
                                                                                                                                                      - * + * * * * QueryWriteStatus @@ -575,17 +575,17 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • queryWriteStatus(QueryWriteStatusRequest request) + *
                                                                                                                                                      • queryWriteStatus(QueryWriteStatusRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • queryWriteStatus(String uploadId) + *
                                                                                                                                                      • queryWriteStatus(String uploadId) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • queryWriteStatusCallable() + *
                                                                                                                                                      • queryWriteStatusCallable() *
                                                                                                                                                      - * + * * * * GetServiceAccount @@ -593,18 +593,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getServiceAccount(GetServiceAccountRequest request) + *
                                                                                                                                                      • getServiceAccount(GetServiceAccountRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getServiceAccount(ProjectName project) - *
                                                                                                                                                      • getServiceAccount(String project) + *
                                                                                                                                                      • getServiceAccount(ProjectName project) + *
                                                                                                                                                      • getServiceAccount(String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getServiceAccountCallable() + *
                                                                                                                                                      • getServiceAccountCallable() *
                                                                                                                                                      - * + * * * * CreateHmacKey @@ -612,18 +612,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createHmacKey(CreateHmacKeyRequest request) + *
                                                                                                                                                      • createHmacKey(CreateHmacKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createHmacKey(ProjectName project, String serviceAccountEmail) - *
                                                                                                                                                      • createHmacKey(String project, String serviceAccountEmail) + *
                                                                                                                                                      • createHmacKey(ProjectName project, String serviceAccountEmail) + *
                                                                                                                                                      • createHmacKey(String project, String serviceAccountEmail) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • createHmacKeyCallable() + *
                                                                                                                                                      • createHmacKeyCallable() *
                                                                                                                                                      - * + * * * * DeleteHmacKey @@ -631,18 +631,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteHmacKey(DeleteHmacKeyRequest request) + *
                                                                                                                                                      • deleteHmacKey(DeleteHmacKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteHmacKey(String accessId, ProjectName project) - *
                                                                                                                                                      • deleteHmacKey(String accessId, String project) + *
                                                                                                                                                      • deleteHmacKey(String accessId, ProjectName project) + *
                                                                                                                                                      • deleteHmacKey(String accessId, String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • deleteHmacKeyCallable() + *
                                                                                                                                                      • deleteHmacKeyCallable() *
                                                                                                                                                      - * + * * * * GetHmacKey @@ -650,18 +650,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getHmacKey(GetHmacKeyRequest request) + *
                                                                                                                                                      • getHmacKey(GetHmacKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getHmacKey(String accessId, ProjectName project) - *
                                                                                                                                                      • getHmacKey(String accessId, String project) + *
                                                                                                                                                      • getHmacKey(String accessId, ProjectName project) + *
                                                                                                                                                      • getHmacKey(String accessId, String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • getHmacKeyCallable() + *
                                                                                                                                                      • getHmacKeyCallable() *
                                                                                                                                                      - * + * * * * ListHmacKeys @@ -669,19 +669,19 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listHmacKeys(ListHmacKeysRequest request) + *
                                                                                                                                                      • listHmacKeys(ListHmacKeysRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listHmacKeys(ProjectName project) - *
                                                                                                                                                      • listHmacKeys(String project) + *
                                                                                                                                                      • listHmacKeys(ProjectName project) + *
                                                                                                                                                      • listHmacKeys(String project) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • listHmacKeysPagedCallable() - *
                                                                                                                                                      • listHmacKeysCallable() + *
                                                                                                                                                      • listHmacKeysPagedCallable() + *
                                                                                                                                                      • listHmacKeysCallable() *
                                                                                                                                                      - * + * * * * UpdateHmacKey @@ -689,17 +689,18 @@ * *

                                                                                                                                                      Request object method variants only take one parameter, a request object, which must be constructed before the call.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateHmacKey(UpdateHmacKeyRequest request) + *
                                                                                                                                                      • updateHmacKey(UpdateHmacKeyRequest request) *
                                                                                                                                                      *

                                                                                                                                                      "Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateHmacKey(HmacKeyMetadata hmacKey, FieldMask updateMask) + *
                                                                                                                                                      • updateHmacKey(HmacKeyMetadata hmacKey, FieldMask updateMask) *
                                                                                                                                                      *

                                                                                                                                                      Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.

                                                                                                                                                      *
                                                                                                                                                        - *
                                                                                                                                                      • updateHmacKeyCallable() + *
                                                                                                                                                      • updateHmacKeyCallable() *
                                                                                                                                                      - * + * + * * * *