feat(analyticsadmin): update the API

#### analyticsadmin:v1alpha

The following keys were added:
- schemas.GoogleAnalyticsAdminV1alphaDataRetentionSettings.properties.userDataRetention.description
- schemas.GoogleAnalyticsAdminV1alphaDataRetentionSettings.properties.userDataRetention.enum
- schemas.GoogleAnalyticsAdminV1alphaDataRetentionSettings.properties.userDataRetention.enumDescriptions
- schemas.GoogleAnalyticsAdminV1alphaDataRetentionSettings.properties.userDataRetention.type

The following keys were changed:
- resources.accounts.methods.searchChangeHistoryEvents.description
- schemas.GoogleAnalyticsAdminV1alphaDataRetentionSettings.properties.eventDataRetention.description
- schemas.GoogleAnalyticsAdminV1alphaDataRetentionSettings.properties.eventDataRetention.enumDescriptions
- schemas.GoogleAnalyticsAdminV1alphaSearchChangeHistoryEventsRequest.properties.pageSize.description

#### analyticsadmin:v1beta

The following keys were added:
- schemas.GoogleAnalyticsAdminV1betaDataRetentionSettings.properties.userDataRetention.description
- schemas.GoogleAnalyticsAdminV1betaDataRetentionSettings.properties.userDataRetention.enum
- schemas.GoogleAnalyticsAdminV1betaDataRetentionSettings.properties.userDataRetention.enumDescriptions
- schemas.GoogleAnalyticsAdminV1betaDataRetentionSettings.properties.userDataRetention.type

The following keys were changed:
- resources.accounts.methods.searchChangeHistoryEvents.description
- schemas.GoogleAnalyticsAdminV1betaDataRetentionSettings.properties.eventDataRetention.description
- schemas.GoogleAnalyticsAdminV1betaDataRetentionSettings.properties.eventDataRetention.enumDescriptions
- schemas.GoogleAnalyticsAdminV1betaSearchChangeHistoryEventsRequest.properties.pageSize.description
- schemas.GoogleAnalyticsAdminV1betaSearchChangeHistoryEventsRequest.properties.resourceType.items.enum
- schemas.GoogleAnalyticsAdminV1betaSearchChangeHistoryEventsRequest.properties.resourceType.items.enumDescriptions

Author: yoshi-automation

discovery/analyticsadmin-v1alpha.json

@@ -340,7 +340,7 @@
           ]
         },
         "searchChangeHistoryEvents": {
-          "description": "Searches through all changes to an account or its children given the specified set of filters.",
+          "description": "Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.",
           "flatPath": "v1alpha/accounts/{accountsId}:searchChangeHistoryEvents",
           "httpMethod": "POST",
           "id": "analyticsadmin.accounts.searchChangeHistoryEvents",
@@ -4886,7 +4886,7 @@
       }
     }
   },
