@google-analytics/data 4.8.0 → 4.10.0

package/build/protos/protos.json

@@ -1,4 +1,7 @@
 {
+  "options": {
+    "syntax": "proto3"
+  },
   "nested": {
     "google": {
       "nested": {
@@ -1514,6 +1517,24 @@
                             }
                           ]
                         },
+                        "GetPropertyQuotasSnapshot": {
+                          "requestType": "GetPropertyQuotasSnapshotRequest",
+                          "responseType": "PropertyQuotasSnapshot",
+                          "options": {
+                            "(google.api.http).get": "/v1alpha/{name=properties/*/propertyQuotasSnapshot}",
+                            "(google.api.method_signature)": "name"
+                          },
+                          "parsedOptions": [
+                            {
+                              "(google.api.http)": {
+                                "get": "/v1alpha/{name=properties/*/propertyQuotasSnapshot}"
+                              }
+                            },
+                            {
+                              "(google.api.method_signature)": "name"
+                            }
+                          ]
+                        },
                         "CreateReportTask": {
                           "requestType": "CreateReportTaskRequest",
                           "responseType": "google.longrunning.Operation",
@@ -1787,6 +1808,47 @@
                         }
                       }
                     },
+                    "GetPropertyQuotasSnapshotRequest": {
+                      "fields": {
+                        "name": {
+                          "type": "string",
+                          "id": 1,
+                          "options": {
+                            "(google.api.field_behavior)": "REQUIRED",
+                            "(google.api.resource_reference).type": "analyticsadmin.googleapis.com/PropertyQuotasSnapshot"
+                          }
+                        }
+                      }
+                    },
+                    "PropertyQuotasSnapshot": {
+                      "options": {
+                        "(google.api.resource).type": "analyticsadmin.googleapis.com/PropertyQuotasSnapshot",
+                        "(google.api.resource).pattern": "properties/{property}/propertyQuotasSnapshot",
+                        "(google.api.resource).plural": "propertyQuotasSnapshots",
+                        "(google.api.resource).singular": "propertyQuotasSnapshot"
+                      },
+                      "fields": {
+                        "name": {
+                          "type": "string",
+                          "id": 4,
+                          "options": {
+                            "(google.api.field_behavior)": "IDENTIFIER"
+                          }
+                        },
+                        "corePropertyQuota": {
+                          "type": "PropertyQuota",
+                          "id": 1
+                        },
+                        "realtimePropertyQuota": {
+                          "type": "PropertyQuota",
+                          "id": 2
+                        },
+                        "funnelPropertyQuota": {
+                          "type": "PropertyQuota",
+                          "id": 3
+                        }
+                      }
+                    },
                     "GetAudienceListRequest": {
                       "fields": {
                         "name": {
@@ -2331,6 +2393,13 @@
                       },
                       "nested": {
                         "ReportDefinition": {
+                          "oneofs": {
+                            "_samplingLevel": {
+                              "oneof": [
+                                "samplingLevel"
+                              ]
+                            }
+                          },
                           "fields": {
                             "dimensions": {
                               "rule": "repeated",
@@ -2420,6 +2489,14 @@
                               "options": {
                                 "(google.api.field_behavior)": "OPTIONAL"
                               }
+                            },
+                            "samplingLevel": {
+                              "type": "SamplingLevel",
+                              "id": 14,
+                              "options": {
+                                "(google.api.field_behavior)": "OPTIONAL",
+                                "proto3_optional": true
+                              }
                             }
                           }
                         },
@@ -4091,6 +4168,14 @@
                         "COST_DATA": 1,
                         "REVENUE_DATA": 2
                       }
+                    },
+                    "SamplingLevel": {
+                      "values": {
+                        "SAMPLING_LEVEL_UNSPECIFIED": 0,
+                        "LOW": 1,
+                        "MEDIUM": 2,
+                        "UNSAMPLED": 3
+                      }
                     }
                   }
                 },

package/build/src/v1alpha/alpha_analytics_data_client.d.ts

