@google-analytics/data 4.2.0 → 4.4.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [4.4.0](https://github.com/googleapis/google-cloud-node/compare/data-v4.3.0...data-v4.4.0) (2024-02-09)
+
+
+### Features
+
+* Trusted Private Cloud support, use the universeDomain parameter  ([#5022](https://github.com/googleapis/google-cloud-node/issues/5022)) ([b6498d8](https://github.com/googleapis/google-cloud-node/commit/b6498d8580d056817981dedbaa0ea5d82e9dccc2))
+
+## [4.3.0](https://github.com/googleapis/google-cloud-node/compare/data-v4.2.0...data-v4.3.0) (2023-12-11)
+
+
+### Features
+
+* [analytics-data] add `CreateAudienceExport`, `QueryAudienceExport`, `GetAudienceExport`, `ListAudienceExports` methods to the Data API v1 beta ([#4878](https://github.com/googleapis/google-cloud-node/issues/4878)) ([1f9dc5a](https://github.com/googleapis/google-cloud-node/commit/1f9dc5ae6faf68324ab358b3f4f40328f62e7b64))
+
 ## [4.2.0](https://github.com/googleapis/google-cloud-node/compare/data-v4.1.0...data-v4.2.0) (2023-11-30)
 
 

package/README.md

@@ -121,7 +121,11 @@ Samples are in the [`samples/`](https://github.com/googleapis/google-cloud-node/
 | Beta_analytics_data.batch_run_pivot_reports | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.batch_run_pivot_reports.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.batch_run_pivot_reports.js,packages/google-analytics-data/samples/README.md) |
 | Beta_analytics_data.batch_run_reports | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.batch_run_reports.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.batch_run_reports.js,packages/google-analytics-data/samples/README.md) |
 | Beta_analytics_data.check_compatibility | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.check_compatibility.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.check_compatibility.js,packages/google-analytics-data/samples/README.md) |
+| Beta_analytics_data.create_audience_export | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.create_audience_export.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.create_audience_export.js,packages/google-analytics-data/samples/README.md) |
+| Beta_analytics_data.get_audience_export | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.get_audience_export.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.get_audience_export.js,packages/google-analytics-data/samples/README.md) |
 | Beta_analytics_data.get_metadata | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.get_metadata.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.get_metadata.js,packages/google-analytics-data/samples/README.md) |
+| Beta_analytics_data.list_audience_exports | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.list_audience_exports.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.list_audience_exports.js,packages/google-analytics-data/samples/README.md) |
+| Beta_analytics_data.query_audience_export | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.query_audience_export.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.query_audience_export.js,packages/google-analytics-data/samples/README.md) |
 | Beta_analytics_data.run_pivot_report | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.run_pivot_report.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.run_pivot_report.js,packages/google-analytics-data/samples/README.md) |
 | Beta_analytics_data.run_realtime_report | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.run_realtime_report.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.run_realtime_report.js,packages/google-analytics-data/samples/README.md) |
 | Beta_analytics_data.run_report | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.run_report.js) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/google-cloud-node&page=editor&open_in_editor=packages/google-analytics-data/samples/generated/v1beta/beta_analytics_data.run_report.js,packages/google-analytics-data/samples/README.md) |

package/build/protos/google/analytics/data/v1alpha/analytics_data_api.proto

