chore: regenerate gmail client (googleapis#27980)

Generated in GitHub action: https://togithub.com/googleapis/googleapis/google-api-java-client-services/actions/workflows/codegen.yaml

Author: yoshi-code-bot

clients/google-api-services-gmail/v1/2.0.0/README.md

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-gmail</artifactId>
-      <version>v1-rev20250331-2.0.0</version>
+      <version>v1-rev20250616-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-gmail:v1-rev20250331-2.0.0'
+  implementation 'com.google.apis:google-api-services-gmail:v1-rev20250616-2.0.0'
 }
 ```
 

clients/google-api-services-gmail/v1/2.0.0/com/google/api/services/gmail/Gmail.java

@@ -19,7 +19,14 @@
 /**
  * The client-side encryption (CSE) configuration for the email address of an authenticated user.
  * Gmail uses CSE configurations to save drafts of client-side encrypted email messages, and to sign
- * and send encrypted email messages.
+ * and send encrypted email messages. For administrators managing identities and keypairs for users
+ * in their organization, requests require authorization with a [service
+ * account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-
+ * wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#
+ * delegatingauthority) to impersonate users with the
+ * `https://www.googleapis.com/auth/gmail.settings.basic` scope. For users managing their own
+ * identities and keypairs, requests require [hardware key
+ * encryption](https://support.google.com/a/answer/14153163) turned on and configured.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Gmail API. For a detailed explanation see:

clients/google-api-services-gmail/v1/2.0.0/com/google/api/services/gmail/model/CseIdentity.java

@@ -21,7 +21,14 @@
  * chain, and metadata for its paired private key. Gmail uses the key pair to complete the following
  * tasks: - Sign outgoing client-side encrypted messages. - Save and reopen drafts of client-side
  * encrypted messages. - Save and reopen sent messages. - Decrypt incoming or archived S/MIME
- * messages.
+ * messages. For administrators managing identities and keypairs for users in their organization,
+ * requests require authorization with a [service
+ * account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-
+ * wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#
+ * delegatingauthority) to impersonate users with the
+ * `https://www.googleapis.com/auth/gmail.settings.basic` scope. For users managing their own
+ * identities and keypairs, requests require [hardware key
+ * encryption](https://support.google.com/a/answer/14153163) turned on and configured.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Gmail API. For a detailed explanation see:

clients/google-api-services-gmail/v1/2.0.0/com/google/api/services/gmail/model/CseKeyPair.java

@@ -17,7 +17,11 @@
 package com.google.api.services.gmail.model;
 
 /**
- * Metadata for hardware keys.
+ * Metadata for hardware keys. If [hardware key
+ * encryption](https://support.google.com/a/answer/14153163) is set up for the Google Workspace
+ * organization, users can optionally store their private key on their smart card and use it to sign
+ * and decrypt email messages in Gmail by inserting their smart card into a reader attached to their
+ * Windows device.
  *
  * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is
  * transmitted over HTTP when working with the Gmail API. For a detailed explanation see:

clients/google-api-services-gmail/v1/2.0.0/com/google/api/services/gmail/model/HardwareKeyMetadata.java

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-gmail</artifactId>
-  <version>v1-rev20250331-2.0.0</version>
-  <name>Gmail API v1-rev20250331-2.0.0</name>
+  <version>v1-rev20250616-2.0.0</version>
+  <name>Gmail API v1-rev20250616-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-gmail/v1/2.0.0/pom.xml

@@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file:
     <dependency>
       <groupId>com.google.apis</groupId>
       <artifactId>google-api-services-gmail</artifactId>
-      <version>v1-rev20250331-2.0.0</version>
+      <version>v1-rev20250616-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-gmail:v1-rev20250331-2.0.0'
+  implementation 'com.google.apis:google-api-services-gmail:v1-rev20250616-2.0.0'
 }
 ```