Class AlphaAnalyticsDataGrpc.AlphaAnalyticsDataFutureStub (0.63.0)

public static final class AlphaAnalyticsDataGrpc.AlphaAnalyticsDataFutureStub extends AbstractFutureStub<AlphaAnalyticsDataGrpc.AlphaAnalyticsDataFutureStub>

A stub to allow clients to do ListenableFuture-style rpc calls to service AlphaAnalyticsData.

Google Analytics reporting data service.

Inheritance

java.lang.Object > io.grpc.stub.AbstractStub > io.grpc.stub.AbstractFutureStub > AlphaAnalyticsDataGrpc.AlphaAnalyticsDataFutureStub

Methods

build(Channel channel, CallOptions callOptions)

protected AlphaAnalyticsDataGrpc.AlphaAnalyticsDataFutureStub build(Channel channel, CallOptions callOptions)
Parameters
Name Description
channel io.grpc.Channel
callOptions io.grpc.CallOptions
Returns
Type Description
AlphaAnalyticsDataGrpc.AlphaAnalyticsDataFutureStub
Overrides
io.grpc.stub.AbstractStub.build(io.grpc.Channel,io.grpc.CallOptions)

createAudienceList(CreateAudienceListRequest request)

public ListenableFuture<Operation> createAudienceList(CreateAudienceListRequest request)

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 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. To give your feedback on this API, complete the Google Analytics Audience Export API Feedback form.

Parameter
Name Description
request CreateAudienceListRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

createRecurringAudienceList(CreateRecurringAudienceListRequest request)

public ListenableFuture<RecurringAudienceList> createRecurringAudienceList(CreateRecurringAudienceListRequest request)

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 form.

Parameter
Name Description
request CreateRecurringAudienceListRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<RecurringAudienceList>

createReportTask(CreateReportTaskRequest request)

public ListenableFuture<Operation> createReportTask(CreateReportTaskRequest request)

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.

Parameter
Name Description
request CreateReportTaskRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<Operation>

getAudienceList(GetAudienceListRequest request)

public ListenableFuture<AudienceList> getAudienceList(GetAudienceListRequest request)

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 for an introduction to Audience Lists with examples. This method is available at beta stability at audienceExports.get. To give your feedback on this API, complete the Google Analytics Audience Export API Feedback form.

Parameter
Name Description
request GetAudienceListRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<AudienceList>

getPropertyQuotasSnapshot(GetPropertyQuotasSnapshotRequest request)

public ListenableFuture<PropertyQuotasSnapshot> getPropertyQuotasSnapshot(GetPropertyQuotasSnapshotRequest request)

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.

Parameter
Name Description
request GetPropertyQuotasSnapshotRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<PropertyQuotasSnapshot>

getRecurringAudienceList(GetRecurringAudienceListRequest request)

public ListenableFuture<RecurringAudienceList> getRecurringAudienceList(GetRecurringAudienceListRequest request)

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 form.

Parameter
Name Description
request GetRecurringAudienceListRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<RecurringAudienceList>

getReportTask(GetReportTaskRequest request)

public ListenableFuture<ReportTask> getReportTask(GetReportTaskRequest request)

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.

Parameter
Name Description
request GetReportTaskRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ReportTask>

listAudienceLists(ListAudienceListsRequest request)

public ListenableFuture<ListAudienceListsResponse> listAudienceLists(ListAudienceListsRequest request)

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 for an introduction to Audience Lists with examples. This method is available at beta stability at audienceExports.list. To give your feedback on this API, complete the Google Analytics Audience Export API Feedback form.

Parameter
Name Description
request ListAudienceListsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListAudienceListsResponse>

listRecurringAudienceLists(ListRecurringAudienceListsRequest request)

public ListenableFuture<ListRecurringAudienceListsResponse> listRecurringAudienceLists(ListRecurringAudienceListsRequest request)

Lists all recurring audience lists for a property. This method can be used for you to find and reuse existing recurring audience lists rather than creating unnecessary new recurring audience lists. The same audience can have multiple recurring audience lists that represent different dimension combinations; for example, just the dimension deviceId or both the dimensions deviceId and userId. 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 form.

Parameter
Name Description
request ListRecurringAudienceListsRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListRecurringAudienceListsResponse>

listReportTasks(ListReportTasksRequest request)

public ListenableFuture<ListReportTasksResponse> listReportTasks(ListReportTasksRequest request)

Lists all report tasks for a property.

Parameter
Name Description
request ListReportTasksRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<ListReportTasksResponse>

queryAudienceList(QueryAudienceListRequest request)

public ListenableFuture<QueryAudienceListResponse> queryAudienceList(QueryAudienceListRequest request)

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 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. To give your feedback on this API, complete the Google Analytics Audience Export API Feedback form.

Parameter
Name Description
request QueryAudienceListRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<QueryAudienceListResponse>

queryReportTask(QueryReportTaskRequest request)

public ListenableFuture<QueryReportTaskResponse> queryReportTask(QueryReportTaskRequest request)

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.

Parameter
Name Description
request QueryReportTaskRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<QueryReportTaskResponse>

runFunnelReport(RunFunnelReportRequest request)

public ListenableFuture<RunFunnelReportResponse> runFunnelReport(RunFunnelReportRequest request)

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. 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.

Parameter
Name Description
request RunFunnelReportRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<RunFunnelReportResponse>

sheetExportAudienceList(SheetExportAudienceListRequest request)

public ListenableFuture<SheetExportAudienceListResponse> sheetExportAudienceList(SheetExportAudienceListRequest request)

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 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 form.

Parameter
Name Description
request SheetExportAudienceListRequest
Returns
Type Description
com.google.common.util.concurrent.ListenableFuture<SheetExportAudienceListResponse>