@@ -87,11 +87,10 @@ service AlphaAnalyticsData {
   // https://support.google.com/analytics/answer/9267572. Audience lists contain
   // the users in each audience.
   //
-  // 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.
+  // 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.
   rpc CreateAudienceList(CreateAudienceListRequest)
       returns (google.longrunning.Operation) {
     option (google.api.http) = {
@@ -119,11 +118,10 @@ service AlphaAnalyticsData {
   // 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.
+  // 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.
   rpc QueryAudienceList(QueryAudienceListRequest)
       returns (QueryAudienceListResponse) {
     option (google.api.http) = {
@@ -168,9 +166,9 @@ service AlphaAnalyticsData {
   // List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
   // for an introduction to Audience Lists with examples.
   //
-  // 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
+  // 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.
   rpc GetAudienceList(GetAudienceListRequest) returns (AudienceList) {
@@ -189,9 +187,9 @@ service AlphaAnalyticsData {
   // List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
   // for an introduction to Audience Lists with examples.
   //
-  // 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
+  // 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.
   rpc ListAudienceLists(ListAudienceListsRequest)
@@ -344,6 +342,75 @@ message RecurringAudienceList {
   // This list is ordered with the most recently created audience list first.
   repeated string audience_lists = 6
       [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Configures webhook notifications to be sent from the Google
+  // Analytics Data API to your webhook server. Use of webhooks is optional. If
+  // unused, you'll need to poll this API to determine when a recurring audience
+  // list creates new audience lists. Webhooks allow a notification to be sent
+  // to your servers & avoid the need for polling.
+  //
+  // Two POST requests will be sent each time a recurring audience list creates
+  // an audience list. This happens once per day until a recurring audience list
+  // reaches 0 active days remaining. The first request will be sent showing a
+  // newly created audience list in its CREATING state. The second request will
+  // be sent after the audience list completes creation (either the ACTIVE or
+  // FAILED state).
+  optional WebhookNotification webhook_notification = 8
+      [(google.api.field_behavior) = OPTIONAL];
+}
+
+// Configures a long-running operation resource to send a webhook notification
+// from the Google Analytics Data API to your webhook server when the resource
+// updates.
+//
+// Notification configurations contain private values & are only visible to your
+// GCP project. Different GCP projects may attach different webhook
+// notifications to the same long-running operation resource.
+message WebhookNotification {
+  // Optional. The web address that will receive the webhook notification. This
+  // address will receive POST requests as the state of the long running
+  // operation resource changes. The POST request will contain both a JSON
+  // version of the long running operation resource in the body and a
+  // `sentTimestamp` field. The sent timestamp will specify the unix
+  // microseconds since the epoch that the request was sent; this lets you
+  // identify replayed notifications.
+  //
+  // An example URI is
+  // `https://us-central1-example-project-id.cloudfunctions.net/example-function-1`.
+  //
+  // The URI must use HTTPS and point to a site with a valid SSL certificate on
+  // the web server. The URI must have a maximum string length of 128 characters
+  // & use only the allowlisted characters from [RFC
+  // 1738](https://www.rfc-editor.org/rfc/rfc1738).
+  //
+  // When your webhook server receives a notification, it is expected to reply
+  // with an HTTP response status code of 200 within 5 seconds.
+  //
+  // A URI is required to use webhook notifications.
+  //
+  // Requests to this webhook server will contain an ID token authenticating the
+  // service account
+  // `google-analytics-audience-export@system.gserviceaccount.com`. To learn
+  // more about ID tokens, see
+  // https://cloud.google.com/docs/authentication/token-types#id. For Google
+  // Cloud Functions, this lets you configure your function to require
+  // authentication. In Cloud IAM, you will need to grant the service account
+  // permissions to the Cloud Run Invoker (`roles/run.invoker`) & Cloud
+  // Functions Invoker (`roles/cloudfunctions.invoker`) roles for the webhook
+  // post request to pass Google Cloud Functions authentication. This API can
+  // send webhook notifications to arbitrary URIs; for webhook servers other
+  // than Google Cloud Functions, this ID token in the authorization bearer
+  // header should be ignored if it is not needed.
+  optional string uri = 1 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The channel token is an arbitrary string value and must have a
+  // maximum string length of 64 characters. Channel tokens allow you to verify
+  // the source of a webhook notification. This guards against the message being
+  // spoofed. The channel token will be specified in the `X-Goog-Channel-Token`
+  // HTTP header of the webhook POST request.
+  //
+  // A channel token is not required to use webhook notifications.
+  optional string channel_token = 2 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // A request to retrieve configuration metadata about a specific recurring
@@ -547,6 +614,24 @@ message AudienceList {
   // recurring audience list, and this field will be blank.
   optional string recurring_audience_list = 12
       [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Optional. Configures webhook notifications to be sent from the Google
+  // Analytics Data API to your webhook server. Use of webhooks is optional. If
+  // unused, you'll need to poll this API to determine when an audience list is
+  // ready to be used. Webhooks allow a notification to be sent to your servers
+  // & avoid the need for polling.
+  //
+  // Either one or two POST requests will be sent to the webhook. The first POST
+  // request will be sent immediately showing the newly created audience list in
+  // its CREATING state. The second POST request will be sent after the audience
+  // list completes creation (either the ACTIVE or FAILED state).
+  //
+  // If identical audience lists are requested in quick succession, the second &
+  // subsequent audience lists can be served from cache. In that case, the
+  // audience list create method can return an audience list is already ACTIVE.
+  // In this scenario, only one POST request will be sent to the webhook.
+  optional WebhookNotification webhook_notification = 13
+      [(google.api.field_behavior) = OPTIONAL];
 }
 
 // This metadata is currently blank.

package/build/protos/google/analytics/data/v1beta/analytics_data_api.proto

@@ -21,11 +21,17 @@ import "google/api/annotations.proto";
 import "google/api/client.proto";
 import "google/api/field_behavior.proto";
 import "google/api/resource.proto";
+import "google/longrunning/operations.proto";
+import "google/protobuf/timestamp.proto";
 
 option go_package = "google.golang.org/genproto/googleapis/analytics/data/v1beta;data";
 option java_multiple_files = true;
 option java_outer_classname = "AnalyticsDataApiProto";
 option java_package = "com.google.analytics.data.v1beta";
+option (google.api.resource_definition) = {
+  type: "analyticsadmin.googleapis.com/Property"
+  pattern: "properties/{property}"
+};
 
 // Google Analytics reporting data service.
 service BetaAnalyticsData {
@@ -135,6 +141,114 @@ service BetaAnalyticsData {
       body: "*"
     };
   }
+
+  // Creates an audience export for later retrieval. This method quickly returns
+  // the audience export's resource name and initiates a long running
+  // asynchronous request to form an audience export. To export the users in an
+  // audience export, first create the audience export through this method and
+  // then send the audience resource name to the `QueryAudienceExport` method.
+  //
+  // See [Creating an Audience
+  // Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
+  // for an introduction to Audience Exports with examples.
+  //
+  // An audience export is a snapshot of the users currently in the audience at
+  // the time of audience export creation. Creating audience exports 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 exports
+  // contain the users in each audience.
+  //
+  // Audience Export APIs have some methods at alpha and other methods at beta
+  // stability. The intention is to advance methods to beta stability after some
+  // feedback and adoption. To give your feedback on this API, complete the
+  // [Google Analytics Audience Export API
+  // Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
+  rpc CreateAudienceExport(CreateAudienceExportRequest)
+      returns (google.longrunning.Operation) {
+    option (google.api.http) = {
+      post: "/v1beta/{parent=properties/*}/audienceExports"
+      body: "audience_export"
+    };
+    option (google.api.method_signature) = "parent,audience_export";
+    option (google.longrunning.operation_info) = {
+      response_type: "AudienceExport"
+      metadata_type: "AudienceExportMetadata"
+    };
+  }
+
+  // Retrieves an audience export of users. After creating an audience, the
+  // users are not immediately available for exporting. First, a request to
+  // `CreateAudienceExport` is necessary to create an audience export of users,
+  // and then second, this method is used to retrieve the users in the audience
+  // export.
+  //
+  // See [Creating an Audience
+  // Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
+  // for an introduction to Audience Exports 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.
+  //
+  // Audience Export APIs have some methods at alpha and other methods at beta
+  // stability. The intention is to advance methods to beta stability after some
+  // feedback and adoption. To give your feedback on this API, complete the
+  // [Google Analytics Audience Export API
+  // Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
+  rpc QueryAudienceExport(QueryAudienceExportRequest)
+      returns (QueryAudienceExportResponse) {
+    option (google.api.http) = {
+      post: "/v1beta/{name=properties/*/audienceExports/*}:query"
+      body: "*"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Gets configuration metadata about a specific audience export. This method
+  // can be used to understand an audience export after it has been created.
+  //
+  // See [Creating an Audience
+  // Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
+  // for an introduction to Audience Exports with examples.
+  //
+  // Audience Export APIs have some methods at alpha and other methods at beta
+  // stability. The intention is to advance methods to beta stability after some
+  // feedback and adoption. To give your feedback on this API, complete the
+  // [Google Analytics Audience Export API
+  // Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
+  rpc GetAudienceExport(GetAudienceExportRequest) returns (AudienceExport) {
+    option (google.api.http) = {
+      get: "/v1beta/{name=properties/*/audienceExports/*}"
+    };
+    option (google.api.method_signature) = "name";
+  }
+
+  // Lists all audience exports for a property. This method can be used for you
+  // to find and reuse existing audience exports rather than creating
+  // unnecessary new audience exports. The same audience can have multiple
+  // audience exports that represent the export of users that were in an
+  // audience on different days.
+  //
+  // See [Creating an Audience
+  // Export](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics)
+  // for an introduction to Audience Exports with examples.
+  //
+  // Audience Export APIs have some methods at alpha and other methods at beta
+  // stability. The intention is to advance methods to beta stability after some
+  // feedback and adoption. To give your feedback on this API, complete the
+  // [Google Analytics Audience Export API
+  // Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.
+  rpc ListAudienceExports(ListAudienceExportsRequest)
+      returns (ListAudienceExportsResponse) {
+    option (google.api.http) = {
+      get: "/v1beta/{parent=properties/*}/audienceExports"
+    };
+    option (google.api.method_signature) = "parent";
+  }
 }
 
 // The request for compatibility information for a report's dimensions and
@@ -181,7 +295,8 @@ message CheckCompatibilityResponse {
   repeated MetricCompatibility metric_compatibilities = 2;
 }
 
-// The dimensions and metrics currently accepted in reporting methods.
+// The dimensions, metrics and comparisons currently accepted in reporting
+// methods.
 message Metadata {
   option (google.api.resource) = {
     type: "analyticsdata.googleapis.com/Metadata"
@@ -640,3 +755,228 @@ message RunRealtimeReportResponse {
   // between response types in JSON.
   string kind = 9;
 }
+
+// A request to retrieve configuration metadata about a specific audience
+// export.
+message GetAudienceExportRequest {
+  // Required. The audience export resource name.
+  // Format: `properties/{property}/audienceExports/{audience_export}`
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "analyticsdata.googleapis.com/AudienceExport"
+    }
+  ];
+}
+
+// A request to list all audience exports for a property.
+message ListAudienceExportsRequest {
+  // Required. All audience exports for this property will be listed in the
+  // response. Format: `properties/{property}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "analyticsdata.googleapis.com/AudienceExport"
+    }
+  ];
+
+  // Optional. The maximum number of audience exports to return. The service may
+  // return fewer than this value. If unspecified, at most 200 audience exports
+  // will be returned. The maximum value is 1000 (higher values will be coerced
+  // to the maximum).
+  int32 page_size = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A page token, received from a previous `ListAudienceExports`
+  // call. Provide this to retrieve the subsequent page.
+  //
+  // When paginating, all other parameters provided to `ListAudienceExports`
+  // must match the call that provided the page token.
+  string page_token = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A list of all audience exports for a property.
+message ListAudienceExportsResponse {
+  // Each audience export for a property.
+  repeated AudienceExport audience_exports = 1;
+
+  // A token, which can be sent as `page_token` to retrieve the next page.
+  // If this field is omitted, there are no subsequent pages.
+  optional string next_page_token = 2;
+}
+
+// A request to create a new audience export.
+message CreateAudienceExportRequest {
+  // Required. The parent resource where this audience export will be created.
+  // Format: `properties/{property}`
+  string parent = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      child_type: "analyticsdata.googleapis.com/AudienceExport"
+    }
+  ];
+
+  // Required. The audience export to create.
+  AudienceExport audience_export = 2 [(google.api.field_behavior) = REQUIRED];
+}
+
+// An audience export is a list of users in an audience at the time of the
+// list's creation. One audience may have multiple audience exports created for
+// different days.
+message AudienceExport {
+  option (google.api.resource) = {
+    type: "analyticsdata.googleapis.com/AudienceExport"
+    pattern: "properties/{property}/audienceExports/{audience_export}"
+    plural: "audienceExports"
+    singular: "audienceExport"
+  };
+
+  // The AudienceExport currently exists in this state.
+  enum State {
+    // Unspecified state will never be used.
+    STATE_UNSPECIFIED = 0;
+
+    // The AudienceExport is currently creating and will be available in the
+    // future. Creating occurs immediately after the CreateAudienceExport call.
+    CREATING = 1;
+
+    // The AudienceExport is fully created and ready for querying. An
+    // AudienceExport is updated to active asynchronously from a request; this
+    // occurs some time (for example 15 minutes) after the initial create call.
+    ACTIVE = 2;
+
+    // The AudienceExport failed to be created. It is possible that
+    // re-requesting this audience export will succeed.
+    FAILED = 3;
+  }
+
+  // Output only. Identifier. The audience export resource name assigned during
+  // creation. This resource name identifies this `AudienceExport`.
+  //
+  // Format: `properties/{property}/audienceExports/{audience_export}`
+  string name = 1 [
+    (google.api.field_behavior) = IDENTIFIER,
+    (google.api.field_behavior) = OUTPUT_ONLY
+  ];
+
+  // Required. The audience resource name. This resource name identifies the
+  // audience being listed and is shared between the Analytics Data & Admin
+  // APIs.
+  //
+  // Format: `properties/{property}/audiences/{audience}`
+  string audience = 2 [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The descriptive display name for this audience. For example,
+  // "Purchasers".
+  string audience_display_name = 3 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Required. The dimensions requested and displayed in the query response.
+  repeated AudienceDimension dimensions = 4
+      [(google.api.field_behavior) = REQUIRED];
+
+  // Output only. The current state for this AudienceExport.
+  optional State state = 5 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The time when CreateAudienceExport was called and the
+  // AudienceExport began the `CREATING` state.
+  optional google.protobuf.Timestamp begin_creating_time = 6
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The total quota tokens charged during creation of the
+  // AudienceExport. Because this token count is based on activity from the
+  // `CREATING` state, this tokens charged will be fixed once an AudienceExport
+  // enters the `ACTIVE` or `FAILED` states.
+  int32 creation_quota_tokens_charged = 7
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The total number of rows in the AudienceExport result.
+  optional int32 row_count = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. Error message is populated when an audience export fails
+  // during creation. A common reason for such a failure is quota exhaustion.
+  optional string error_message = 9 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+  // Output only. The percentage completed for this audience export ranging
+  // between 0 to 100.
+  optional double percentage_completed = 10
+      [(google.api.field_behavior) = OUTPUT_ONLY];
+}
+
+// This metadata is currently blank.
+message AudienceExportMetadata {}
+
+// A request to list users in an audience export.
+message QueryAudienceExportRequest {
+  // Required. The name of the audience export to retrieve users from.
+  // Format: `properties/{property}/audienceExports/{audience_export}`
+  string name = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // 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).
+  int64 offset = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // 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).
+  int64 limit = 3 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// A list of users in an audience export.
+message QueryAudienceExportResponse {
+  // Configuration data about AudienceExport being queried. Returned to help
+  // interpret the audience rows in this response. For example, the dimensions
+  // in this AudienceExport correspond to the columns in the AudienceRows.
+  optional AudienceExport audience_export = 1;
+
+  // Rows for each user in an audience export. The number of rows in this
+  // response will be less than or equal to request's page size.
+  repeated AudienceRow audience_rows = 2;
+
+  // The total number of rows in the AudienceExport result. `rowCount` is
+  // independent of the number of rows returned in the response, the `limit`
+  // request parameter, and the `offset` request parameter. For example if a
+  // query returns 175 rows and includes `limit` of 50 in the API request, the
+  // response will contain `rowCount` of 175 but only 50 rows.
+  //
+  // To learn more about this pagination parameter, see
+  // [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
+  optional int32 row_count = 3;
+}
+
+// Dimension value attributes for the audience user row.
+message AudienceRow {
+  // Each dimension value attribute for an audience user. One dimension value
+  // will be added for each dimension column requested.
+  repeated AudienceDimensionValue dimension_values = 1;
+}
+
+// An audience dimension is a user attribute. Specific user attributed are
+// requested and then later returned in the `QueryAudienceExportResponse`.
+message AudienceDimension {
+  // Optional. The API name of the dimension. See the [API
+  // Dimensions](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-api-schema#dimensions)
+  // for the list of dimension names.
+  string dimension_name = 1 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The value of a dimension.
+message AudienceDimensionValue {
+  // One kind of dimension value.
+  oneof one_value {
+    // Value as a string if the dimension type is a string.
+    string value = 1;
+  }
+}