@google-analytics/data
Version:
729 lines (728 loc) • 79.8 kB
TypeScript
import type * as gax from 'google-gax';
import type { Callback, CallOptions, Descriptors, ClientOptions, LROperation, PaginationCallback } from 'google-gax';
import { Transform } from 'stream';
import * as protos from '../../protos/protos';
/**
* Google Analytics reporting data service.
* @class
* @memberof v1alpha
*/
export declare class AlphaAnalyticsDataClient {
private _terminated;
private _opts;
private _providedCustomServicePath;
private _gaxModule;
private _gaxGrpc;
private _protos;
private _defaults;
private _universeDomain;
private _servicePath;
private _log;
auth: gax.GoogleAuth;
descriptors: Descriptors;
warn: (code: string, message: string, warnType?: string) => void;
innerApiCalls: {
[name: string]: Function;
};
pathTemplates: {
[name: string]: gax.PathTemplate;
};
operationsClient: gax.OperationsClient;
alphaAnalyticsDataStub?: Promise<{
[name: string]: Function;
}>;
/**
* Construct an instance of AlphaAnalyticsDataClient.
*
* @param {object} [options] - The configuration object.
* The options accepted by the constructor are described in detail
* in [this document](https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#creating-the-client-instance).
* The common options are:
* @param {object} [options.credentials] - Credentials object.
* @param {string} [options.credentials.client_email]
* @param {string} [options.credentials.private_key]
* @param {string} [options.email] - Account email address. Required when
* using a .pem or .p12 keyFilename.
* @param {string} [options.keyFilename] - Full path to the a .json, .pem, or
* .p12 key downloaded from the Google Developers Console. If you provide
* a path to a JSON file, the projectId option below is not necessary.
* NOTE: .pem and .p12 require you to specify options.email as well.
* @param {number} [options.port] - The port on which to connect to
* the remote host.
* @param {string} [options.projectId] - The project ID from the Google
* Developer's Console, e.g. 'grape-spaceship-123'. We will also check
* the environment variable GCLOUD_PROJECT for your project ID. If your
* app is running in an environment which supports
* {@link https://cloud.google.com/docs/authentication/application-default-credentials Application Default Credentials},
* your project ID will be detected automatically.
* @param {string} [options.apiEndpoint] - The domain name of the
* API remote host.
* @param {gax.ClientConfig} [options.clientConfig] - Client configuration override.
* Follows the structure of {@link gapicConfig}.
* @param {boolean} [options.fallback] - Use HTTP/1.1 REST mode.
* For more information, please check the
* {@link https://github.com/googleapis/gax-nodejs/blob/main/client-libraries.md#http11-rest-api-mode documentation}.
* @param {gax} [gaxInstance]: loaded instance of `google-gax`. Useful if you
* need to avoid loading the default gRPC version and want to use the fallback
* HTTP implementation. Load only fallback version and pass it to the constructor:
* ```
* const gax = require('google-gax/build/src/fallback'); // avoids loading google-gax with gRPC
* const client = new AlphaAnalyticsDataClient({fallback: true}, gax);
* ```
*/
constructor(opts?: ClientOptions, gaxInstance?: typeof gax | typeof gax.fallback);
/**
* Initialize the client.
* Performs asynchronous operations (such as authentication) and prepares the client.
* This function will be called automatically when any class method is called for the
* first time, but if you need to initialize it before calling an actual method,
* feel free to call initialize() directly.
*
* You can await on this method if you want to make sure the client is initialized.
*
* @returns {Promise} A promise that resolves to an authenticated service stub.
*/
initialize(): Promise<{
[name: string]: Function;
}>;
/**
* The DNS address for this API service.
* @deprecated Use the apiEndpoint method of the client instance.
* @returns {string} The DNS address for this service.
*/
static get servicePath(): string;
/**
* The DNS address for this API service - same as servicePath.
* @deprecated Use the apiEndpoint method of the client instance.
* @returns {string} The DNS address for this service.
*/
static get apiEndpoint(): string;
/**
* The DNS address for this API service.
* @returns {string} The DNS address for this service.
*/
get apiEndpoint(): string;
get universeDomain(): string;
/**
* The port for this API service.
* @returns {number} The default port for this service.
*/
static get port(): number;
/**
* The scopes needed to make gRPC calls for every method defined
* in this service.
* @returns {string[]} List of default scopes.
*/
static get scopes(): string[];
getProjectId(): Promise<string>;
getProjectId(callback: Callback<string, undefined, undefined>): void;
/**
* Returns a customized funnel report of your Google Analytics event data. The
* data returned from the API is as a table with columns for the requested
* dimensions and metrics.
*
* Funnel exploration lets you visualize the steps your users take to complete
* a task and quickly see how well they are succeeding or failing at each
* step. For example, how do prospects become shoppers and then become buyers?
* How do one time buyers become repeat buyers? With this information, you can
* improve inefficient or abandoned customer journeys. To learn more, see [GA4
* Funnel Explorations](https://support.google.com/analytics/answer/9327974).
*
* This method is introduced at alpha stability with the intention of
* gathering feedback on syntax and capabilities before entering beta. To give
* your feedback on this API, complete the [Google Analytics Data API Funnel
* Reporting
* Feedback](https://docs.google.com/forms/d/e/1FAIpQLSdwOlQDJAUoBiIgUZZ3S_Lwi8gr7Bb0k1jhvc-DEg7Rol3UjA/viewform).
*
* @param {Object} request
* The request object that will be sent.
* @param {string} [request.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.
*
* Example: properties/1234
* @param {number[]} [request.dateRanges]
* Optional. Date ranges of data to read. If multiple date ranges are
* requested, each response row will contain a zero based date range index. If
* two date ranges overlap, the event data for the overlapping days is
* included in the response rows for both date ranges.
* @param {google.analytics.data.v1alpha.Funnel} [request.funnel]
* Optional. The configuration of this request's funnel. This funnel
* configuration is required.
* @param {google.analytics.data.v1alpha.FunnelBreakdown} [request.funnelBreakdown]
* Optional. If specified, this breakdown adds a dimension to the funnel table
* sub report response. This breakdown dimension expands each funnel step to
* the unique values of the breakdown dimension. For example, a breakdown by
* the `deviceCategory` dimension will create rows for `mobile`, `tablet`,
* `desktop`, and the total.
* @param {google.analytics.data.v1alpha.FunnelNextAction} [request.funnelNextAction]
* Optional. If specified, next action adds a dimension to the funnel
* visualization sub report response. This next action dimension expands each
* funnel step to the unique values of the next action. For example a next
* action of the `eventName` dimension will create rows for several events
* (for example `session_start` & `click`) and the total.
*
* Next action only supports `eventName` and most Page / Screen dimensions
* like `pageTitle` and `pagePath`.
* @param {google.analytics.data.v1alpha.RunFunnelReportRequest.FunnelVisualizationType} [request.funnelVisualizationType]
* Optional. The funnel visualization type controls the dimensions present in
* the funnel visualization sub report response. If not specified,
* `STANDARD_FUNNEL` is used.
* @param {number[]} [request.segments]
* Optional. The configurations of segments. Segments are subsets of a
* property's data. In a funnel report with segments, the funnel is evaluated
* in each segment.
*
* Each segment specified in this request
* produces a separate row in the response; in the response, each segment
* identified by its name.
*
* The segments parameter is optional. Requests are limited to 4 segments.
* @param {number} [request.limit]
* Optional. The number of rows to return. If unspecified, 10,000 rows are
* returned. The API returns a maximum of 250,000 rows per request, no matter
* how many you ask for. `limit` must be positive.
*
* The API can also return fewer rows than the requested `limit`, if there
* aren't as many dimension values as the `limit`.
* @param {google.analytics.data.v1alpha.FilterExpression} [request.dimensionFilter]
* Optional. Dimension filters allow you to ask for only specific dimension
* values in the report. To learn more, see [Creating a Report: Dimension
* Filters](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#dimension_filters)
* for examples. Metrics cannot be used in this filter.
* @param {boolean} [request.returnPropertyQuota]
* Optional. Toggles whether to return the current state of this Analytics
* Property's quota. Quota is returned in [PropertyQuota](#PropertyQuota).
* @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.RunFunnelReportResponse|RunFunnelReportResponse}.
* 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.run_funnel_report.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_RunFunnelReport_async
*/
runFunnelReport(request?: protos.google.analytics.data.v1alpha.IRunFunnelReportRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IRunFunnelReportResponse,
protos.google.analytics.data.v1alpha.IRunFunnelReportRequest | undefined,
{} | undefined
]>;
runFunnelReport(request: protos.google.analytics.data.v1alpha.IRunFunnelReportRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IRunFunnelReportResponse, protos.google.analytics.data.v1alpha.IRunFunnelReportRequest | null | undefined, {} | null | undefined>): void;
runFunnelReport(request: protos.google.analytics.data.v1alpha.IRunFunnelReportRequest, callback: Callback<protos.google.analytics.data.v1alpha.IRunFunnelReportResponse, protos.google.analytics.data.v1alpha.IRunFunnelReportRequest | null | undefined, {} | null | undefined>): void;
/**
* Retrieves an audience list of users. After creating an audience, the users
* are not immediately available for listing. First, a request to
* `CreateAudienceList` is necessary to create an audience list of users, and
* then second, this method is used to retrieve the users in the audience
* list.
*
* See [Creating an Audience
* List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
* for an introduction to Audience Lists with examples.
*
* Audiences in Google Analytics 4 allow you to segment your users in the ways
* that are important to your business. To learn more, see
* https://support.google.com/analytics/answer/9267572.
*
* This method is available at beta stability at
* [audienceExports.query](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/query).
* To give your feedback on this API, complete the [Google Analytics Audience
* Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Required. The name of the audience list to retrieve users from.
* Format: `properties/{property}/audienceLists/{audience_list}`
* @param {number} [request.offset]
* Optional. The row count of the start row. The first row is counted as row
* 0.
*
* When paging, the first request does not specify offset; or equivalently,
* sets offset to 0; the first request returns the first `limit` of rows. The
* second request sets offset to the `limit` of the first request; the second
* request returns the second `limit` of rows.
*
* To learn more about this pagination parameter, see
* [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
* @param {number} [request.limit]
* Optional. The number of rows to return. If unspecified, 10,000 rows are
* returned. The API returns a maximum of 250,000 rows per request, no matter
* how many you ask for. `limit` must be positive.
*
* The API can also return fewer rows than the requested `limit`, if there
* aren't as many dimension values as the `limit`.
*
* To learn more about this pagination parameter, see
* [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
* @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.QueryAudienceListResponse|QueryAudienceListResponse}.
* 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.query_audience_list.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_QueryAudienceList_async
*/
queryAudienceList(request?: protos.google.analytics.data.v1alpha.IQueryAudienceListRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IQueryAudienceListResponse,
protos.google.analytics.data.v1alpha.IQueryAudienceListRequest | undefined,
{} | undefined
]>;
queryAudienceList(request: protos.google.analytics.data.v1alpha.IQueryAudienceListRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IQueryAudienceListResponse, protos.google.analytics.data.v1alpha.IQueryAudienceListRequest | null | undefined, {} | null | undefined>): void;
queryAudienceList(request: protos.google.analytics.data.v1alpha.IQueryAudienceListRequest, callback: Callback<protos.google.analytics.data.v1alpha.IQueryAudienceListResponse, protos.google.analytics.data.v1alpha.IQueryAudienceListRequest | null | undefined, {} | null | undefined>): void;
/**
* Exports an audience list of users to a Google Sheet. After creating an
* audience, the users are not immediately available for listing. First, a
* request to `CreateAudienceList` is necessary to create an audience list of
* users, and then second, this method is used to export those users in the
* audience list to a Google Sheet.
*
* See [Creating an Audience
* List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
* for an introduction to Audience Lists with examples.
*
* Audiences in Google Analytics 4 allow you to segment your users in the ways
* that are important to your business. To learn more, see
* https://support.google.com/analytics/answer/9267572.
*
* This method is introduced at alpha stability with the intention of
* gathering feedback on syntax and capabilities before entering beta. To give
* your feedback on this API, complete the
* [Google Analytics Audience Export API
* Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Required. The name of the audience list to retrieve users from.
* Format: `properties/{property}/audienceLists/{audience_list}`
* @param {number} [request.offset]
* Optional. The row count of the start row. The first row is counted as row
* 0.
*
* When paging, the first request does not specify offset; or equivalently,
* sets offset to 0; the first request returns the first `limit` of rows. The
* second request sets offset to the `limit` of the first request; the second
* request returns the second `limit` of rows.
*
* To learn more about this pagination parameter, see
* [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
* @param {number} [request.limit]
* Optional. The number of rows to return. If unspecified, 10,000 rows are
* returned. The API returns a maximum of 250,000 rows per request, no matter
* how many you ask for. `limit` must be positive.
*
* The API can also return fewer rows than the requested `limit`, if there
* aren't as many dimension values as the `limit`.
*
* To learn more about this pagination parameter, see
* [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
* @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.SheetExportAudienceListResponse|SheetExportAudienceListResponse}.
* 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.sheet_export_audience_list.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_SheetExportAudienceList_async
*/
sheetExportAudienceList(request?: protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.ISheetExportAudienceListResponse,
protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest | undefined,
{} | undefined
]>;
sheetExportAudienceList(request: protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.ISheetExportAudienceListResponse, protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest | null | undefined, {} | null | undefined>): void;
sheetExportAudienceList(request: protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest, callback: Callback<protos.google.analytics.data.v1alpha.ISheetExportAudienceListResponse, protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest | null | undefined, {} | null | undefined>): void;
/**
* Gets configuration metadata about a specific audience list. This method
* can be used to understand an audience list after it has been created.
*
* See [Creating an Audience
* List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
* for an introduction to Audience Lists with examples.
*
* This method is available at beta stability at
* [audienceExports.get](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/get).
* To give your feedback on this API, complete the
* [Google Analytics Audience Export API
* Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Required. The audience list resource name.
* Format: `properties/{property}/audienceLists/{audience_list}`
* @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.AudienceList|AudienceList}.
* 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_audience_list.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_GetAudienceList_async
*/
getAudienceList(request?: protos.google.analytics.data.v1alpha.IGetAudienceListRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IAudienceList,
protos.google.analytics.data.v1alpha.IGetAudienceListRequest | undefined,
{} | undefined
]>;
getAudienceList(request: protos.google.analytics.data.v1alpha.IGetAudienceListRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IAudienceList, protos.google.analytics.data.v1alpha.IGetAudienceListRequest | null | undefined, {} | null | undefined>): void;
getAudienceList(request: protos.google.analytics.data.v1alpha.IGetAudienceListRequest, callback: Callback<protos.google.analytics.data.v1alpha.IAudienceList, protos.google.analytics.data.v1alpha.IGetAudienceListRequest | null | undefined, {} | null | undefined>): void;
/**
* Creates a recurring audience list. Recurring audience lists produces new
* audience lists each day. Audience lists are users in an audience at the
* time of the list's creation.
*
* A recurring audience list ensures that you have audience list based on the
* most recent data available for use each day. If you manually create
* audience list, you don't know when an audience list based on an additional
* day's data is available. This recurring audience list automates the
* creation of an audience list when an additional day's data is available.
* You will consume fewer quota tokens by using recurring audience list versus
* manually creating audience list at various times of day trying to guess
* when an additional day's data is ready.
*
* This method is introduced at alpha stability with the intention of
* gathering feedback on syntax and capabilities before entering beta. To give
* your feedback on this API, complete the
* [Google Analytics Audience Export API
* Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The parent resource where this recurring audience list will be
* created. Format: `properties/{property}`
* @param {google.analytics.data.v1alpha.RecurringAudienceList} request.recurringAudienceList
* Required. The recurring audience list to create.
* @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.RecurringAudienceList|RecurringAudienceList}.
* 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.create_recurring_audience_list.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_CreateRecurringAudienceList_async
*/
createRecurringAudienceList(request?: protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IRecurringAudienceList,
protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest | undefined,
{} | undefined
]>;
createRecurringAudienceList(request: protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IRecurringAudienceList, protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest | null | undefined, {} | null | undefined>): void;
createRecurringAudienceList(request: protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest, callback: Callback<protos.google.analytics.data.v1alpha.IRecurringAudienceList, protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest | null | undefined, {} | null | undefined>): void;
/**
* Gets configuration metadata about a specific recurring audience list. This
* method can be used to understand a recurring audience list's state after it
* has been created. For example, a recurring audience list resource will
* generate audience list instances for each day, and this method can be used
* to get the resource name of the most recent audience list instance.
*
* This method is introduced at alpha stability with the intention of
* gathering feedback on syntax and capabilities before entering beta. To give
* your feedback on this API, complete the
* [Google Analytics Audience Export API
* Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Required. The recurring audience list resource name.
* Format:
* `properties/{property}/recurringAudienceLists/{recurring_audience_list}`
* @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.RecurringAudienceList|RecurringAudienceList}.
* 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_recurring_audience_list.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_GetRecurringAudienceList_async
*/
getRecurringAudienceList(request?: protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IRecurringAudienceList,
protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest | undefined,
{} | undefined
]>;
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
* ACTIVE. This method will return an error if the report task's state is not
* `ACTIVE`. A query response will return the tabular row & column values of
* the report.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Required. The report source name.
* Format: `properties/{property}/reportTasks/{report}`
* @param {number} [request.offset]
* Optional. The row count of the start row in the report. The first row is
* counted as row 0.
*
* When paging, the first request does not specify offset; or equivalently,
* sets offset to 0; the first request returns the first `limit` of rows. The
* second request sets offset to the `limit` of the first request; the second
* request returns the second `limit` of rows.
*
* To learn more about this pagination parameter, see
* [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
* @param {number} [request.limit]
* Optional. The number of rows to return from the report. If unspecified,
* 10,000 rows are returned. The API returns a maximum of 250,000 rows per
* request, no matter how many you ask for. `limit` must be positive.
*
* The API can also return fewer rows than the requested `limit`, if there
* aren't as many dimension values as the `limit`. The number of rows
* available to a QueryReportTaskRequest is further limited by the limit of
* the associated ReportTask. A query can retrieve at most ReportTask.limit
* rows. For example, if the ReportTask has a limit of 1,000, then a
* QueryReportTask request with offset=900 and limit=500 will return at most
* 100 rows.
*
* To learn more about this pagination parameter, see
* [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
* @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.QueryReportTaskResponse|QueryReportTaskResponse}.
* 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.query_report_task.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_QueryReportTask_async
*/
queryReportTask(request?: protos.google.analytics.data.v1alpha.IQueryReportTaskRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IQueryReportTaskResponse,
protos.google.analytics.data.v1alpha.IQueryReportTaskRequest | undefined,
{} | undefined
]>;
queryReportTask(request: protos.google.analytics.data.v1alpha.IQueryReportTaskRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IQueryReportTaskResponse, protos.google.analytics.data.v1alpha.IQueryReportTaskRequest | null | undefined, {} | null | undefined>): void;
queryReportTask(request: protos.google.analytics.data.v1alpha.IQueryReportTaskRequest, callback: Callback<protos.google.analytics.data.v1alpha.IQueryReportTaskResponse, protos.google.analytics.data.v1alpha.IQueryReportTaskRequest | null | undefined, {} | null | undefined>): void;
/**
* Gets report metadata about a specific report task. After creating a report
* task, use this method to check its processing state or inspect its
* report definition.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.name
* Required. The report task resource name.
* Format: `properties/{property}/reportTasks/{report_task}`
* @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.ReportTask|ReportTask}.
* 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_report_task.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_GetReportTask_async
*/
getReportTask(request?: protos.google.analytics.data.v1alpha.IGetReportTaskRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IReportTask,
protos.google.analytics.data.v1alpha.IGetReportTaskRequest | undefined,
{} | undefined
]>;
getReportTask(request: protos.google.analytics.data.v1alpha.IGetReportTaskRequest, options: CallOptions, callback: Callback<protos.google.analytics.data.v1alpha.IReportTask, protos.google.analytics.data.v1alpha.IGetReportTaskRequest | null | undefined, {} | null | undefined>): void;
getReportTask(request: protos.google.analytics.data.v1alpha.IGetReportTaskRequest, callback: Callback<protos.google.analytics.data.v1alpha.IReportTask, protos.google.analytics.data.v1alpha.IGetReportTaskRequest | null | undefined, {} | null | undefined>): void;
/**
* Creates an audience list for later retrieval. This method quickly returns
* the audience list's resource name and initiates a long running asynchronous
* request to form an audience list. To list the users in an audience list,
* first create the audience list through this method and then send the
* audience resource name to the `QueryAudienceList` method.
*
* See [Creating an Audience
* List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
* for an introduction to Audience Lists with examples.
*
* An audience list is a snapshot of the users currently in the audience at
* the time of audience list creation. Creating audience lists for one
* audience on different days will return different results as users enter and
* exit the audience.
*
* Audiences in Google Analytics 4 allow you to segment your users in the ways
* that are important to your business. To learn more, see
* https://support.google.com/analytics/answer/9267572. Audience lists contain
* the users in each audience.
*
* This method is available at beta stability at
* [audienceExports.create](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/create).
* To give your feedback on this API, complete the [Google Analytics Audience
* Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. The parent resource where this audience list will be created.
* Format: `properties/{property}`
* @param {google.analytics.data.v1alpha.AudienceList} request.audienceList
* Required. The audience list to create.
* @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
* a long running operation. Its `promise()` method returns a promise
* you can `await` for.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v1alpha/alpha_analytics_data.create_audience_list.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_CreateAudienceList_async
*/
createAudienceList(request?: protos.google.analytics.data.v1alpha.ICreateAudienceListRequest, options?: CallOptions): Promise<[
LROperation<protos.google.analytics.data.v1alpha.IAudienceList, protos.google.analytics.data.v1alpha.IAudienceListMetadata>,
protos.google.longrunning.IOperation | undefined,
{} | undefined
]>;
createAudienceList(request: protos.google.analytics.data.v1alpha.ICreateAudienceListRequest, options: CallOptions, callback: Callback<LROperation<protos.google.analytics.data.v1alpha.IAudienceList, protos.google.analytics.data.v1alpha.IAudienceListMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
createAudienceList(request: protos.google.analytics.data.v1alpha.ICreateAudienceListRequest, callback: Callback<LROperation<protos.google.analytics.data.v1alpha.IAudienceList, protos.google.analytics.data.v1alpha.IAudienceListMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
/**
* Check the status of the long running operation returned by `createAudienceList()`.
* @param {String} name
* The operation name that will be passed.
* @returns {Promise} - The promise which resolves to an object.
* The decoded operation object has result and metadata field to get information from.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v1alpha/alpha_analytics_data.create_audience_list.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_CreateAudienceList_async
*/
checkCreateAudienceListProgress(name: string): Promise<LROperation<protos.google.analytics.data.v1alpha.AudienceList, protos.google.analytics.data.v1alpha.AudienceListMetadata>>;
/**
* Initiates the creation of a report task. This method quickly
* returns a report task and initiates a long running
* 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
* Required. The parent resource where this report task will be created.
* Format: `properties/{propertyId}`
* @param {google.analytics.data.v1alpha.ReportTask} request.reportTask
* Required. The report task configuration to create.
* @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
* a long running operation. Its `promise()` method returns a promise
* you can `await` for.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v1alpha/alpha_analytics_data.create_report_task.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_CreateReportTask_async
*/
createReportTask(request?: protos.google.analytics.data.v1alpha.ICreateReportTaskRequest, options?: CallOptions): Promise<[
LROperation<protos.google.analytics.data.v1alpha.IReportTask, protos.google.analytics.data.v1alpha.IReportTaskMetadata>,
protos.google.longrunning.IOperation | undefined,
{} | undefined
]>;
createReportTask(request: protos.google.analytics.data.v1alpha.ICreateReportTaskRequest, options: CallOptions, callback: Callback<LROperation<protos.google.analytics.data.v1alpha.IReportTask, protos.google.analytics.data.v1alpha.IReportTaskMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
createReportTask(request: protos.google.analytics.data.v1alpha.ICreateReportTaskRequest, callback: Callback<LROperation<protos.google.analytics.data.v1alpha.IReportTask, protos.google.analytics.data.v1alpha.IReportTaskMetadata>, protos.google.longrunning.IOperation | null | undefined, {} | null | undefined>): void;
/**
* Check the status of the long running operation returned by `createReportTask()`.
* @param {String} name
* The operation name that will be passed.
* @returns {Promise} - The promise which resolves to an object.
* The decoded operation object has result and metadata field to get information from.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#long-running-operations | documentation }
* for more details and examples.
* @example <caption>include:samples/generated/v1alpha/alpha_analytics_data.create_report_task.js</caption>
* region_tag:analyticsdata_v1alpha_generated_AlphaAnalyticsData_CreateReportTask_async
*/
checkCreateReportTaskProgress(name: string): Promise<LROperation<protos.google.analytics.data.v1alpha.ReportTask, protos.google.analytics.data.v1alpha.ReportTaskMetadata>>;
/**
* Lists all audience lists for a property. This method can be used for you to
* find and reuse existing audience lists rather than creating unnecessary new
* audience lists. The same audience can have multiple audience lists that
* represent the list of users that were in an audience on different days.
*
* See [Creating an Audience
* List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
* for an introduction to Audience Lists with examples.
*
* This method is available at beta stability at
* [audienceExports.list](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/list).
* To give your feedback on this API, complete the
* [Google Analytics Audience Export API
* Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
*
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. All audience lists for this property will be listed in the
* response. Format: `properties/{property}`
* @param {number} [request.pageSize]
* Optional. The maximum number of audience lists to return. The service may
* return fewer than this value. If unspecified, at most 200 audience lists
* will be returned. The maximum value is 1000 (higher values will be coerced
* to the maximum).
* @param {string} [request.pageToken]
* Optional. A page token, received from a previous `ListAudienceLists` call.
* Provide this to retrieve the subsequent page.
*
* When paginating, all other parameters provided to `ListAudienceLists` must
* match the call that provided the page token.
* @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 Array of {@link protos.google.analytics.data.v1alpha.AudienceList|AudienceList}.
* The client library will perform auto-pagination by default: it will call the API as many
* times as needed and will merge results from all the pages into this array.
* Note that it can affect your quota.
* We recommend using `listAudienceListsAsync()`
* method described below for async iteration which you can stop as needed.
* Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
* for more details and examples.
*/
listAudienceLists(request?: protos.google.analytics.data.v1alpha.IListAudienceListsRequest, options?: CallOptions): Promise<[
protos.google.analytics.data.v1alpha.IAudienceList[],
protos.google.analytics.data.v1alpha.IListAudienceListsRequest | null,
protos.google.analytics.data.v1alpha.IListAudienceListsResponse
]>;
listAudienceLists(request: protos.google.analytics.data.v1alpha.IListAudienceListsRequest, options: CallOptions, callback: PaginationCallback<protos.google.analytics.data.v1alpha.IListAudienceListsRequest, protos.google.analytics.data.v1alpha.IListAudienceListsResponse | null | undefined, protos.google.analytics.data.v1alpha.IAudienceList>): void;
listAudienceLists(request: protos.google.analytics.data.v1alpha.IListAudienceListsRequest, callback: PaginationCallback<protos.google.analytics.data.v1alpha.IListAudienceListsRequest, protos.google.analytics.data.v1alpha.IListAudienceListsResponse | null | undefined, protos.google.analytics.data.v1alpha.IAudienceList>): void;
/**
* Equivalent to `listAudienceLists`, but returns a NodeJS Stream object.
* @param {Object} request
* The request object that will be sent.
* @param {string} request.parent
* Required. All audience lists for this property will be listed in the
* response. Format: `properties/{property}`