-  "revision": "20240929",
+  "revision": "20250114",
   "rootUrl": "https://analyticsadmin.googleapis.com/",
   "schemas": {
     "GoogleAnalyticsAdminV1alphaAccessBetweenFilter": {
@@ -6818,7 +6818,7 @@
       "id": "GoogleAnalyticsAdminV1alphaDataRetentionSettings",
       "properties": {
         "eventDataRetention": {
-          "description": "The length of time that event-level data is retained.",
+          "description": "Required. The length of time that event-level data is retained.",
           "enum": [
             "RETENTION_DURATION_UNSPECIFIED",
             "TWO_MONTHS",
@@ -6831,9 +6831,9 @@
             "Data retention time duration is not specified.",
             "The data retention time duration is 2 months.",
             "The data retention time duration is 14 months.",
-            "The data retention time duration is 26 months. Available to 360 properties only.",
-            "The data retention time duration is 38 months. Available to 360 properties only.",
-            "The data retention time duration is 50 months. Available to 360 properties only."
+            "The data retention time duration is 26 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 38 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 50 months. Available to 360 properties only. Available for event data only."
           ],
           "type": "string"
         },
@@ -6845,6 +6845,26 @@
         "resetUserDataOnNewActivity": {
           "description": "If true, reset the retention period for the user identifier with every event from that user.",
           "type": "boolean"
+        },
+        "userDataRetention": {
+          "description": "Required. The length of time that user-level data is retained.",
+          "enum": [
+            "RETENTION_DURATION_UNSPECIFIED",
+            "TWO_MONTHS",
+            "FOURTEEN_MONTHS",
+            "TWENTY_SIX_MONTHS",
+            "THIRTY_EIGHT_MONTHS",
+            "FIFTY_MONTHS"
+          ],
+          "enumDescriptions": [
+            "Data retention time duration is not specified.",
+            "The data retention time duration is 2 months.",
+            "The data retention time duration is 14 months.",
+            "The data retention time duration is 26 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 38 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 50 months. Available to 360 properties only. Available for event data only."
+          ],
+          "type": "string"
         }
       },
       "type": "object"
@@ -8774,7 +8794,7 @@
           "type": "string"
         },
         "pageSize": {
-          "description": "Optional. The maximum number of ChangeHistoryEvent items to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum).",
+          "description": "Optional. The maximum number of ChangeHistoryEvent items to return. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum). Note that the service may return a page with fewer items than this value specifies (potentially even zero), and that there still may be additional pages. If you want a particular number of items, you'll need to continue requesting additional pages using `page_token` until you get the needed number.",
           "format": "int32",
           "type": "integer"
         },

discovery/analyticsadmin-v1beta.json

@@ -334,7 +334,7 @@
           ]
         },
         "searchChangeHistoryEvents": {
-          "description": "Searches through all changes to an account or its children given the specified set of filters.",
+          "description": "Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.",
           "flatPath": "v1beta/accounts/{accountsId}:searchChangeHistoryEvents",
           "httpMethod": "POST",
           "id": "analyticsadmin.accounts.searchChangeHistoryEvents",
@@ -1788,7 +1788,7 @@
       }
     }
   },
