Class AlphaAnalyticsDataGrpc.AlphaAnalyticsDataFutureStub (0.52.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
NameDescription
channelio.grpc.Channel
callOptionsio.grpc.CallOptions
Returns
TypeDescription
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
NameDescription
requestCreateAudienceListRequest
Returns
TypeDescription
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
NameDescription
requestCreateRecurringAudienceListRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<RecurringAudienceList>

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
NameDescription
requestGetAudienceListRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<AudienceList>

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
NameDescription
requestGetRecurringAudienceListRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<RecurringAudienceList>

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
NameDescription
requestListAudienceListsRequest
Returns
TypeDescription
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
NameDescription
requestListRecurringAudienceListsRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<ListRecurringAudienceListsResponse>

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
NameDescription
requestQueryAudienceListRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<QueryAudienceListResponse>

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
NameDescription
requestRunFunnelReportRequest
Returns
TypeDescription
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
NameDescription
requestSheetExportAudienceListRequest
Returns
TypeDescription
com.google.common.util.concurrent.ListenableFuture<SheetExportAudienceListResponse>