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

Commit

Permalink
docs: generate sample code in the Java microgenerator (#324)
Browse files Browse the repository at this point in the history 
This PR was generated using Autosynth. 🌈

Synth log will be available here:
https://source.cloud.google.com/results/invocations/89bbfe8d-0991-4bf5-9ea3-b2a25748a524/targets

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

PiperOrigin-RevId: 356341083
Source-Link: googleapis/googleapis@8d8c008
  • Loading branch information
@yoshi-automation
yoshi-automation committed Feb 9, 2021
1 parent d67e613 commit c6549ef
Show file tree
Hide file tree
Showing 4 changed files with 266 additions and 7 deletions.
251 changes: 251 additions & 0 deletions ...sapproval/src/main/java/com/google/cloud/accessapproval/v1/AccessApprovalAdminClient.java
View file
Expand Up @@ -70,6 +70,13 @@
* <p>This class provides the ability to make remote calls to the backing service through method
* calls that map to API methods. Sample code to get started:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* String name = "name3373707";
* ApprovalRequest response = accessApprovalAdminClient.getApprovalRequest(name);
* }
* }</pre>
*
* <p>Note: close() needs to be called on the AccessApprovalAdminClient object to clean up resources
* such as threads. In the example above, try-with-resources is used, which automatically calls
* close().
Expand Down Expand Up @@ -177,6 +184,18 @@ public AccessApprovalStub getStub() {
* Lists approval requests associated with a project, folder, or organization. Approval requests
* can be filtered by state (pending, active, dismissed). The order is reverse chronological.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* String parent = "parent-995424086";
* for (ApprovalRequest element :
* accessApprovalAdminClient.listApprovalRequests(parent).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }</pre>
*
* @param parent The parent resource. This may be "projects/{project_id}", "folders/{folder_id}",
* or "organizations/{organization_id}".
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
Expand All @@ -192,6 +211,24 @@ public final ListApprovalRequestsPagedResponse listApprovalRequests(String paren
* Lists approval requests associated with a project, folder, or organization. Approval requests
* can be filtered by state (pending, active, dismissed). The order is reverse chronological.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* ListApprovalRequestsMessage request =
* ListApprovalRequestsMessage.newBuilder()
* .setParent("parent-995424086")
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* for (ApprovalRequest element :
* accessApprovalAdminClient.listApprovalRequests(request).iterateAll()) {
* // doThingsWith(element);
* }
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -206,6 +243,24 @@ public final ListApprovalRequestsPagedResponse listApprovalRequests(
* can be filtered by state (pending, active, dismissed). The order is reverse chronological.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* ListApprovalRequestsMessage request =
* ListApprovalRequestsMessage.newBuilder()
* .setParent("parent-995424086")
* .setFilter("filter-1274492040")
* .setPageSize(883849137)
* .setPageToken("pageToken873572522")
* .build();
* ApiFuture<ApprovalRequest> future =
* accessApprovalAdminClient.listApprovalRequestsPagedCallable().futureCall(request);
* // Do something.
* for (ApprovalRequest element : future.get().iterateAll()) {
* // doThingsWith(element);
* }
* }
* }</pre>
*/
public final UnaryCallable<ListApprovalRequestsMessage, ListApprovalRequestsPagedResponse>
listApprovalRequestsPagedCallable() {
Expand All @@ -218,6 +273,24 @@ public final ListApprovalRequestsPagedResponse listApprovalRequests(
* can be filtered by state (pending, active, dismissed). The order is reverse chronological.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* while (true) {
* ListApprovalRequestsResponse response =
* accessApprovalAdminClient.listApprovalRequestsCallable().call(request);
* for (ApprovalRequest element : response.getResponsesList()) {
* // doThingsWith(element);
* }
* String nextPageToken = response.getNextPageToken();
* if (!Strings.isNullOrEmpty(nextPageToken)) {
* request = request.toBuilder().setPageToken(nextPageToken).build();
* } else {
* break;
* }
* }
* }
* }</pre>
*/
public final UnaryCallable<ListApprovalRequestsMessage, ListApprovalRequestsResponse>
listApprovalRequestsCallable() {
Expand All @@ -228,6 +301,15 @@ public final ListApprovalRequestsPagedResponse listApprovalRequests(
/**
* Gets an approval request. Returns NOT_FOUND if the request does not exist.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* String name = "name3373707";
* ApprovalRequest response = accessApprovalAdminClient.getApprovalRequest(name);
* }
* }</pre>
*
* @param name Name of the approval request to retrieve.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -241,6 +323,16 @@ public final ApprovalRequest getApprovalRequest(String name) {
/**
* Gets an approval request. Returns NOT_FOUND if the request does not exist.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* GetApprovalRequestMessage request =
* GetApprovalRequestMessage.newBuilder().setName("name3373707").build();
* ApprovalRequest response = accessApprovalAdminClient.getApprovalRequest(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -253,6 +345,17 @@ public final ApprovalRequest getApprovalRequest(GetApprovalRequestMessage reques
* Gets an approval request. Returns NOT_FOUND if the request does not exist.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* GetApprovalRequestMessage request =
* GetApprovalRequestMessage.newBuilder().setName("name3373707").build();
* ApiFuture<ApprovalRequest> future =
* accessApprovalAdminClient.getApprovalRequestCallable().futureCall(request);
* // Do something.
* ApprovalRequest response = future.get();
* }
* }</pre>
*/
public final UnaryCallable<GetApprovalRequestMessage, ApprovalRequest>
getApprovalRequestCallable() {
Expand All @@ -266,6 +369,19 @@ public final ApprovalRequest getApprovalRequest(GetApprovalRequestMessage reques
* <p>Returns NOT_FOUND if the request does not exist. Returns FAILED_PRECONDITION if the request
* exists but is not in a pending state.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* ApproveApprovalRequestMessage request =
* ApproveApprovalRequestMessage.newBuilder()
* .setName("name3373707")
* .setExpireTime(Timestamp.newBuilder().build())
* .build();
* ApprovalRequest response = accessApprovalAdminClient.approveApprovalRequest(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -281,6 +397,20 @@ public final ApprovalRequest approveApprovalRequest(ApproveApprovalRequestMessag
* exists but is not in a pending state.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* ApproveApprovalRequestMessage request =
* ApproveApprovalRequestMessage.newBuilder()
* .setName("name3373707")
* .setExpireTime(Timestamp.newBuilder().build())
* .build();
* ApiFuture<ApprovalRequest> future =
* accessApprovalAdminClient.approveApprovalRequestCallable().futureCall(request);
* // Do something.
* ApprovalRequest response = future.get();
* }
* }</pre>
*/
public final UnaryCallable<ApproveApprovalRequestMessage, ApprovalRequest>
approveApprovalRequestCallable() {
Expand All @@ -298,6 +428,16 @@ public final ApprovalRequest approveApprovalRequest(ApproveApprovalRequestMessag
*
* <p>Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* DismissApprovalRequestMessage request =
* DismissApprovalRequestMessage.newBuilder().setName("name3373707").build();
* ApprovalRequest response = accessApprovalAdminClient.dismissApprovalRequest(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -317,6 +457,17 @@ public final ApprovalRequest dismissApprovalRequest(DismissApprovalRequestMessag
* <p>Returns FAILED_PRECONDITION if the request exists but is not in a pending state.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* DismissApprovalRequestMessage request =
* DismissApprovalRequestMessage.newBuilder().setName("name3373707").build();
* ApiFuture<ApprovalRequest> future =
* accessApprovalAdminClient.dismissApprovalRequestCallable().futureCall(request);
* // Do something.
* ApprovalRequest response = future.get();
* }
* }</pre>
*/
public final UnaryCallable<DismissApprovalRequestMessage, ApprovalRequest>
dismissApprovalRequestCallable() {
Expand All @@ -327,6 +478,15 @@ public final ApprovalRequest dismissApprovalRequest(DismissApprovalRequestMessag
/**
* Gets the settings associated with a project, folder, or organization.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* String name = "name3373707";
* AccessApprovalSettings response = accessApprovalAdminClient.getAccessApprovalSettings(name);
* }
* }</pre>
*
* @param name Name of the AccessApprovalSettings to retrieve.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -340,6 +500,17 @@ public final AccessApprovalSettings getAccessApprovalSettings(String name) {
/**
* Gets the settings associated with a project, folder, or organization.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* GetAccessApprovalSettingsMessage request =
* GetAccessApprovalSettingsMessage.newBuilder().setName("name3373707").build();
* AccessApprovalSettings response =
* accessApprovalAdminClient.getAccessApprovalSettings(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -353,6 +524,17 @@ public final AccessApprovalSettings getAccessApprovalSettings(
* Gets the settings associated with a project, folder, or organization.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* GetAccessApprovalSettingsMessage request =
* GetAccessApprovalSettingsMessage.newBuilder().setName("name3373707").build();
* ApiFuture<AccessApprovalSettings> future =
* accessApprovalAdminClient.getAccessApprovalSettingsCallable().futureCall(request);
* // Do something.
* AccessApprovalSettings response = future.get();
* }
* }</pre>
*/
public final UnaryCallable<GetAccessApprovalSettingsMessage, AccessApprovalSettings>
getAccessApprovalSettingsCallable() {
Expand All @@ -364,6 +546,17 @@ public final AccessApprovalSettings getAccessApprovalSettings(
* Updates the settings associated with a project, folder, or organization. Settings to update are
* determined by the value of field_mask.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* AccessApprovalSettings settings = AccessApprovalSettings.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
* AccessApprovalSettings response =
* accessApprovalAdminClient.updateAccessApprovalSettings(settings, updateMask);
* }
* }</pre>
*
* @param settings The new AccessApprovalSettings.
* @param updateMask The update mask applies to the settings. Only the top level fields of
* AccessApprovalSettings (notification_emails &amp; enrolled_services) are supported. For
Expand All @@ -389,6 +582,20 @@ public final AccessApprovalSettings updateAccessApprovalSettings(
* Updates the settings associated with a project, folder, or organization. Settings to update are
* determined by the value of field_mask.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* UpdateAccessApprovalSettingsMessage request =
* UpdateAccessApprovalSettingsMessage.newBuilder()
* .setSettings(AccessApprovalSettings.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* AccessApprovalSettings response =
* accessApprovalAdminClient.updateAccessApprovalSettings(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -403,6 +610,20 @@ public final AccessApprovalSettings updateAccessApprovalSettings(
* determined by the value of field_mask.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* UpdateAccessApprovalSettingsMessage request =
* UpdateAccessApprovalSettingsMessage.newBuilder()
* .setSettings(AccessApprovalSettings.newBuilder().build())
* .setUpdateMask(FieldMask.newBuilder().build())
* .build();
* ApiFuture<AccessApprovalSettings> future =
* accessApprovalAdminClient.updateAccessApprovalSettingsCallable().futureCall(request);
* // Do something.
* AccessApprovalSettings response = future.get();
* }
* }</pre>
*/
public final UnaryCallable<UpdateAccessApprovalSettingsMessage, AccessApprovalSettings>
updateAccessApprovalSettingsCallable() {
Expand All @@ -417,6 +638,15 @@ public final AccessApprovalSettings updateAccessApprovalSettings(
* of the hierarchy, then Access Approval will still be enabled at this level as the settings are
* inherited.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* String name = "name3373707";
* accessApprovalAdminClient.deleteAccessApprovalSettings(name);
* }
* }</pre>
*
* @param name Name of the AccessApprovalSettings to delete.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -434,6 +664,16 @@ public final void deleteAccessApprovalSettings(String name) {
* of the hierarchy, then Access Approval will still be enabled at this level as the settings are
* inherited.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* DeleteAccessApprovalSettingsMessage request =
* DeleteAccessApprovalSettingsMessage.newBuilder().setName("name3373707").build();
* accessApprovalAdminClient.deleteAccessApprovalSettings(request);
* }
* }</pre>
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
*/
Expand All @@ -450,6 +690,17 @@ public final void deleteAccessApprovalSettings(DeleteAccessApprovalSettingsMessa
* inherited.
*
* <p>Sample code:
*
* <pre>{@code
* try (AccessApprovalAdminClient accessApprovalAdminClient = AccessApprovalAdminClient.create()) {
* DeleteAccessApprovalSettingsMessage request =
* DeleteAccessApprovalSettingsMessage.newBuilder().setName("name3373707").build();
* ApiFuture<Empty> future =
* accessApprovalAdminClient.deleteAccessApprovalSettingsCallable().futureCall(request);
* // Do something.
* future.get();
* }
* }</pre>
*/
public final UnaryCallable<DeleteAccessApprovalSettingsMessage, Empty>
deleteAccessApprovalSettingsCallable() {
Expand Down

0 comments on commit c6549ef

Please sign in to comment.