docs: update comment of contact_email to make it optional as opposed to required

Google APIs · copybara-github · commit 2c24fa58df01 · 2024-03-26T13:21:04.000-07:00
---
docs: update sample URL in field for `service_request_quota_uri`
PiperOrigin-RevId: 619290180
diff --git a/google/api/cloudquotas/v1/resources.proto b/google/api/cloudquotas/v1/resources.proto
@@ -126,15 +126,9 @@ message QuotaInfo {
   // on the total number of concurrent operations in flight at any given time.
   bool is_concurrent = 15;
 
-  // URI to the page where the user can request more quotas for the cloud
-  // service, such as
-  // https://docs.google.com/spreadsheet/viewform?formkey=abc123&entry_0={email}&entry_1={id}.
-  // Google Developers Console UI replace {email} with the current
-  // user's e-mail, {id} with the current project number, or organization ID
-  // with "organizations/" prefix. For example,
-  // https://docs.google.com/spreadsheet/viewform?formkey=abc123&entry_0=johndoe@gmail.com&entry_1=25463754,
-  // or
-  // https://docs.google.com/spreadsheet/viewform?formkey=abc123&entry_0=johndoe@gmail.com&entry_1=organizations/26474422.
+  // URI to the page where users can request more quota for the cloud
+  // service—for example,
+  // https://console.cloud.google.com/iam-admin/quotas.
   string service_request_quota_uri = 17;
 }
 
@@ -227,17 +221,17 @@ message QuotaPreference {
   // The reason / justification for this quota preference.
   string justification = 11;
 
-  // Required. Input only. An email address that can be used for quota related
+  // Input only. An email address that can be used for quota related
   // communication between the Google Cloud and the user in case the Google
   // Cloud needs further information to make a decision on whether the user
   // preferred quota can be granted.
   //
+  // The email address is optional for decrease quota preferences. In another
+  // word, QuotaConfig.preferred_value is smaller than the
+  // QuotaDetails.reset_value. It is required for increase quota preferences.
   // The Google account for the email address must have quota update permission
   // for the project, folder or organization this quota preference is for.
-  string contact_email = 12 [
-    (google.api.field_behavior) = INPUT_ONLY,
-    (google.api.field_behavior) = REQUIRED
-  ];
+  string contact_email = 12 [(google.api.field_behavior) = INPUT_ONLY];
 }
 
 // The preferred quota configuration.
