@google-analytics/data 2.8.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6,9 +6,6 @@
6
6
  "idempotent": [
7
7
  "DEADLINE_EXCEEDED",
8
8
  "UNAVAILABLE"
9
- ],
10
- "unknown": [
11
- "UNKNOWN"
12
9
  ]
13
10
  },
14
11
  "retry_params": {
@@ -20,47 +17,13 @@
20
17
  "rpc_timeout_multiplier": 1,
21
18
  "max_rpc_timeout_millis": 60000,
22
19
  "total_timeout_millis": 600000
23
- },
24
- "01d6d956b4dadd7e38ee9dec12ed8720e6e6f90c": {
25
- "initial_retry_delay_millis": 1000,
26
- "retry_delay_multiplier": 1.3,
27
- "max_retry_delay_millis": 60000,
28
- "initial_rpc_timeout_millis": 60000,
29
- "rpc_timeout_multiplier": 1,
30
- "max_rpc_timeout_millis": 60000,
31
- "total_timeout_millis": 600000
32
20
  }
33
21
  },
34
22
  "methods": {
35
- "RunReport": {
36
- "timeout_millis": 60000,
37
- "retry_codes_name": "non_idempotent",
38
- "retry_params_name": "default"
39
- },
40
- "RunPivotReport": {
23
+ "RunFunnelReport": {
41
24
  "timeout_millis": 60000,
42
25
  "retry_codes_name": "non_idempotent",
43
26
  "retry_params_name": "default"
44
- },
45
- "BatchRunReports": {
46
- "timeout_millis": 60000,
47
- "retry_codes_name": "non_idempotent",
48
- "retry_params_name": "default"
49
- },
50
- "BatchRunPivotReports": {
51
- "timeout_millis": 60000,
52
- "retry_codes_name": "non_idempotent",
53
- "retry_params_name": "default"
54
- },
55
- "GetMetadata": {
56
- "timeout_millis": 60000,
57
- "retry_codes_name": "unknown",
58
- "retry_params_name": "01d6d956b4dadd7e38ee9dec12ed8720e6e6f90c"
59
- },
60
- "RunRealtimeReport": {
61
- "timeout_millis": 60000,
62
- "retry_codes_name": "unknown",
63
- "retry_params_name": "01d6d956b4dadd7e38ee9dec12ed8720e6e6f90c"
64
27
  }
65
28
  }
66
29
  }
@@ -1,5 +1,5 @@
1
1
  "use strict";
2
- // Copyright 2021 Google LLC
2
+ // Copyright 2022 Google LLC
3
3
  //
4
4
  // Licensed under the Apache License, Version 2.0 (the "License");
5
5
  // you may not use this file except in compliance with the License.
@@ -17,6 +17,7 @@
17
17
  // ** https://github.com/googleapis/gapic-generator-typescript **
18
18
  // ** All changes to this file may be overwritten. **
19
19
  Object.defineProperty(exports, "__esModule", { value: true });
20
+ exports.AlphaAnalyticsDataClient = void 0;
20
21
  var alpha_analytics_data_client_1 = require("./alpha_analytics_data_client");
21
22
  Object.defineProperty(exports, "AlphaAnalyticsDataClient", { enumerable: true, get: function () { return alpha_analytics_data_client_1.AlphaAnalyticsDataClient; } });