@@ -136,9 +136,9 @@ export declare class AlphaAnalyticsDataClient {
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} [request.property]
-     *   Optional. A Google Analytics GA4 property identifier whose events are
-     *   tracked. Specified in the URL path and not the body. To learn more, see
-     *   [where to find your Property
+     *   Optional. A Google Analytics property identifier whose events are tracked.
+     *   Specified in the URL path and not the body. To learn more, see [where to
+     *   find your Property
      *   ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
      *   Within a batch request, this property should either be unspecified or
      *   consistent with the batch-level property.
@@ -450,6 +450,31 @@ export declare class AlphaAnalyticsDataClient {
     ]>;
     getRecurringAudienceList(request: protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IRecurringAudienceList, protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest | null | undefined, {} | null | undefined>): void;
     getRecurringAudienceList(request: protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest, callback: Callback<protos.google.analytics.data.v1alpha.IRecurringAudienceList, protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest | null | undefined, {} | null | undefined>): void;
+    /**
+     * Get all property quotas organized by quota category for a given property.
+     * This will charge 1 property quota from the category with the most quota.
+     *
+     * @param {Object} request
+     *   The request object that will be sent.
+     * @param {string} request.name
+     *   Required. Quotas from this property will be listed in the response.
+     *   Format: `properties/{property}/propertyQuotasSnapshot`
+     * @param {object} [options]
+     *   Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
+     * @returns {Promise} - The promise which resolves to an array.
+     *   The first element of the array is an object representing {@link protos.google.analytics.data.v1alpha.PropertyQuotasSnapshot|PropertyQuotasSnapshot}.
+     *   Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods | documentation }
+     *   for more details and examples.
+     * @example <caption>include:samples/generated/v1alpha/alpha_analytics_data.get_property_quotas_snapshot.js</caption>
+     * region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_GetPropertyQuotasSnapshot_async
+     */
+    getPropertyQuotasSnapshot(request?: protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest, options?: CallOptions): Promise<[
+        protos.google.analytics.data.v1alpha.IPropertyQuotasSnapshot,
+        (protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest | undefined),
+        {} | undefined
+    ]>;
+    getPropertyQuotasSnapshot(request: protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IPropertyQuotasSnapshot, protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest | null | undefined, {} | null | undefined>): void;
+    getPropertyQuotasSnapshot(request: protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest, callback: Callback<protos.google.analytics.data.v1alpha.IPropertyQuotasSnapshot, protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest | null | undefined, {} | null | undefined>): void;
     /**
      * Retrieves a report task's content. After requesting the `CreateReportTask`,
      * you are able to retrieve the report content once the report is
@@ -599,6 +624,12 @@ export declare class AlphaAnalyticsDataClient {
      * asynchronous request to form a customized report of your Google Analytics
      * event data.
      *
+     * A report task will be retained and available for querying for 72 hours
+     * after it has been created.
+     *
+     * A report task created by one user can be listed and queried by all users
+     * who have access to the property.
+     *
      * @param {Object} request
      *   The request object that will be sent.
      * @param {string} request.parent
@@ -1110,6 +1141,21 @@ export declare class AlphaAnalyticsDataClient {
      * @returns {string} A string representing the property.
      */
     matchPropertyFromPropertyName(propertyName: string): string | number;
+    /**
+     * Return a fully-qualified propertyQuotasSnapshot resource name string.
+     *
+     * @param {string} property
+     * @returns {string} Resource name string.
+     */
+    propertyQuotasSnapshotPath(property: string): string;
+    /**
+     * Parse the property from PropertyQuotasSnapshot resource.
+     *
+     * @param {string} propertyQuotasSnapshotName
+     *   A fully-qualified path representing PropertyQuotasSnapshot resource.
+     * @returns {string} A string representing the property.
+     */
+    matchPropertyFromPropertyQuotasSnapshotName(propertyQuotasSnapshotName: string): string | number;
     /**
      * Return a fully-qualified recurringAudienceList resource name string.
      *

package/build/src/v1alpha/alpha_analytics_data_client.js

@@ -150,6 +150,7 @@ class AlphaAnalyticsDataClient {
         this.pathTemplates = {
             audienceListPathTemplate: new this._gaxModule.PathTemplate('properties/{property}/audienceLists/{audience_list}'),
             propertyPathTemplate: new this._gaxModule.PathTemplate('properties/{property}'),
+            propertyQuotasSnapshotPathTemplate: new this._gaxModule.PathTemplate('properties/{property}/propertyQuotasSnapshot'),
             recurringAudienceListPathTemplate: new this._gaxModule.PathTemplate('properties/{property}/recurringAudienceLists/{recurring_audience_list}'),
             reportTaskPathTemplate: new this._gaxModule.PathTemplate('properties/{property}/reportTasks/{report_task}'),
         };
@@ -228,6 +229,7 @@ class AlphaAnalyticsDataClient {
             'createRecurringAudienceList',
             'getRecurringAudienceList',
             'listRecurringAudienceLists',
+            'getPropertyQuotasSnapshot',
             'createReportTask',
             'queryReportTask',
             'getReportTask',
@@ -443,6 +445,27 @@ class AlphaAnalyticsDataClient {
         this.initialize();
         return this.innerApiCalls.getRecurringAudienceList(request, options, callback);
     }
+    getPropertyQuotasSnapshot(request, optionsOrCallback, callback) {
+        var _a;
+        request = request || {};
+        let options;
+        if (typeof optionsOrCallback === 'function' && callback === undefined) {
+            callback = optionsOrCallback;
+            options = {};
+        }
+        else {
+            options = optionsOrCallback;
+        }
+        options = options || {};
+        options.otherArgs = options.otherArgs || {};
+        options.otherArgs.headers = options.otherArgs.headers || {};
+        options.otherArgs.headers['x-goog-request-params'] =
+            this._gaxModule.routingHeader.fromParams({
+                name: (_a = request.name) !== null && _a !== void 0 ? _a : '',
+            });
+        this.initialize();
+        return this.innerApiCalls.getPropertyQuotasSnapshot(request, options, callback);
+    }
     queryReportTask(request, optionsOrCallback, callback) {
         var _a;
         request = request || {};
@@ -1076,6 +1099,27 @@ class AlphaAnalyticsDataClient {
     matchPropertyFromPropertyName(propertyName) {
         return this.pathTemplates.propertyPathTemplate.match(propertyName).property;
     }
+    /**
+     * Return a fully-qualified propertyQuotasSnapshot resource name string.
+     *
+     * @param {string} property
+     * @returns {string} Resource name string.
+     */
+    propertyQuotasSnapshotPath(property) {
+        return this.pathTemplates.propertyQuotasSnapshotPathTemplate.render({
+            property: property,
+        });
+    }
+    /**
+     * Parse the property from PropertyQuotasSnapshot resource.
+     *
+     * @param {string} propertyQuotasSnapshotName
+     *   A fully-qualified path representing PropertyQuotasSnapshot resource.
+     * @returns {string} A string representing the property.
+     */
+    matchPropertyFromPropertyQuotasSnapshotName(propertyQuotasSnapshotName) {
+        return this.pathTemplates.propertyQuotasSnapshotPathTemplate.match(propertyQuotasSnapshotName).property;
+    }
     /**
      * Return a fully-qualified recurringAudienceList resource name string.
      *

package/build/src/v1alpha/alpha_analytics_data_client_config.json

@@ -77,6 +77,11 @@
                     "retry_codes_name": "unknown",
                     "retry_params_name": "01d6d956b4dadd7e38ee9dec12ed8720e6e6f90c"
                 },
+                "GetPropertyQuotasSnapshot": {
+                    "timeout_millis": 60000,
+                    "retry_codes_name": "unknown",
+                    "retry_params_name": "01d6d956b4dadd7e38ee9dec12ed8720e6e6f90c"
+                },
                 "CreateReportTask": {
                     "timeout_millis": 60000,
                     "retry_codes_name": "unknown",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@google-analytics/data",
-  "version": "4.8.0",
+  "version": "4.10.0",
   "description": "Data client for Node.js",
   "repository": {
     "type": "git",