chore: regenerate calendar client (googleapis#30021)

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-calendar/v3/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-calendar</artifactId>
-      <version>v3-rev20250404-2.0.0</version>
+      <version>v3-rev20251028-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-calendar:v3-rev20250404-2.0.0'
+  implementation 'com.google.apis:google-api-services-calendar:v3-rev20251028-2.0.0'
 }
 ```
 

clients/google-api-services-calendar/v3/2.0.0/com/google/api/services/calendar/Calendar.java

@@ -2732,7 +2732,14 @@ public Get set(String parameterName, Object value) {
       }
     }
     /**
-     * Creates a secondary calendar.
+     * Creates a secondary calendar. The authenticated user for the request is made the data owner of
+     * the new calendar.
+     *
+     * Note: We recommend to authenticate as the intended data owner of the calendar. You can use
+     * domain-wide delegation of authority to allow applications to act on behalf of a specific user.
+     * Don't use a service account for authentication. If you use a service account for authentication,
+     * the service account is the data owner, which can lead to unexpected behavior. For example, if a
+     * service account is the data owner, data ownership cannot be transferred.
      *
      * Create a request for the method "calendars.insert".
      *
@@ -2753,7 +2760,14 @@ public class Insert extends CalendarRequest<com.google.api.services.calendar.mod
       private static final String REST_PATH = "calendars";
 
       /**
-       * Creates a secondary calendar.
+       * Creates a secondary calendar. The authenticated user for the request is made the data owner of
+       * the new calendar.
+       *
+       * Note: We recommend to authenticate as the intended data owner of the calendar. You can use
+       * domain-wide delegation of authority to allow applications to act on behalf of a specific user.
+       * Don't use a service account for authentication. If you use a service account for
+       * authentication, the service account is the data owner, which can lead to unexpected behavior.
+       * For example, if a service account is the data owner, data ownership cannot be transferred.
        *
        * Create a request for the method "calendars.insert".
        *

clients/google-api-services-calendar/v3/2.0.0/com/google/api/services/calendar/model/AclRule.java

@@ -56,8 +56,10 @@ public final class AclRule extends com.google.api.client.json.GenericJson {
    * access to the calendar. Private events will appear to users with reader access, but event
    * details will be hidden.  - "writer" - Provides read and write access to the calendar. Private
    * events will appear to users with writer access, and event details will be visible. Provides
-   * read access to the calendar's ACLs.  - "owner" - Provides ownership of the calendar. This role
-   * has all of the permissions of the writer role with the additional ability to manipulate ACLs.
+   * read access to the calendar's ACLs.  - "owner" - Provides manager access to the calendar. This
+   * role has all of the permissions of the writer role with the additional ability to modify access
+   * levels of other users. Important: the owner role is different from the calendar's data owner. A
+   * calendar has a single data owner, but can have multiple users with owner role.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -127,8 +129,10 @@ public AclRule setKind(java.lang.String kind) {
    * access to the calendar. Private events will appear to users with reader access, but event
    * details will be hidden.  - "writer" - Provides read and write access to the calendar. Private
    * events will appear to users with writer access, and event details will be visible. Provides
-   * read access to the calendar's ACLs.  - "owner" - Provides ownership of the calendar. This role
-   * has all of the permissions of the writer role with the additional ability to manipulate ACLs.
+   * read access to the calendar's ACLs.  - "owner" - Provides manager access to the calendar. This
+   * role has all of the permissions of the writer role with the additional ability to modify access
+   * levels of other users. Important: the owner role is different from the calendar's data owner. A
+   * calendar has a single data owner, but can have multiple users with owner role.
    * @return value or {@code null} for none
    */
   public java.lang.String getRole() {
@@ -141,8 +145,10 @@ public java.lang.String getRole() {
    * access to the calendar. Private events will appear to users with reader access, but event
    * details will be hidden.  - "writer" - Provides read and write access to the calendar. Private
    * events will appear to users with writer access, and event details will be visible. Provides
-   * read access to the calendar's ACLs.  - "owner" - Provides ownership of the calendar. This role
-   * has all of the permissions of the writer role with the additional ability to manipulate ACLs.
+   * read access to the calendar's ACLs.  - "owner" - Provides manager access to the calendar. This
+   * role has all of the permissions of the writer role with the additional ability to modify access
+   * levels of other users. Important: the owner role is different from the calendar's data owner. A
+   * calendar has a single data owner, but can have multiple users with owner role.
    * @param role role or {@code null} for none
    */
   public AclRule setRole(java.lang.String role) {

clients/google-api-services-calendar/v3/2.0.0/com/google/api/services/calendar/model/Calendar.java

@@ -36,6 +36,13 @@ public final class Calendar extends com.google.api.client.json.GenericJson {
   @com.google.api.client.util.Key
   private ConferenceProperties conferenceProperties;
 
+  /**
+   * The email of the owner of the calendar. Set only for secondary calendars. Read-only.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String dataOwner;
+
   /**
    * Description of the calendar. Optional.
    * The value may be {@code null}.
@@ -103,6 +110,23 @@ public Calendar setConferenceProperties(ConferenceProperties conferencePropertie
     return this;
   }
 
+  /**
+   * The email of the owner of the calendar. Set only for secondary calendars. Read-only.
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getDataOwner() {
+    return dataOwner;
+  }
+
+  /**
+   * The email of the owner of the calendar. Set only for secondary calendars. Read-only.
+   * @param dataOwner dataOwner or {@code null} for none
+   */
+  public Calendar setDataOwner(java.lang.String dataOwner) {
+    this.dataOwner = dataOwner;
+    return this;
+  }
+
   /**
    * Description of the calendar. Optional.
    * @return value or {@code null} for none

clients/google-api-services-calendar/v3/2.0.0/com/google/api/services/calendar/model/CalendarListEntry.java

@@ -35,8 +35,10 @@ public final class CalendarListEntry extends com.google.api.client.json.GenericJ
    * Provides read access to the calendar. Private events will appear to users with reader access,
    * but event details will be hidden.  - "writer" - Provides read and write access to the calendar.
    * Private events will appear to users with writer access, and event details will be visible.  -
-   * "owner" - Provides ownership of the calendar. This role has all of the permissions of the
-   * writer role with the additional ability to see and manipulate ACLs.
+   * "owner" - Provides manager access to the calendar. This role has all of the permissions of the
+   * writer role with the additional ability to see and modify access levels of other users.
+   * Important: the owner role is different from the calendar's data owner. A calendar has a single
+   * data owner, but can have multiple users with owner role.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -67,6 +69,13 @@ public final class CalendarListEntry extends com.google.api.client.json.GenericJ
   @com.google.api.client.util.Key
   private ConferenceProperties conferenceProperties;
 
+  /**
+   * The email of the owner of the calendar. Set only for secondary calendars. Read-only.
+   * The value may be {@code null}.
+   */
+  @com.google.api.client.util.Key
+  private java.lang.String dataOwner;
+
   /**
    * The default reminders that the authenticated user has for this calendar.
    * The value may be {@code null}.
@@ -184,8 +193,10 @@ public final class CalendarListEntry extends com.google.api.client.json.GenericJ
    * Provides read access to the calendar. Private events will appear to users with reader access,
    * but event details will be hidden.  - "writer" - Provides read and write access to the calendar.
    * Private events will appear to users with writer access, and event details will be visible.  -
-   * "owner" - Provides ownership of the calendar. This role has all of the permissions of the
-   * writer role with the additional ability to see and manipulate ACLs.
+   * "owner" - Provides manager access to the calendar. This role has all of the permissions of the
+   * writer role with the additional ability to see and modify access levels of other users.
+   * Important: the owner role is different from the calendar's data owner. A calendar has a single
+   * data owner, but can have multiple users with owner role.
    * @return value or {@code null} for none
    */
   public java.lang.String getAccessRole() {
@@ -198,8 +209,10 @@ public java.lang.String getAccessRole() {
    * Provides read access to the calendar. Private events will appear to users with reader access,
    * but event details will be hidden.  - "writer" - Provides read and write access to the calendar.
    * Private events will appear to users with writer access, and event details will be visible.  -
-   * "owner" - Provides ownership of the calendar. This role has all of the permissions of the
-   * writer role with the additional ability to see and manipulate ACLs.
+   * "owner" - Provides manager access to the calendar. This role has all of the permissions of the
+   * writer role with the additional ability to see and modify access levels of other users.
+   * Important: the owner role is different from the calendar's data owner. A calendar has a single
+   * data owner, but can have multiple users with owner role.
    * @param accessRole accessRole or {@code null} for none
    */
   public CalendarListEntry setAccessRole(java.lang.String accessRole) {
@@ -266,6 +279,23 @@ public CalendarListEntry setConferenceProperties(ConferenceProperties conference
     return this;
   }
 
+  /**
+   * The email of the owner of the calendar. Set only for secondary calendars. Read-only.
+   * @return value or {@code null} for none
+   */
+  public java.lang.String getDataOwner() {
+    return dataOwner;
+  }
+
+  /**
+   * The email of the owner of the calendar. Set only for secondary calendars. Read-only.
+   * @param dataOwner dataOwner or {@code null} for none
+   */
+  public CalendarListEntry setDataOwner(java.lang.String dataOwner) {
+    this.dataOwner = dataOwner;
+    return this;
+  }
+
   /**
    * The default reminders that the authenticated user has for this calendar.
    * @return value or {@code null} for none

clients/google-api-services-calendar/v3/2.0.0/com/google/api/services/calendar/model/Events.java

@@ -35,8 +35,10 @@ public final class Events extends com.google.api.client.json.GenericJson {
    * "reader" - The user has read access to the calendar. Private events will appear to users with
    * reader access, but event details will be hidden.  - "writer" - The user has read and write
    * access to the calendar. Private events will appear to users with writer access, and event
-   * details will be visible.  - "owner" - The user has ownership of the calendar. This role has all
-   * of the permissions of the writer role with the additional ability to see and manipulate ACLs.
+   * details will be visible.  - "owner" - The user has manager access to the calendar. This role
+   * has all of the permissions of the writer role with the additional ability to see and modify
+   * access levels of other users. Important: the owner role is different from the calendar's data
+   * owner. A calendar has a single data owner, but can have multiple users with owner role.
    * The value may be {@code null}.
    */
   @com.google.api.client.util.Key
@@ -135,8 +137,10 @@ public final class Events extends com.google.api.client.json.GenericJson {
    * "reader" - The user has read access to the calendar. Private events will appear to users with
    * reader access, but event details will be hidden.  - "writer" - The user has read and write
    * access to the calendar. Private events will appear to users with writer access, and event
-   * details will be visible.  - "owner" - The user has ownership of the calendar. This role has all
-   * of the permissions of the writer role with the additional ability to see and manipulate ACLs.
+   * details will be visible.  - "owner" - The user has manager access to the calendar. This role
+   * has all of the permissions of the writer role with the additional ability to see and modify
+   * access levels of other users. Important: the owner role is different from the calendar's data
+   * owner. A calendar has a single data owner, but can have multiple users with owner role.
    * @return value or {@code null} for none
    */
   public java.lang.String getAccessRole() {
@@ -149,8 +153,10 @@ public java.lang.String getAccessRole() {
    * "reader" - The user has read access to the calendar. Private events will appear to users with
    * reader access, but event details will be hidden.  - "writer" - The user has read and write
    * access to the calendar. Private events will appear to users with writer access, and event
-   * details will be visible.  - "owner" - The user has ownership of the calendar. This role has all
-   * of the permissions of the writer role with the additional ability to see and manipulate ACLs.
+   * details will be visible.  - "owner" - The user has manager access to the calendar. This role
+   * has all of the permissions of the writer role with the additional ability to see and modify
+   * access levels of other users. Important: the owner role is different from the calendar's data
+   * owner. A calendar has a single data owner, but can have multiple users with owner role.
    * @param accessRole accessRole or {@code null} for none
    */
   public Events setAccessRole(java.lang.String accessRole) {

clients/google-api-services-calendar/v3/2.0.0/pom.xml

@@ -8,8 +8,8 @@
 
   <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-calendar</artifactId>
-  <version>v3-rev20250404-2.0.0</version>
-  <name>Calendar API v3-rev20250404-2.0.0</name>
+  <version>v3-rev20251028-2.0.0</version>
+  <name>Calendar API v3-rev20251028-2.0.0</name>
   <packaging>jar</packaging>
 
   <inceptionYear>2011</inceptionYear>

clients/google-api-services-calendar/v3/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-calendar</artifactId>
-      <version>v3-rev20250404-2.0.0</version>
+      <version>v3-rev20251028-2.0.0</version>
     </dependency>
   </dependencies>
 </project>
@@ -35,7 +35,7 @@ repositories {
   mavenCentral()
 }
 dependencies {
-  implementation 'com.google.apis:google-api-services-calendar:v3-rev20250404-2.0.0'
+  implementation 'com.google.apis:google-api-services-calendar:v3-rev20251028-2.0.0'
 }
 ```