-  "revision": "20240916",
+  "revision": "20250114",
   "rootUrl": "https://analyticsadmin.googleapis.com/",
   "schemas": {
     "GoogleAnalyticsAdminV1betaAccessBetweenFilter": {
@@ -2575,7 +2575,7 @@
       "id": "GoogleAnalyticsAdminV1betaDataRetentionSettings",
       "properties": {
         "eventDataRetention": {
-          "description": "The length of time that event-level data is retained.",
+          "description": "Required. The length of time that event-level data is retained.",
           "enum": [
             "RETENTION_DURATION_UNSPECIFIED",
             "TWO_MONTHS",
@@ -2588,9 +2588,9 @@
             "Data retention time duration is not specified.",
             "The data retention time duration is 2 months.",
             "The data retention time duration is 14 months.",
-            "The data retention time duration is 26 months. Available to 360 properties only.",
-            "The data retention time duration is 38 months. Available to 360 properties only.",
-            "The data retention time duration is 50 months. Available to 360 properties only."
+            "The data retention time duration is 26 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 38 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 50 months. Available to 360 properties only. Available for event data only."
           ],
           "type": "string"
         },
@@ -2602,6 +2602,26 @@
         "resetUserDataOnNewActivity": {
           "description": "If true, reset the retention period for the user identifier with every event from that user.",
           "type": "boolean"
+        },
+        "userDataRetention": {
+          "description": "Required. The length of time that user-level data is retained.",
+          "enum": [
+            "RETENTION_DURATION_UNSPECIFIED",
+            "TWO_MONTHS",
+            "FOURTEEN_MONTHS",
+            "TWENTY_SIX_MONTHS",
+            "THIRTY_EIGHT_MONTHS",
+            "FIFTY_MONTHS"
+          ],
+          "enumDescriptions": [
+            "Data retention time duration is not specified.",
+            "The data retention time duration is 2 months.",
+            "The data retention time duration is 14 months.",
+            "The data retention time duration is 26 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 38 months. Available to 360 properties only. Available for event data only.",
+            "The data retention time duration is 50 months. Available to 360 properties only. Available for event data only."
+          ],
+          "type": "string"
         }
       },
       "type": "object"
@@ -3470,7 +3490,7 @@
           "type": "string"
         },
         "pageSize": {
-          "description": "Optional. The maximum number of ChangeHistoryEvent items to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum).",
+          "description": "Optional. The maximum number of ChangeHistoryEvent items to return. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum). Note that the service may return a page with fewer items than this value specifies (potentially even zero), and that there still may be additional pages. If you want a particular number of items, you'll need to continue requesting additional pages using `page_token` until you get the needed number.",
           "format": "int32",
           "type": "integer"
         },
@@ -3494,6 +3514,8 @@
               "GOOGLE_SIGNALS_SETTINGS",
               "CONVERSION_EVENT",
               "MEASUREMENT_PROTOCOL_SECRET",
+              "CUSTOM_DIMENSION",
+              "CUSTOM_METRIC",
               "DATA_RETENTION_SETTINGS",
               "DISPLAY_VIDEO_360_ADVERTISER_LINK",
               "DISPLAY_VIDEO_360_ADVERTISER_LINK_PROPOSAL",
@@ -3509,6 +3531,8 @@
               "GoogleSignalsSettings resource",
               "ConversionEvent resource",
               "MeasurementProtocolSecret resource",
+              "CustomDimension resource",
+              "CustomMetric resource",
               "DataRetentionSettings resource",
               "DisplayVideo360AdvertiserLink resource",
               "DisplayVideo360AdvertiserLinkProposal resource",

src/apis/analyticsadmin/v1alpha.ts

@@ -1435,7 +1435,7 @@ export namespace analyticsadmin_v1alpha {
    */
   export interface Schema$GoogleAnalyticsAdminV1alphaDataRetentionSettings {
     /**
-     * The length of time that event-level data is retained.
+     * Required. The length of time that event-level data is retained.
      */
     eventDataRetention?: string | null;
     /**
@@ -1446,6 +1446,10 @@ export namespace analyticsadmin_v1alpha {
      * If true, reset the retention period for the user identifier with every event from that user.
      */
     resetUserDataOnNewActivity?: boolean | null;
+    /**
+     * Required. The length of time that user-level data is retained.
+     */
+    userDataRetention?: string | null;
   }
   /**
    * A resource message representing data sharing settings of a Google Analytics account.
@@ -2770,7 +2774,7 @@ export namespace analyticsadmin_v1alpha {
      */
     latestChangeTime?: string | null;
     /**
-     * Optional. The maximum number of ChangeHistoryEvent items to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum).
+     * Optional. The maximum number of ChangeHistoryEvent items to return. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum). Note that the service may return a page with fewer items than this value specifies (potentially even zero), and that there still may be additional pages. If you want a particular number of items, you'll need to continue requesting additional pages using `page_token` until you get the needed number.
      */
     pageSize?: number | null;
     /**
@@ -3615,7 +3619,7 @@ export namespace analyticsadmin_v1alpha {
     }
 
     /**
-     * Searches through all changes to an account or its children given the specified set of filters.
+     * Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.

src/apis/analyticsadmin/v1beta.ts

@@ -671,7 +671,7 @@ export namespace analyticsadmin_v1beta {
    */
   export interface Schema$GoogleAnalyticsAdminV1betaDataRetentionSettings {
     /**
-     * The length of time that event-level data is retained.
+     * Required. The length of time that event-level data is retained.
      */
     eventDataRetention?: string | null;
     /**
@@ -682,6 +682,10 @@ export namespace analyticsadmin_v1beta {
      * If true, reset the retention period for the user identifier with every event from that user.
      */
     resetUserDataOnNewActivity?: boolean | null;
+    /**
+     * Required. The length of time that user-level data is retained.
+     */
+    userDataRetention?: string | null;
   }
   /**
    * A resource message representing data sharing settings of a Google Analytics account.
@@ -1260,7 +1264,7 @@ export namespace analyticsadmin_v1beta {
      */
     latestChangeTime?: string | null;
     /**
-     * Optional. The maximum number of ChangeHistoryEvent items to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum).
+     * Optional. The maximum number of ChangeHistoryEvent items to return. If unspecified, at most 50 items will be returned. The maximum value is 200 (higher values will be coerced to the maximum). Note that the service may return a page with fewer items than this value specifies (potentially even zero), and that there still may be additional pages. If you want a particular number of items, you'll need to continue requesting additional pages using `page_token` until you get the needed number.
      */
     pageSize?: number | null;
     /**
@@ -1962,7 +1966,7 @@ export namespace analyticsadmin_v1beta {
     }
 
     /**
-     * Searches through all changes to an account or its children given the specified set of filters.
+     * Searches through all changes to an account or its children given the specified set of filters. Only returns the subset of changes supported by the API. The UI may return additional changes.
      *
      * @param params - Parameters for request
      * @param options - Optionally override request options, such as `url`, `method`, and `encoding`.