@@ -50,15 +50,15 @@ public final class AccessApprovalSettings extends com.google.api.client.json.Gen
5050 private java .lang .Boolean ancestorHasActiveKeyVersion ;
5151
5252 /**
53- * Optional. Policy for approval. This contains all policies.
53+ * Optional. Policy configuration for Access Approval that sets the operating mode. The available
54+ * policies are Transparency, Streamlined Support, and Approval Required.
5455 * The value may be {@code null}.
5556 */
5657 @ com .google .api .client .util .Key
5758 private CustomerApprovalApprovalPolicy approvalPolicy ;
5859
5960 /**
60- * Output only. Policy for approval included inherited settings to understand the exact policy
61- * applied to this resource. This is a read-only field.
61+ * Output only. Effective policy applied for Access Approval, inclusive of inheritance.
6262 * The value may be {@code null}.
6363 */
6464 @ com .google .api .client .util .Key
@@ -80,8 +80,7 @@ public final class AccessApprovalSettings extends com.google.api.client.json.Gen
8080 * will be required to have explicit approval. If name refers to an organization, enrollment can
8181 * be done for individual services. If name refers to a folder or project, enrollment can only be
8282 * done on an all or nothing basis. If a cloud_product is repeated in this list, the first entry
83- * will be honored and all following entries will be discarded. A maximum of 10 enrolled services
84- * will be enforced, to be expanded as the set of supported services is expanded.
83+ * will be honored and all following entries will be discarded.
8584 * The value may be {@code null}.
8685 */
8786 @ com .google .api .client .util .Key
@@ -118,37 +117,44 @@ public final class AccessApprovalSettings extends com.google.api.client.json.Gen
118117 private java .util .List <java .lang .String > notificationEmails ;
119118
120119 /**
121- * Optional. A pubsub topic to which notifications relating to approval requests should be sent.
120+ * Optional. A pubsub topic that notifications relating to access approval are published to.
121+ * Notifications include pre-approved accesses.
122122 * The value may be {@code null}.
123123 */
124124 @ com .google .api .client .util .Key
125125 private java .lang .String notificationPubsubTopic ;
126126
127127 /**
128- * This preference is communicated to Google personnel when sending an approval request but can be
129- * overridden if necessary.
128+ * This field is used to set a preference for granularity of an access approval request. If true,
129+ * Google personnel will be asked to send resource-level requests when possible. If false, Google
130+ * personnel will be asked to send requests at the project level.
130131 * The value may be {@code null}.
131132 */
132133 @ com .google .api .client .util .Key
133134 private java .lang .Boolean preferNoBroadApprovalRequests ;
134135
135136 /**
136- * This preference is shared with Google personnel, but can be overridden if said personnel deems
137- * necessary. The approver ultimately can set the expiration at approval time.
137+ * Set the default access approval request expiration time. This value is able to be set directly
138+ * by the customer at the time of approval, overriding this suggested value. We recommend setting
139+ * this value to 30 days.
138140 * The value may be {@code null}.
139141 */
140142 @ com .google .api .client .util .Key
141143 private java .lang .Integer preferredRequestExpirationDays ;
142144
143145 /**
144- * Optional. A setting to indicate the maximum width of an Access Approval request.
146+ * Optional. A setting that indicates the maximum scope of an Access Approval request: either
147+ * organization, folder, or project. Google administrators will be asked to send requests no
148+ * broader than the configured scope.
145149 * The value may be {@code null}.
146150 */
147151 @ com .google .api .client .util .Key
148152 private java .lang .String requestScopeMaxWidthPreference ;
149153
150154 /**
151- * Optional. A setting to require approval request justifications to be customer visible.
155+ * Optional. When enabled, Google will only be able to send approval requests for access reasons
156+ * with a customer accessible case ID in the reason detail. Also known as "Require customer
157+ * initiated support case justification"
152158 * The value may be {@code null}.
153159 */
154160 @ com .google .api .client .util .Key
@@ -201,15 +207,17 @@ public AccessApprovalSettings setAncestorHasActiveKeyVersion(java.lang.Boolean a
201207 }
202208
203209 /**
204- * Optional. Policy for approval. This contains all policies.
210+ * Optional. Policy configuration for Access Approval that sets the operating mode. The available
211+ * policies are Transparency, Streamlined Support, and Approval Required.
205212 * @return value or {@code null} for none
206213 */
207214 public CustomerApprovalApprovalPolicy getApprovalPolicy () {
208215 return approvalPolicy ;
209216 }
210217
211218 /**
212- * Optional. Policy for approval. This contains all policies.
219+ * Optional. Policy configuration for Access Approval that sets the operating mode. The available
220+ * policies are Transparency, Streamlined Support, and Approval Required.
213221 * @param approvalPolicy approvalPolicy or {@code null} for none
214222 */
215223 public AccessApprovalSettings setApprovalPolicy (CustomerApprovalApprovalPolicy approvalPolicy ) {
@@ -218,17 +226,15 @@ public AccessApprovalSettings setApprovalPolicy(CustomerApprovalApprovalPolicy a
218226 }
219227
220228 /**
221- * Output only. Policy for approval included inherited settings to understand the exact policy
222- * applied to this resource. This is a read-only field.
229+ * Output only. Effective policy applied for Access Approval, inclusive of inheritance.
223230 * @return value or {@code null} for none
224231 */
225232 public CustomerApprovalApprovalPolicy getEffectiveApprovalPolicy () {
226233 return effectiveApprovalPolicy ;
227234 }
228235
229236 /**
230- * Output only. Policy for approval included inherited settings to understand the exact policy
231- * applied to this resource. This is a read-only field.
237+ * Output only. Effective policy applied for Access Approval, inclusive of inheritance.
232238 * @param effectiveApprovalPolicy effectiveApprovalPolicy or {@code null} for none
233239 */
234240 public AccessApprovalSettings setEffectiveApprovalPolicy (CustomerApprovalApprovalPolicy effectiveApprovalPolicy ) {
@@ -265,8 +271,7 @@ public AccessApprovalSettings setEnrolledAncestor(java.lang.Boolean enrolledAnce
265271 * will be required to have explicit approval. If name refers to an organization, enrollment can
266272 * be done for individual services. If name refers to a folder or project, enrollment can only be
267273 * done on an all or nothing basis. If a cloud_product is repeated in this list, the first entry
268- * will be honored and all following entries will be discarded. A maximum of 10 enrolled services
269- * will be enforced, to be expanded as the set of supported services is expanded.
274+ * will be honored and all following entries will be discarded.
270275 * @return value or {@code null} for none
271276 */
272277 public java .util .List <EnrolledService > getEnrolledServices () {
@@ -279,8 +284,7 @@ public java.util.List<EnrolledService> getEnrolledServices() {
279284 * will be required to have explicit approval. If name refers to an organization, enrollment can
280285 * be done for individual services. If name refers to a folder or project, enrollment can only be
281286 * done on an all or nothing basis. If a cloud_product is repeated in this list, the first entry
282- * will be honored and all following entries will be discarded. A maximum of 10 enrolled services
283- * will be enforced, to be expanded as the set of supported services is expanded.
287+ * will be honored and all following entries will be discarded.
284288 * @param enrolledServices enrolledServices or {@code null} for none
285289 */
286290 public AccessApprovalSettings setEnrolledServices (java .util .List <EnrolledService > enrolledServices ) {
@@ -358,15 +362,17 @@ public AccessApprovalSettings setNotificationEmails(java.util.List<java.lang.Str
358362 }
359363
360364 /**
361- * Optional. A pubsub topic to which notifications relating to approval requests should be sent.
365+ * Optional. A pubsub topic that notifications relating to access approval are published to.
366+ * Notifications include pre-approved accesses.
362367 * @return value or {@code null} for none
363368 */
364369 public java .lang .String getNotificationPubsubTopic () {
365370 return notificationPubsubTopic ;
366371 }
367372
368373 /**
369- * Optional. A pubsub topic to which notifications relating to approval requests should be sent.
374+ * Optional. A pubsub topic that notifications relating to access approval are published to.
375+ * Notifications include pre-approved accesses.
370376 * @param notificationPubsubTopic notificationPubsubTopic or {@code null} for none
371377 */
372378 public AccessApprovalSettings setNotificationPubsubTopic (java .lang .String notificationPubsubTopic ) {
@@ -375,17 +381,19 @@ public AccessApprovalSettings setNotificationPubsubTopic(java.lang.String notifi
375381 }
376382
377383 /**
378- * This preference is communicated to Google personnel when sending an approval request but can be
379- * overridden if necessary.
384+ * This field is used to set a preference for granularity of an access approval request. If true,
385+ * Google personnel will be asked to send resource-level requests when possible. If false, Google
386+ * personnel will be asked to send requests at the project level.
380387 * @return value or {@code null} for none
381388 */
382389 public java .lang .Boolean getPreferNoBroadApprovalRequests () {
383390 return preferNoBroadApprovalRequests ;
384391 }
385392
386393 /**
387- * This preference is communicated to Google personnel when sending an approval request but can be
388- * overridden if necessary.
394+ * This field is used to set a preference for granularity of an access approval request. If true,
395+ * Google personnel will be asked to send resource-level requests when possible. If false, Google
396+ * personnel will be asked to send requests at the project level.
389397 * @param preferNoBroadApprovalRequests preferNoBroadApprovalRequests or {@code null} for none
390398 */
391399 public AccessApprovalSettings setPreferNoBroadApprovalRequests (java .lang .Boolean preferNoBroadApprovalRequests ) {
@@ -394,17 +402,19 @@ public AccessApprovalSettings setPreferNoBroadApprovalRequests(java.lang.Boolean
394402 }
395403
396404 /**
397- * This preference is shared with Google personnel, but can be overridden if said personnel deems
398- * necessary. The approver ultimately can set the expiration at approval time.
405+ * Set the default access approval request expiration time. This value is able to be set directly
406+ * by the customer at the time of approval, overriding this suggested value. We recommend setting
407+ * this value to 30 days.
399408 * @return value or {@code null} for none
400409 */
401410 public java .lang .Integer getPreferredRequestExpirationDays () {
402411 return preferredRequestExpirationDays ;
403412 }
404413
405414 /**
406- * This preference is shared with Google personnel, but can be overridden if said personnel deems
407- * necessary. The approver ultimately can set the expiration at approval time.
415+ * Set the default access approval request expiration time. This value is able to be set directly
416+ * by the customer at the time of approval, overriding this suggested value. We recommend setting
417+ * this value to 30 days.
408418 * @param preferredRequestExpirationDays preferredRequestExpirationDays or {@code null} for none
409419 */
410420 public AccessApprovalSettings setPreferredRequestExpirationDays (java .lang .Integer preferredRequestExpirationDays ) {
@@ -413,15 +423,19 @@ public AccessApprovalSettings setPreferredRequestExpirationDays(java.lang.Intege
413423 }
414424
415425 /**
416- * Optional. A setting to indicate the maximum width of an Access Approval request.
426+ * Optional. A setting that indicates the maximum scope of an Access Approval request: either
427+ * organization, folder, or project. Google administrators will be asked to send requests no
428+ * broader than the configured scope.
417429 * @return value or {@code null} for none
418430 */
419431 public java .lang .String getRequestScopeMaxWidthPreference () {
420432 return requestScopeMaxWidthPreference ;
421433 }
422434
423435 /**
424- * Optional. A setting to indicate the maximum width of an Access Approval request.
436+ * Optional. A setting that indicates the maximum scope of an Access Approval request: either
437+ * organization, folder, or project. Google administrators will be asked to send requests no
438+ * broader than the configured scope.
425439 * @param requestScopeMaxWidthPreference requestScopeMaxWidthPreference or {@code null} for none
426440 */
427441 public AccessApprovalSettings setRequestScopeMaxWidthPreference (java .lang .String requestScopeMaxWidthPreference ) {
@@ -430,15 +444,19 @@ public AccessApprovalSettings setRequestScopeMaxWidthPreference(java.lang.String
430444 }
431445
432446 /**
433- * Optional. A setting to require approval request justifications to be customer visible.
447+ * Optional. When enabled, Google will only be able to send approval requests for access reasons
448+ * with a customer accessible case ID in the reason detail. Also known as "Require customer
449+ * initiated support case justification"
434450 * @return value or {@code null} for none
435451 */
436452 public java .lang .Boolean getRequireCustomerVisibleJustification () {
437453 return requireCustomerVisibleJustification ;
438454 }
439455
440456 /**
441- * Optional. A setting to require approval request justifications to be customer visible.
457+ * Optional. When enabled, Google will only be able to send approval requests for access reasons
458+ * with a customer accessible case ID in the reason detail. Also known as "Require customer
459+ * initiated support case justification"
442460 * @param requireCustomerVisibleJustification requireCustomerVisibleJustification or {@code null} for none
443461 */
444462 public AccessApprovalSettings setRequireCustomerVisibleJustification (java .lang .Boolean requireCustomerVisibleJustification ) {
0 commit comments