22
23
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1alpha/index.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,qDAAqD;;AAErD,6EAAuE;AAA/D,uIAAA,wBAAwB,OAAA"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v1alpha/index.ts"],"names":[],"mappings":";AAAA,4BAA4B;AAC5B,EAAE;AACF,kEAAkE;AAClE,mEAAmE;AACnE,0CAA0C;AAC1C,EAAE;AACF,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,2EAA2E;AAC3E,sEAAsE;AACtE,iCAAiC;AACjC,EAAE;AACF,4EAA4E;AAC5E,iEAAiE;AACjE,qDAAqD;;;AAErD,6EAAuE;AAA/D,uIAAA,wBAAwB,OAAA"}
@@ -31,7 +31,7 @@ export declare class BetaAnalyticsDataClient {
31
31
  *
32
32
  * @param {object} [options] - The configuration object.
33
33
  * The options accepted by the constructor are described in detail
34
- * in [this document](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#creating-the-client-instance).
34
+ * in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
35
35
  * The common options are:
36
36
  * @param {object} [options.credentials] - Credentials object.
37
37
  * @param {string} [options.credentials.client_email]
@@ -54,11 +54,10 @@ export declare class BetaAnalyticsDataClient {
54
54
  * API remote host.
55
55
  * @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
56
56
  * Follows the structure of {@link gapicConfig}.
57
- * @param {boolean} [options.fallback] - Use HTTP fallback mode.
58
- * In fallback mode, a special browser-compatible transport implementation is used
59
- * instead of gRPC transport. In browser context (if the `window` object is defined)
60
- * the fallback mode is enabled automatically; set `options.fallback` to `false`
61
- * if you need to override this behavior.
57
+ * @param {boolean | "rest"} [options.fallback] - Use HTTP fallback mode.
58
+ * Pass "rest" to use HTTP/1.1 REST API instead of gRPC.
59
+ * For more information, please check the
60
+ * {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
62
61
  */
63
62
  constructor(opts?: ClientOptions);
64
63
  /**
@@ -99,25 +98,412 @@ export declare class BetaAnalyticsDataClient {
99
98
  static get scopes(): string[];
100
99
  getProjectId(): Promise<string>;
101
100
  getProjectId(callback: Callback<string, undefined, undefined>): void;
102
- runReport(request?: protos.google.analytics.data.v1beta.IRunReportRequest, options?: CallOptions): Promise<[protos.google.analytics.data.v1beta.IRunReportResponse, protos.google.analytics.data.v1beta.IRunReportRequest | undefined, {} | undefined]>;
101
+ /**
102
+ * Returns a customized report of your Google Analytics event data. Reports
103
+ * contain statistics derived from data collected by the Google Analytics
104
+ * tracking code. The data returned from the API is as a table with columns
105
+ * for the requested dimensions and metrics. Metrics are individual
106
+ * measurements of user activity on your property, such as active users or
107
+ * event count. Dimensions break down metrics across some common criteria,
108
+ * such as country or event name.
109
+ *
110
+ * @param {Object} request
111
+ * The request object that will be sent.
112
+ * @param {string} request.property
113
+ * A Google Analytics GA4 property identifier whose events are tracked.
114
+ * Specified in the URL path and not the body. To learn more, see [where to
115
+ * find your Property
116
+ * ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
117
+ * Within a batch request, this property should either be unspecified or
118
+ * consistent with the batch-level property.
119
+ *
120
+ * Example: properties/1234
121
+ * @param {number[]} request.dimensions
122
+ * The dimensions requested and displayed.
123
+ * @param {number[]} request.metrics
124
+ * The metrics requested and displayed.
125
+ * @param {number[]} request.dateRanges
126
+ * Date ranges of data to read. If multiple date ranges are requested, each
127
+ * response row will contain a zero based date range index. If two date
128
+ * ranges overlap, the event data for the overlapping days is included in the
129
+ * response rows for both date ranges. In a cohort request, this `dateRanges`
130
+ * must be unspecified.
131
+ * @param {google.analytics.data.v1beta.FilterExpression} request.dimensionFilter
132
+ * Dimension filters allow you to ask for only specific dimension values in
133
+ * the report. To learn more, see [Fundamentals of Dimension
134
+ * Filters](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#dimension_filters)
135
+ * for examples. Metrics cannot be used in this filter.
136
+ * @param {google.analytics.data.v1beta.FilterExpression} request.metricFilter
137
+ * The filter clause of metrics. Applied at post aggregation phase, similar to
138
+ * SQL having-clause. Dimensions cannot be used in this filter.
139
+ * @param {number} request.offset
140
+ * The row count of the start row. The first row is counted as row 0.
141
+ *
142
+ * When paging, the first request does not specify offset; or equivalently,
143
+ * sets offset to 0; the first request returns the first `limit` of rows. The
144
+ * second request sets offset to the `limit` of the first request; the second
145
+ * request returns the second `limit` of rows.
146
+ *
147
+ * To learn more about this pagination parameter, see
148
+ * [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
149
+ * @param {number} request.limit
150
+ * The number of rows to return. If unspecified, 10,000 rows are returned. The
151
+ * API returns a maximum of 100,000 rows per request, no matter how many you
152
+ * ask for. `limit` must be positive.
153
+ *
154
+ * The API can also return fewer rows than the requested `limit`, if there
155
+ * aren't as many dimension values as the `limit`. For instance, there are
156
+ * fewer than 300 possible values for the dimension `country`, so when
157
+ * reporting on only `country`, you can't get more than 300 rows, even if you
158
+ * set `limit` to a higher value.
159
+ *
160
+ * To learn more about this pagination parameter, see
161
+ * [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
162
+ * @param {number[]} request.metricAggregations
163
+ * Aggregation of metrics. Aggregated metric values will be shown in rows
164
+ * where the dimension_values are set to "RESERVED_(MetricAggregation)".
165
+ * @param {number[]} request.orderBys
166
+ * Specifies how rows are ordered in the response.
167
+ * @param {string} request.currencyCode
168
+ * A currency code in ISO4217 format, such as "AED", "USD", "JPY".
169
+ * If the field is empty, the report uses the property's default currency.
170
+ * @param {google.analytics.data.v1beta.CohortSpec} request.cohortSpec
171
+ * Cohort group associated with this request. If there is a cohort group
172
+ * in the request the 'cohort' dimension must be present.
173
+ * @param {boolean} request.keepEmptyRows
174
+ * If false or unspecified, each row with all metrics equal to 0 will not be
175
+ * returned. If true, these rows will be returned if they are not separately
176
+ * removed by a filter.
177
+ * @param {boolean} request.returnPropertyQuota
178
+ * Toggles whether to return the current state of this Analytics Property's
179
+ * quota. Quota is returned in [PropertyQuota](#PropertyQuota).
180
+ * @param {object} [options]
181
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
182
+ * @returns {Promise} - The promise which resolves to an array.
183
+ * The first element of the array is an object representing [RunReportResponse]{@link google.analytics.data.v1beta.RunReportResponse}.
184
+ * Please see the
185
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
186
+ * for more details and examples.
187
+ * @example <caption>include:samples/generated/v1beta/beta_analytics_data.run_report.js</caption>
188
+ * region_tag:analyticsdata_v1beta_generated_BetaAnalyticsData_RunReport_async
189
+ */
190
+ runReport(request?: protos.google.analytics.data.v1beta.IRunReportRequest, options?: CallOptions): Promise<[
191
+ protos.google.analytics.data.v1beta.IRunReportResponse,
192
+ protos.google.analytics.data.v1beta.IRunReportRequest | undefined,
193
+ {} | undefined
194
+ ]>;
103
195
  runReport(request: protos.google.analytics.data.v1beta.IRunReportRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1beta.IRunReportResponse, protos.google.analytics.data.v1beta.IRunReportRequest | null | undefined, {} | null | undefined>): void;
104
196
  runReport(request: protos.google.analytics.data.v1beta.IRunReportRequest, callback: Callback<protos.google.analytics.data.v1beta.IRunReportResponse, protos.google.analytics.data.v1beta.IRunReportRequest | null | undefined, {} | null | undefined>): void;
105
- runPivotReport(request?: protos.google.analytics.data.v1beta.IRunPivotReportRequest, options?: CallOptions): Promise<[protos.google.analytics.data.v1beta.IRunPivotReportResponse, protos.google.analytics.data.v1beta.IRunPivotReportRequest | undefined, {} | undefined]>;
197
+ /**
198
+ * Returns a customized pivot report of your Google Analytics event data.
199
+ * Pivot reports are more advanced and expressive formats than regular
200
+ * reports. In a pivot report, dimensions are only visible if they are
201
+ * included in a pivot. Multiple pivots can be specified to further dissect
202
+ * your data.
203
+ *
204
+ * @param {Object} request
205
+ * The request object that will be sent.
206
+ * @param {string} request.property
207
+ * A Google Analytics GA4 property identifier whose events are tracked.
208
+ * Specified in the URL path and not the body. To learn more, see [where to
209
+ * find your Property
210
+ * ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
211
+ * Within a batch request, this property should either be unspecified or
212
+ * consistent with the batch-level property.
213
+ *
214
+ * Example: properties/1234
215
+ * @param {number[]} request.dimensions
216
+ * The dimensions requested. All defined dimensions must be used by one of the
217
+ * following: dimension_expression, dimension_filter, pivots, order_bys.
218
+ * @param {number[]} request.metrics
219
+ * The metrics requested, at least one metric needs to be specified. All
220
+ * defined metrics must be used by one of the following: metric_expression,
221
+ * metric_filter, order_bys.
222
+ * @param {number[]} request.dateRanges
223
+ * The date range to retrieve event data for the report. If multiple date
224
+ * ranges are specified, event data from each date range is used in the
225
+ * report. A special dimension with field name "dateRange" can be included in
226
+ * a Pivot's field names; if included, the report compares between date
227
+ * ranges. In a cohort request, this `dateRanges` must be unspecified.
228
+ * @param {number[]} request.pivots
229
+ * Describes the visual format of the report's dimensions in columns or rows.
230
+ * The union of the fieldNames (dimension names) in all pivots must be a
231
+ * subset of dimension names defined in Dimensions. No two pivots can share a
232
+ * dimension. A dimension is only visible if it appears in a pivot.
233
+ * @param {google.analytics.data.v1beta.FilterExpression} request.dimensionFilter
234
+ * The filter clause of dimensions. Dimensions must be requested to be used in
235
+ * this filter. Metrics cannot be used in this filter.
236
+ * @param {google.analytics.data.v1beta.FilterExpression} request.metricFilter
237
+ * The filter clause of metrics. Applied at post aggregation phase, similar to
238
+ * SQL having-clause. Metrics must be requested to be used in this filter.
239
+ * Dimensions cannot be used in this filter.
240
+ * @param {string} request.currencyCode
241
+ * A currency code in ISO4217 format, such as "AED", "USD", "JPY".
242
+ * If the field is empty, the report uses the property's default currency.
243
+ * @param {google.analytics.data.v1beta.CohortSpec} request.cohortSpec
244
+ * Cohort group associated with this request. If there is a cohort group
245
+ * in the request the 'cohort' dimension must be present.
246
+ * @param {boolean} request.keepEmptyRows
247
+ * If false or unspecified, each row with all metrics equal to 0 will not be
248
+ * returned. If true, these rows will be returned if they are not separately
249
+ * removed by a filter.
250
+ * @param {boolean} request.returnPropertyQuota
251
+ * Toggles whether to return the current state of this Analytics Property's
252
+ * quota. Quota is returned in [PropertyQuota](#PropertyQuota).
253
+ * @param {object} [options]
254
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
255
+ * @returns {Promise} - The promise which resolves to an array.
256
+ * The first element of the array is an object representing [RunPivotReportResponse]{@link google.analytics.data.v1beta.RunPivotReportResponse}.
257
+ * Please see the
258
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
259
+ * for more details and examples.
260
+ * @example <caption>include:samples/generated/v1beta/beta_analytics_data.run_pivot_report.js</caption>
261
+ * region_tag:analyticsdata_v1beta_generated_BetaAnalyticsData_RunPivotReport_async
262
+ */
263
+ runPivotReport(request?: protos.google.analytics.data.v1beta.IRunPivotReportRequest, options?: CallOptions): Promise<[
264
+ protos.google.analytics.data.v1beta.IRunPivotReportResponse,
265
+ protos.google.analytics.data.v1beta.IRunPivotReportRequest | undefined,
266
+ {} | undefined
267
+ ]>;
106
268
  runPivotReport(request: protos.google.analytics.data.v1beta.IRunPivotReportRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1beta.IRunPivotReportResponse, protos.google.analytics.data.v1beta.IRunPivotReportRequest | null | undefined, {} | null | undefined>): void;
107
269
  runPivotReport(request: protos.google.analytics.data.v1beta.IRunPivotReportRequest, callback: Callback<protos.google.analytics.data.v1beta.IRunPivotReportResponse, protos.google.analytics.data.v1beta.IRunPivotReportRequest | null | undefined, {} | null | undefined>): void;
108
- batchRunReports(request?: protos.google.analytics.data.v1beta.IBatchRunReportsRequest, options?: CallOptions): Promise<[protos.google.analytics.data.v1beta.IBatchRunReportsResponse, protos.google.analytics.data.v1beta.IBatchRunReportsRequest | undefined, {} | undefined]>;
270
+ /**
271
+ * Returns multiple reports in a batch. All reports must be for the same
272
+ * GA4 Property.
273
+ *
274
+ * @param {Object} request
275
+ * The request object that will be sent.
276
+ * @param {string} request.property
277
+ * A Google Analytics GA4 property identifier whose events are tracked.
278
+ * Specified in the URL path and not the body. To learn more, see [where to
279
+ * find your Property
280
+ * ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
281
+ * This property must be specified for the batch. The property within
282
+ * RunReportRequest may either be unspecified or consistent with this
283
+ * property.
284
+ *
285
+ * Example: properties/1234
286
+ * @param {number[]} request.requests
287
+ * Individual requests. Each request has a separate report response. Each
288
+ * batch request is allowed up to 5 requests.
289
+ * @param {object} [options]
290
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
291
+ * @returns {Promise} - The promise which resolves to an array.
292
+ * The first element of the array is an object representing [BatchRunReportsResponse]{@link google.analytics.data.v1beta.BatchRunReportsResponse}.
293
+ * Please see the
294
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
295
+ * for more details and examples.
296
+ * @example <caption>include:samples/generated/v1beta/beta_analytics_data.batch_run_reports.js</caption>
297
+ * region_tag:analyticsdata_v1beta_generated_BetaAnalyticsData_BatchRunReports_async
298
+ */
299
+ batchRunReports(request?: protos.google.analytics.data.v1beta.IBatchRunReportsRequest, options?: CallOptions): Promise<[
300
+ protos.google.analytics.data.v1beta.IBatchRunReportsResponse,
301
+ protos.google.analytics.data.v1beta.IBatchRunReportsRequest | undefined,
302
+ {} | undefined
303
+ ]>;
109
304
  batchRunReports(request: protos.google.analytics.data.v1beta.IBatchRunReportsRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1beta.IBatchRunReportsResponse, protos.google.analytics.data.v1beta.IBatchRunReportsRequest | null | undefined, {} | null | undefined>): void;
110
305
  batchRunReports(request: protos.google.analytics.data.v1beta.IBatchRunReportsRequest, callback: Callback<protos.google.analytics.data.v1beta.IBatchRunReportsResponse, protos.google.analytics.data.v1beta.IBatchRunReportsRequest | null | undefined, {} | null | undefined>): void;
111
- batchRunPivotReports(request?: protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest, options?: CallOptions): Promise<[protos.google.analytics.data.v1beta.IBatchRunPivotReportsResponse, (protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest | undefined), {} | undefined]>;
306
+ /**
307
+ * Returns multiple pivot reports in a batch. All reports must be for the same
308
+ * GA4 Property.
309
+ *
310
+ * @param {Object} request
311
+ * The request object that will be sent.
312
+ * @param {string} request.property
313
+ * A Google Analytics GA4 property identifier whose events are tracked.
314
+ * Specified in the URL path and not the body. To learn more, see [where to
315
+ * find your Property
316
+ * ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
317
+ * This property must be specified for the batch. The property within
318
+ * RunPivotReportRequest may either be unspecified or consistent with this
319
+ * property.
320
+ *
321
+ * Example: properties/1234
322
+ * @param {number[]} request.requests
323
+ * Individual requests. Each request has a separate pivot report response.
324
+ * Each batch request is allowed up to 5 requests.
325
+ * @param {object} [options]
326
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
327
+ * @returns {Promise} - The promise which resolves to an array.
328
+ * The first element of the array is an object representing [BatchRunPivotReportsResponse]{@link google.analytics.data.v1beta.BatchRunPivotReportsResponse}.
329
+ * Please see the
330
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
331
+ * for more details and examples.
332
+ * @example <caption>include:samples/generated/v1beta/beta_analytics_data.batch_run_pivot_reports.js</caption>
333
+ * region_tag:analyticsdata_v1beta_generated_BetaAnalyticsData_BatchRunPivotReports_async
334
+ */
335
+ batchRunPivotReports(request?: protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest, options?: CallOptions): Promise<[
336
+ protos.google.analytics.data.v1beta.IBatchRunPivotReportsResponse,
337
+ (protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest | undefined),
338
+ {} | undefined
339
+ ]>;
112
340
  batchRunPivotReports(request: protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1beta.IBatchRunPivotReportsResponse, protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest | null | undefined, {} | null | undefined>): void;
113
341
  batchRunPivotReports(request: protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest, callback: Callback<protos.google.analytics.data.v1beta.IBatchRunPivotReportsResponse, protos.google.analytics.data.v1beta.IBatchRunPivotReportsRequest | null | undefined, {} | null | undefined>): void;
114
- getMetadata(request?: protos.google.analytics.data.v1beta.IGetMetadataRequest, options?: CallOptions): Promise<[protos.google.analytics.data.v1beta.IMetadata, protos.google.analytics.data.v1beta.IGetMetadataRequest | undefined, {} | undefined]>;
342
+ /**
343
+ * Returns metadata for dimensions and metrics available in reporting methods.
344
+ * Used to explore the dimensions and metrics. In this method, a Google
345
+ * Analytics GA4 Property Identifier is specified in the request, and
346
+ * the metadata response includes Custom dimensions and metrics as well as
347
+ * Universal metadata.
348
+ *
349
+ * For example if a custom metric with parameter name `levels_unlocked` is
350
+ * registered to a property, the Metadata response will contain
351
+ * `customEvent:levels_unlocked`. Universal metadata are dimensions and
352
+ * metrics applicable to any property such as `country` and `totalUsers`.
353
+ *
354
+ * @param {Object} request
355
+ * The request object that will be sent.
356
+ * @param {string} request.name
357
+ * Required. The resource name of the metadata to retrieve. This name field is
358
+ * specified in the URL path and not URL parameters. Property is a numeric
359
+ * Google Analytics GA4 Property identifier. To learn more, see [where to find
360
+ * your Property
361
+ * ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
362
+ *
363
+ * Example: properties/1234/metadata
364
+ *
365
+ * Set the Property ID to 0 for dimensions and metrics common to all
366
+ * properties. In this special mode, this method will not return custom
367
+ * dimensions and metrics.
368
+ * @param {object} [options]
369
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
370
+ * @returns {Promise} - The promise which resolves to an array.
371
+ * The first element of the array is an object representing [Metadata]{@link google.analytics.data.v1beta.Metadata}.
372
+ * Please see the
373
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
374
+ * for more details and examples.
375
+ * @example <caption>include:samples/generated/v1beta/beta_analytics_data.get_metadata.js</caption>
376
+ * region_tag:analyticsdata_v1beta_generated_BetaAnalyticsData_GetMetadata_async
377
+ */
378
+ getMetadata(request?: protos.google.analytics.data.v1beta.IGetMetadataRequest, options?: CallOptions): Promise<[
379
+ protos.google.analytics.data.v1beta.IMetadata,
380
+ protos.google.analytics.data.v1beta.IGetMetadataRequest | undefined,
381
+ {} | undefined
382
+ ]>;
115
383
  getMetadata(request: protos.google.analytics.data.v1beta.IGetMetadataRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1beta.IMetadata, protos.google.analytics.data.v1beta.IGetMetadataRequest | null | undefined, {} | null | undefined>): void;
116
384
  getMetadata(request: protos.google.analytics.data.v1beta.IGetMetadataRequest, callback: Callback<protos.google.analytics.data.v1beta.IMetadata, protos.google.analytics.data.v1beta.IGetMetadataRequest | null | undefined, {} | null | undefined>): void;
117
- runRealtimeReport(request?: protos.google.analytics.data.v1beta.IRunRealtimeReportRequest, options?: CallOptions): Promise<[protos.google.analytics.data.v1beta.IRunRealtimeReportResponse, protos.google.analytics.data.v1beta.IRunRealtimeReportRequest | undefined, {} | undefined]>;
385
+ /**
386
+ * The Google Analytics Realtime API returns a customized report of realtime
387
+ * event data for your property. These reports show events and usage from the
388
+ * last 30 minutes.
389
+ *
390
+ * @param {Object} request
391
+ * The request object that will be sent.
392
+ * @param {string} request.property
393
+ * A Google Analytics GA4 property identifier whose events are tracked.
394
+ * Specified in the URL path and not the body. To learn more, see [where to
395
+ * find your Property
396
+ * ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
397
+ *
398
+ * Example: properties/1234
399
+ * @param {number[]} request.dimensions
400
+ * The dimensions requested and displayed.
401
+ * @param {number[]} request.metrics
402
+ * The metrics requested and displayed.
403
+ * @param {google.analytics.data.v1beta.FilterExpression} request.dimensionFilter
404
+ * The filter clause of dimensions. Dimensions must be requested to be used in
405
+ * this filter. Metrics cannot be used in this filter.
406
+ * @param {google.analytics.data.v1beta.FilterExpression} request.metricFilter
407
+ * The filter clause of metrics. Applied at post aggregation phase, similar to
408
+ * SQL having-clause. Metrics must be requested to be used in this filter.
409
+ * Dimensions cannot be used in this filter.
410
+ * @param {number} request.limit
411
+ * The number of rows to return. If unspecified, 10,000 rows are returned. The
412
+ * API returns a maximum of 100,000 rows per request, no matter how many you
413
+ * ask for. `limit` must be positive.
414
+ *
415
+ * The API can also return fewer rows than the requested `limit`, if there
416
+ * aren't as many dimension values as the `limit`. For instance, there are
417
+ * fewer than 300 possible values for the dimension `country`, so when
418
+ * reporting on only `country`, you can't get more than 300 rows, even if you
419
+ * set `limit` to a higher value.
420
+ * @param {number[]} request.metricAggregations
421
+ * Aggregation of metrics. Aggregated metric values will be shown in rows
422
+ * where the dimension_values are set to "RESERVED_(MetricAggregation)".
423
+ * @param {number[]} request.orderBys
424
+ * Specifies how rows are ordered in the response.
425
+ * @param {boolean} request.returnPropertyQuota
426
+ * Toggles whether to return the current state of this Analytics Property's
427
+ * Realtime quota. Quota is returned in [PropertyQuota](#PropertyQuota).
428
+ * @param {number[]} request.minuteRanges
429
+ * The minute ranges of event data to read. If unspecified, one minute range
430
+ * for the last 30 minutes will be used. If multiple minute ranges are
431
+ * requested, each response row will contain a zero based minute range index.
432
+ * If two minute ranges overlap, the event data for the overlapping minutes is
433
+ * included in the response rows for both minute ranges.
434
+ * @param {object} [options]
435
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
436
+ * @returns {Promise} - The promise which resolves to an array.
437
+ * The first element of the array is an object representing [RunRealtimeReportResponse]{@link google.analytics.data.v1beta.RunRealtimeReportResponse}.
438
+ * Please see the
439
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
440
+ * for more details and examples.
441
+ * @example <caption>include:samples/generated/v1beta/beta_analytics_data.run_realtime_report.js</caption>
442
+ * region_tag:analyticsdata_v1beta_generated_BetaAnalyticsData_RunRealtimeReport_async
443
+ */
444
+ runRealtimeReport(request?: protos.google.analytics.data.v1beta.IRunRealtimeReportRequest, options?: CallOptions): Promise<[
445
+ protos.google.analytics.data.v1beta.IRunRealtimeReportResponse,
446
+ protos.google.analytics.data.v1beta.IRunRealtimeReportRequest | undefined,
447
+ {} | undefined
448
+ ]>;
118
449
  runRealtimeReport(request: protos.google.analytics.data.v1beta.IRunRealtimeReportRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1beta.IRunRealtimeReportResponse, protos.google.analytics.data.v1beta.IRunRealtimeReportRequest | null | undefined, {} | null | undefined>): void;
119
450
  runRealtimeReport(request: protos.google.analytics.data.v1beta.IRunRealtimeReportRequest, callback: Callback<protos.google.analytics.data.v1beta.IRunRealtimeReportResponse, protos.google.analytics.data.v1beta.IRunRealtimeReportRequest | null | undefined, {} | null | undefined>): void;
120
- checkCompatibility(request?: protos.google.analytics.data.v1beta.ICheckCompatibilityRequest, options?: CallOptions): Promise<[protos.google.analytics.data.v1beta.ICheckCompatibilityResponse, (protos.google.analytics.data.v1beta.ICheckCompatibilityRequest | undefined), {} | undefined]>;
451
+ /**
452
+ * This compatibility method lists dimensions and metrics that can be added to
453
+ * a report request and maintain compatibility. This method fails if the
454
+ * request's dimensions and metrics are incompatible.
455
+ *
456
+ * In Google Analytics, reports fail if they request incompatible dimensions
457
+ * and/or metrics; in that case, you will need to remove dimensions and/or
458
+ * metrics from the incompatible report until the report is compatible.
459
+ *
460
+ * The Realtime and Core reports have different compatibility rules. This
461
+ * method checks compatibility for Core reports.
462
+ *
463
+ * @param {Object} request
464
+ * The request object that will be sent.
465
+ * @param {string} request.property
466
+ * A Google Analytics GA4 property identifier whose events are tracked. To
467
+ * learn more, see [where to find your Property
468
+ * ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
469
+ * `property` should be the same value as in your `runReport` request.
470
+ *
471
+ * Example: properties/1234
472
+ *
473
+ * Set the Property ID to 0 for compatibility checking on dimensions and
474
+ * metrics common to all properties. In this special mode, this method will
475
+ * not return custom dimensions and metrics.
476
+ * @param {number[]} request.dimensions
477
+ * The dimensions in this report. `dimensions` should be the same value as in
478
+ * your `runReport` request.
479
+ * @param {number[]} request.metrics
480
+ * The metrics in this report. `metrics` should be the same value as in your
481
+ * `runReport` request.
482
+ * @param {google.analytics.data.v1beta.FilterExpression} request.dimensionFilter
483
+ * The filter clause of dimensions. `dimensionFilter` should be the same value
484
+ * as in your `runReport` request.
485
+ * @param {google.analytics.data.v1beta.FilterExpression} request.metricFilter
486
+ * The filter clause of metrics. `metricFilter` should be the same value as in
487
+ * your `runReport` request
488
+ * @param {google.analytics.data.v1beta.Compatibility} request.compatibilityFilter
489
+ * Filters the dimensions and metrics in the response to just this
490
+ * compatibility. Commonly used as `”compatibilityFilter”: “COMPATIBLE”`
491
+ * to only return compatible dimensions & metrics.
492
+ * @param {object} [options]
493
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
494
+ * @returns {Promise} - The promise which resolves to an array.
495
+ * The first element of the array is an object representing [CheckCompatibilityResponse]{@link google.analytics.data.v1beta.CheckCompatibilityResponse}.
496
+ * Please see the
497
+ * [documentation](https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#regular-methods)
498
+ * for more details and examples.
499
+ * @example <caption>include:samples/generated/v1beta/beta_analytics_data.check_compatibility.js</caption>
500
+ * region_tag:analyticsdata_v1beta_generated_BetaAnalyticsData_CheckCompatibility_async
501
+ */
502
+ checkCompatibility(request?: protos.google.analytics.data.v1beta.ICheckCompatibilityRequest, options?: CallOptions): Promise<[
503
+ protos.google.analytics.data.v1beta.ICheckCompatibilityResponse,
504
+ (protos.google.analytics.data.v1beta.ICheckCompatibilityRequest | undefined),
505
+ {} | undefined
506
+ ]>;
121
507
  checkCompatibility(request: protos.google.analytics.data.v1beta.ICheckCompatibilityRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1beta.ICheckCompatibilityResponse, protos.google.analytics.data.v1beta.ICheckCompatibilityRequest | null | undefined, {} | null | undefined>): void;
122
508
  checkCompatibility(request: protos.google.analytics.data.v1beta.ICheckCompatibilityRequest, callback: Callback<protos.google.analytics.data.v1beta.ICheckCompatibilityResponse, protos.google.analytics.data.v1beta.ICheckCompatibilityRequest | null | undefined, {} | null | undefined>): void;
123
509
  /**