@google-analytics/data 5.0.0 → 5.2.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.
@@ -270,7 +270,7 @@ export declare class AlphaAnalyticsDataClient {
270
270
  */
271
271
  queryAudienceList(request?: protos.google.analytics.data.v1alpha.IQueryAudienceListRequest, options?: CallOptions): Promise<[
272
272
  protos.google.analytics.data.v1alpha.IQueryAudienceListResponse,
273
- (protos.google.analytics.data.v1alpha.IQueryAudienceListRequest | undefined),
273
+ protos.google.analytics.data.v1alpha.IQueryAudienceListRequest | undefined,
274
274
  {} | undefined
275
275
  ]>;
276
276
  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;
@@ -333,7 +333,7 @@ export declare class AlphaAnalyticsDataClient {
333
333
  */
334
334
  sheetExportAudienceList(request?: protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest, options?: CallOptions): Promise<[
335
335
  protos.google.analytics.data.v1alpha.ISheetExportAudienceListResponse,
336
- (protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest | undefined),
336
+ protos.google.analytics.data.v1alpha.ISheetExportAudienceListRequest | undefined,
337
337
  {} | undefined
338
338
  ]>;
339
339
  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;
@@ -411,7 +411,7 @@ export declare class AlphaAnalyticsDataClient {
411
411
  */
412
412
  createRecurringAudienceList(request?: protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest, options?: CallOptions): Promise<[
413
413
  protos.google.analytics.data.v1alpha.IRecurringAudienceList,
414
- (protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest | undefined),
414
+ protos.google.analytics.data.v1alpha.ICreateRecurringAudienceListRequest | undefined,
415
415
  {} | undefined
416
416
  ]>;
417
417
  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;
@@ -446,7 +446,7 @@ export declare class AlphaAnalyticsDataClient {
446
446
  */
447
447
  getRecurringAudienceList(request?: protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest, options?: CallOptions): Promise<[
448
448
  protos.google.analytics.data.v1alpha.IRecurringAudienceList,
449
- (protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest | undefined),
449
+ protos.google.analytics.data.v1alpha.IGetRecurringAudienceListRequest | undefined,
450
450
  {} | undefined
451
451
  ]>;
452
452
  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;
@@ -471,7 +471,7 @@ export declare class AlphaAnalyticsDataClient {
471
471
  */
472
472
  getPropertyQuotasSnapshot(request?: protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest, options?: CallOptions): Promise<[
473
473
  protos.google.analytics.data.v1alpha.IPropertyQuotasSnapshot,
474
- (protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest | undefined),
474
+ protos.google.analytics.data.v1alpha.IGetPropertyQuotasSnapshotRequest | undefined,
475
475
  {} | undefined
476
476
  ]>;
477
477
  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;
@@ -669,49 +669,49 @@ export declare class AlphaAnalyticsDataClient {
669
669
  */
670
670
  checkCreateReportTaskProgress(name: string): Promise<LROperation<protos.google.analytics.data.v1alpha.ReportTask, protos.google.analytics.data.v1alpha.ReportTaskMetadata>>;
671
671
  /**
672
- * Lists all audience lists for a property. This method can be used for you to
673
- * find and reuse existing audience lists rather than creating unnecessary new
674
- * audience lists. The same audience can have multiple audience lists that
675
- * represent the list of users that were in an audience on different days.
676
- *
677
- * See [Creating an Audience
678
- * List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
679
- * for an introduction to Audience Lists with examples.
680
- *
681
- * This method is available at beta stability at
682
- * [audienceExports.list](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/list).
683
- * To give your feedback on this API, complete the
684
- * [Google Analytics Audience Export API
685
- * Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
686
- *
687
- * @param {Object} request
688
- * The request object that will be sent.
689
- * @param {string} request.parent
690
- * Required. All audience lists for this property will be listed in the
691
- * response. Format: `properties/{property}`
692
- * @param {number} [request.pageSize]
693
- * Optional. The maximum number of audience lists to return. The service may
694
- * return fewer than this value. If unspecified, at most 200 audience lists
695
- * will be returned. The maximum value is 1000 (higher values will be coerced
696
- * to the maximum).
697
- * @param {string} [request.pageToken]
698
- * Optional. A page token, received from a previous `ListAudienceLists` call.
699
- * Provide this to retrieve the subsequent page.
700
- *
701
- * When paginating, all other parameters provided to `ListAudienceLists` must
702
- * match the call that provided the page token.
703
- * @param {object} [options]
704
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
705
- * @returns {Promise} - The promise which resolves to an array.
706
- * The first element of the array is Array of {@link protos.google.analytics.data.v1alpha.AudienceList|AudienceList}.
707
- * The client library will perform auto-pagination by default: it will call the API as many
708
- * times as needed and will merge results from all the pages into this array.
709
- * Note that it can affect your quota.
710
- * We recommend using `listAudienceListsAsync()`
711
- * method described below for async iteration which you can stop as needed.
712
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
713
- * for more details and examples.
714
- */
672
+ * Lists all audience lists for a property. This method can be used for you to
673
+ * find and reuse existing audience lists rather than creating unnecessary new
674
+ * audience lists. The same audience can have multiple audience lists that
675
+ * represent the list of users that were in an audience on different days.
676
+ *
677
+ * See [Creating an Audience
678
+ * List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
679
+ * for an introduction to Audience Lists with examples.
680
+ *
681
+ * This method is available at beta stability at
682
+ * [audienceExports.list](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/list).
683
+ * To give your feedback on this API, complete the
684
+ * [Google Analytics Audience Export API
685
+ * Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
686
+ *
687
+ * @param {Object} request
688
+ * The request object that will be sent.
689
+ * @param {string} request.parent
690
+ * Required. All audience lists for this property will be listed in the
691
+ * response. Format: `properties/{property}`
692
+ * @param {number} [request.pageSize]
693
+ * Optional. The maximum number of audience lists to return. The service may
694
+ * return fewer than this value. If unspecified, at most 200 audience lists
695
+ * will be returned. The maximum value is 1000 (higher values will be coerced
696
+ * to the maximum).
697
+ * @param {string} [request.pageToken]
698
+ * Optional. A page token, received from a previous `ListAudienceLists` call.
699
+ * Provide this to retrieve the subsequent page.
700
+ *
701
+ * When paginating, all other parameters provided to `ListAudienceLists` must
702
+ * match the call that provided the page token.
703
+ * @param {object} [options]
704
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
705
+ * @returns {Promise} - The promise which resolves to an array.
706
+ * The first element of the array is Array of {@link protos.google.analytics.data.v1alpha.AudienceList|AudienceList}.
707
+ * The client library will perform auto-pagination by default: it will call the API as many
708
+ * times as needed and will merge results from all the pages into this array.
709
+ * Note that it can affect your quota.
710
+ * We recommend using `listAudienceListsAsync()`
711
+ * method described below for async iteration which you can stop as needed.
712
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
713
+ * for more details and examples.
714
+ */
715
715
  listAudienceLists(request?: protos.google.analytics.data.v1alpha.IListAudienceListsRequest, options?: CallOptions): Promise<[
716
716
  protos.google.analytics.data.v1alpha.IAudienceList[],
717
717
  protos.google.analytics.data.v1alpha.IListAudienceListsRequest | null,
@@ -783,49 +783,49 @@ export declare class AlphaAnalyticsDataClient {
783
783
  */
784
784
  listAudienceListsAsync(request?: protos.google.analytics.data.v1alpha.IListAudienceListsRequest, options?: CallOptions): AsyncIterable<protos.google.analytics.data.v1alpha.IAudienceList>;
785
785
  /**
786
- * Lists all recurring audience lists for a property. This method can be used
787
- * for you to find and reuse existing recurring audience lists rather than
788
- * creating unnecessary new recurring audience lists. The same audience can
789
- * have multiple recurring audience lists that represent different dimension
790
- * combinations; for example, just the dimension `deviceId` or both the
791
- * dimensions `deviceId` and `userId`.
792
- *
793
- * This method is introduced at alpha stability with the intention of
794
- * gathering feedback on syntax and capabilities before entering beta. To give
795
- * your feedback on this API, complete the
796
- * [Google Analytics Audience Export API
797
- * Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
798
- *
799
- * @param {Object} request
800
- * The request object that will be sent.
801
- * @param {string} request.parent
802
- * Required. All recurring audience lists for this property will be listed in
803
- * the response. Format: `properties/{property}`
804
- * @param {number} [request.pageSize]
805
- * Optional. The maximum number of recurring audience lists to return. The
806
- * service may return fewer than this value. If unspecified, at most 200
807
- * recurring audience lists will be returned. The maximum value is 1000
808
- * (higher values will be coerced to the maximum).
809
- * @param {string} [request.pageToken]
810
- * Optional. A page token, received from a previous
811
- * `ListRecurringAudienceLists` call. Provide this to retrieve the subsequent
812
- * page.
813
- *
814
- * When paginating, all other parameters provided to
815
- * `ListRecurringAudienceLists` must match the call that provided the page
816
- * token.
817
- * @param {object} [options]
818
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
819
- * @returns {Promise} - The promise which resolves to an array.
820
- * The first element of the array is Array of {@link protos.google.analytics.data.v1alpha.RecurringAudienceList|RecurringAudienceList}.
821
- * The client library will perform auto-pagination by default: it will call the API as many
822
- * times as needed and will merge results from all the pages into this array.
823
- * Note that it can affect your quota.
824
- * We recommend using `listRecurringAudienceListsAsync()`
825
- * method described below for async iteration which you can stop as needed.
826
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
827
- * for more details and examples.
828
- */
786
+ * Lists all recurring audience lists for a property. This method can be used
787
+ * for you to find and reuse existing recurring audience lists rather than
788
+ * creating unnecessary new recurring audience lists. The same audience can
789
+ * have multiple recurring audience lists that represent different dimension
790
+ * combinations; for example, just the dimension `deviceId` or both the
791
+ * dimensions `deviceId` and `userId`.
792
+ *
793
+ * This method is introduced at alpha stability with the intention of
794
+ * gathering feedback on syntax and capabilities before entering beta. To give
795
+ * your feedback on this API, complete the
796
+ * [Google Analytics Audience Export API
797
+ * Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
798
+ *
799
+ * @param {Object} request
800
+ * The request object that will be sent.
801
+ * @param {string} request.parent
802
+ * Required. All recurring audience lists for this property will be listed in
803
+ * the response. Format: `properties/{property}`
804
+ * @param {number} [request.pageSize]
805
+ * Optional. The maximum number of recurring audience lists to return. The
806
+ * service may return fewer than this value. If unspecified, at most 200
807
+ * recurring audience lists will be returned. The maximum value is 1000
808
+ * (higher values will be coerced to the maximum).
809
+ * @param {string} [request.pageToken]
810
+ * Optional. A page token, received from a previous
811
+ * `ListRecurringAudienceLists` call. Provide this to retrieve the subsequent
812
+ * page.
813
+ *
814
+ * When paginating, all other parameters provided to
815
+ * `ListRecurringAudienceLists` must match the call that provided the page
816
+ * token.
817
+ * @param {object} [options]
818
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
819
+ * @returns {Promise} - The promise which resolves to an array.
820
+ * The first element of the array is Array of {@link protos.google.analytics.data.v1alpha.RecurringAudienceList|RecurringAudienceList}.
821
+ * The client library will perform auto-pagination by default: it will call the API as many
822
+ * times as needed and will merge results from all the pages into this array.
823
+ * Note that it can affect your quota.
824
+ * We recommend using `listRecurringAudienceListsAsync()`
825
+ * method described below for async iteration which you can stop as needed.
826
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
827
+ * for more details and examples.
828
+ */
829
829
  listRecurringAudienceLists(request?: protos.google.analytics.data.v1alpha.IListRecurringAudienceListsRequest, options?: CallOptions): Promise<[
830
830
  protos.google.analytics.data.v1alpha.IRecurringAudienceList[],
831
831
  protos.google.analytics.data.v1alpha.IListRecurringAudienceListsRequest | null,
@@ -901,30 +901,30 @@ export declare class AlphaAnalyticsDataClient {
901
901
  */
902
902
  listRecurringAudienceListsAsync(request?: protos.google.analytics.data.v1alpha.IListRecurringAudienceListsRequest, options?: CallOptions): AsyncIterable<protos.google.analytics.data.v1alpha.IRecurringAudienceList>;
903
903
  /**
904
- * Lists all report tasks for a property.
905
- *
906
- * @param {Object} request
907
- * The request object that will be sent.
908
- * @param {string} request.parent
909
- * Required. All report tasks for this property will be listed in the
910
- * response. Format: `properties/{property}`
911
- * @param {number} [request.pageSize]
912
- * Optional. The maximum number of report tasks to return.
913
- * @param {string} [request.pageToken]
914
- * Optional. A page token, received from a previous `ListReportTasks` call.
915
- * Provide this to retrieve the subsequent page.
916
- * @param {object} [options]
917
- * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
918
- * @returns {Promise} - The promise which resolves to an array.
919
- * The first element of the array is Array of {@link protos.google.analytics.data.v1alpha.ReportTask|ReportTask}.
920
- * The client library will perform auto-pagination by default: it will call the API as many
921
- * times as needed and will merge results from all the pages into this array.
922
- * Note that it can affect your quota.
923
- * We recommend using `listReportTasksAsync()`
924
- * method described below for async iteration which you can stop as needed.
925
- * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
926
- * for more details and examples.
927
- */
904
+ * Lists all report tasks for a property.
905
+ *
906
+ * @param {Object} request
907
+ * The request object that will be sent.
908
+ * @param {string} request.parent
909
+ * Required. All report tasks for this property will be listed in the
910
+ * response. Format: `properties/{property}`
911
+ * @param {number} [request.pageSize]
912
+ * Optional. The maximum number of report tasks to return.
913
+ * @param {string} [request.pageToken]
914
+ * Optional. A page token, received from a previous `ListReportTasks` call.
915
+ * Provide this to retrieve the subsequent page.
916
+ * @param {object} [options]
917
+ * Call options. See {@link https://googleapis.dev/nodejs/google-gax/latest/interfaces/CallOptions.html|CallOptions} for more details.
918
+ * @returns {Promise} - The promise which resolves to an array.
919
+ * The first element of the array is Array of {@link protos.google.analytics.data.v1alpha.ReportTask|ReportTask}.
920
+ * The client library will perform auto-pagination by default: it will call the API as many
921
+ * times as needed and will merge results from all the pages into this array.
922
+ * Note that it can affect your quota.
923
+ * We recommend using `listReportTasksAsync()`
924
+ * method described below for async iteration which you can stop as needed.
925
+ * Please see the {@link https://github.com/googleapis/gax-nodejs/blob/master/client-libraries.md#auto-pagination | documentation }
926
+ * for more details and examples.
927
+ */
928
928
  listReportTasks(request?: protos.google.analytics.data.v1alpha.IListReportTasksRequest, options?: CallOptions): Promise<[
929
929
  protos.google.analytics.data.v1alpha.IReportTask[],
930
930
  protos.google.analytics.data.v1alpha.IListReportTasksRequest | null,
@@ -984,35 +984,35 @@ export declare class AlphaAnalyticsDataClient {
984
984
  */
985
985
  listReportTasksAsync(request?: protos.google.analytics.data.v1alpha.IListReportTasksRequest, options?: CallOptions): AsyncIterable<protos.google.analytics.data.v1alpha.IReportTask>;
986
986
  /**
987
- * Gets the latest state of a long-running operation. Clients can use this
988
- * method to poll the operation result at intervals as recommended by the API
989
- * service.
990
- *
991
- * @param {Object} request - The request object that will be sent.
992
- * @param {string} request.name - The name of the operation resource.
993
- * @param {Object=} options
994
- * Optional parameters. You can override the default settings for this call,
995
- * e.g, timeout, retries, paginations, etc. See {@link
996
- * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
997
- * for the details.
998
- * @param {function(?Error, ?Object)=} callback
999
- * The function which will be called with the result of the API call.
1000
- *
1001
- * The second parameter to the callback is an object representing
1002
- * {@link google.longrunning.Operation | google.longrunning.Operation}.
1003
- * @return {Promise} - The promise which resolves to an array.
1004
- * The first element of the array is an object representing
1005
- * {@link google.longrunning.Operation | google.longrunning.Operation}.
1006
- * The promise has a method named "cancel" which cancels the ongoing API call.
1007
- *
1008
- * @example
1009
- * ```
1010
- * const client = longrunning.operationsClient();
1011
- * const name = '';
1012
- * const [response] = await client.getOperation({name});
1013
- * // doThingsWith(response)
1014
- * ```
1015
- */
987
+ * Gets the latest state of a long-running operation. Clients can use this
988
+ * method to poll the operation result at intervals as recommended by the API
989
+ * service.
990
+ *
991
+ * @param {Object} request - The request object that will be sent.
992
+ * @param {string} request.name - The name of the operation resource.
993
+ * @param {Object=} options
994
+ * Optional parameters. You can override the default settings for this call,
995
+ * e.g, timeout, retries, paginations, etc. See {@link
996
+ * https://googleapis.github.io/gax-nodejs/global.html#CallOptions | gax.CallOptions}
997
+ * for the details.
998
+ * @param {function(?Error, ?Object)=} callback
999
+ * The function which will be called with the result of the API call.
1000
+ *
1001
+ * The second parameter to the callback is an object representing
1002
+ * {@link google.longrunning.Operation | google.longrunning.Operation}.
1003
+ * @return {Promise} - The promise which resolves to an array.
1004
+ * The first element of the array is an object representing
1005
+ * {@link google.longrunning.Operation | google.longrunning.Operation}.
1006
+ * The promise has a method named "cancel" which cancels the ongoing API call.
1007
+ *
1008
+ * @example
1009
+ * ```
1010
+ * const client = longrunning.operationsClient();
1011
+ * const name = '';
1012
+ * const [response] = await client.getOperation({name});
1013
+ * // doThingsWith(response)
1014
+ * ```
1015
+ */
1016
1016
  getOperation(request: protos.google.longrunning.GetOperationRequest, optionsOrCallback?: gax.CallOptions | Callback<protos.google.longrunning.Operation, protos.google.longrunning.GetOperationRequest, {} | null | undefined>, callback?: Callback<protos.google.longrunning.Operation, protos.google.longrunning.GetOperationRequest, {} | null | undefined>): Promise<[protos.google.longrunning.Operation]>;
1017
1017
  /**
1018
1018
  * Lists operations that match the specified filter in the request. If the
@@ -1044,7 +1044,7 @@ export declare class AlphaAnalyticsDataClient {
1044
1044
  * // doThingsWith(response)
1045
1045
  * ```
1046
1046
  */
1047
- listOperationsAsync(request: protos.google.longrunning.ListOperationsRequest, options?: gax.CallOptions): AsyncIterable<protos.google.longrunning.ListOperationsResponse>;
1047
+ listOperationsAsync(request: protos.google.longrunning.ListOperationsRequest, options?: gax.CallOptions): AsyncIterable<protos.google.longrunning.IOperation>;
1048
1048
  /**
1049
1049
  * Starts asynchronous cancellation on a long-running operation. The server
1050
1050
  * makes a best effort to cancel the operation, but success is not