@google-analytics/data 5.2.2 → 6.0.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -61,6 +61,7 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | create recurring audience list | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.create_recurring_audience_list.js) |
 | create report task | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.create_report_task.js) |
 | get audience list | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.get_audience_list.js) |
+| get metadata | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.get_metadata.js) |
 | get property quotas snapshot | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.get_property_quotas_snapshot.js) |
 | get recurring audience list | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.get_recurring_audience_list.js) |
 | get report task | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.get_report_task.js) |
@@ -70,7 +71,7 @@ Samples are in the [`samples/`][homepage_samples] directory. Each sample's `READ
 | query audience list | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.query_audience_list.js) |
 | query report task | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.query_report_task.js) |
 | run funnel report | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.run_funnel_report.js) |
-| sheet export audience list | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.sheet_export_audience_list.js) |
+| run report | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/alpha_analytics_data.run_report.js) |
 | analytics | [source code](https://github.com/googleapis/google-cloud-node/blob/main/packages/google-analytics-data/samples/generated/v1alpha/snippet_metadata_google.analytics.data.v1alpha.json) |
 | 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) |
 | 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) |

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

@@ -1,4 +1,4 @@
-// Copyright 2025 Google LLC
+// Copyright 2026 Google LLC
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
@@ -38,10 +38,7 @@ service AlphaAnalyticsData {
   option (google.api.default_host) = "analyticsdata.googleapis.com";
   option (google.api.oauth_scopes) =
       "https://www.googleapis.com/auth/analytics,"
-      "https://www.googleapis.com/auth/analytics.readonly,"
-      "https://www.googleapis.com/auth/drive,"
-      "https://www.googleapis.com/auth/drive.file,"
-      "https://www.googleapis.com/auth/spreadsheets";
+      "https://www.googleapis.com/auth/analytics.readonly";
 
   // 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
@@ -131,34 +128,6 @@ service AlphaAnalyticsData {
     option (google.api.method_signature) = "name";
   }
 
-  // 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.
-  rpc SheetExportAudienceList(SheetExportAudienceListRequest)
-      returns (SheetExportAudienceListResponse) {
-    option (google.api.http) = {
-      post: "/v1alpha/{name=properties/*/audienceLists/*}:exportSheet"
-      body: "*"
-    };
-    option (google.api.method_signature) = "name";
-  }
-
   // Gets configuration metadata about a specific audience list. This method
   // can be used to understand an audience list after it has been created.
   //
@@ -331,6 +300,37 @@ service AlphaAnalyticsData {
     };
     option (google.api.method_signature) = "parent";
   }
+
+  // Returns a customized report of your Google Analytics event data. Reports
+  // contain statistics derived from data collected by the Google Analytics
+  // tracking code. The data returned from the API is as a table with columns
+  // for the requested dimensions and metrics. Metrics are individual
+  // measurements of user activity on your property, such as active users or
+  // event count. Dimensions break down metrics across some common criteria,
+  // such as country or event name.
+  rpc RunReport(RunReportRequest) returns (RunReportResponse) {
+    option (google.api.http) = {
+      post: "/v1alpha/{property=properties/*}:runReport"
+      body: "*"
+    };
+  }
+
+  // Returns metadata for dimensions and metrics available in reporting methods.
+  // Used to explore the dimensions and metrics. In this method, a Google
+  // Analytics property identifier is specified in the request, and
+  // the metadata response includes Custom dimensions and metrics as well as
+  // Universal metadata.
+  //
+  // For example if a custom metric with parameter name `levels_unlocked` is
+  // registered to a property, the Metadata response will contain
+  // `customEvent:levels_unlocked`. Universal metadata are dimensions and
+  // metrics applicable to any property such as `country` and `totalUsers`.
+  rpc GetMetadata(GetMetadataRequest) returns (Metadata) {
+    option (google.api.http) = {
+      get: "/v1alpha/{name=properties/*/metadata}"
+    };
+    option (google.api.method_signature) = "name";
+  }
 }
 
 // A request to create a new recurring audience list.
@@ -789,69 +789,6 @@ message QueryAudienceListResponse {
   optional int32 row_count = 3;
 }
 
-// A request to export users in an audience list to a Google Sheet.
-message SheetExportAudienceListRequest {
-  // Required. The name of the audience list to retrieve users from.
-  // Format: `properties/{property}/audienceLists/{audience_list}`
-  string name = 1 [
-    (google.api.field_behavior) = REQUIRED,
-    (google.api.resource_reference) = {
-      type: "analyticsdata.googleapis.com/AudienceList"
-    }
-  ];
-
-  // 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];
-}
-
-// The created Google Sheet with the list of users in an audience list.
-message SheetExportAudienceListResponse {
-  // A uri for you to visit in your browser to view the Google Sheet.
-  optional string spreadsheet_uri = 1;
-
-  // An ID that identifies the created Google Sheet resource.
-  optional string spreadsheet_id = 2;
-
-  // The total number of rows in the AudienceList 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;
-
-  // Configuration data about AudienceList being exported. Returned to help
-  // interpret the AudienceList in the Google Sheet of this response.
-  //
-  // For example, the AudienceList may have more rows than are present in the
-  // Google Sheet, and in that case, you may want to send an additional sheet
-  // export request with a different `offset` value to retrieve the next page of
-  // rows in an additional Google Sheet.
-  optional AudienceList audience_list = 4;
-}
-
 // Dimension value attributes for the audience user row.
 message AudienceRow {
   // Each dimension value attribute for an audience user. One dimension value
@@ -1302,3 +1239,206 @@ message ListReportTasksResponse {
   // If this field is omitted, there are no subsequent pages.
   optional string next_page_token = 2;
 }
+
+// The request to generate a report.
+message RunReportRequest {
+  // Required. 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
+  string property = 1 [(google.api.field_behavior) = REQUIRED];
+
+  // Optional. The dimensions requested and displayed.
+  repeated Dimension dimensions = 2 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The metrics requested and displayed.
+  repeated Metric metrics = 3 [(google.api.field_behavior) = OPTIONAL];
+
+  // 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. In a cohort request,
+  // this `dateRanges` must be unspecified.
+  repeated DateRange date_ranges = 4 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Dimension filters let you ask for only specific dimension values
+  // in the report. To learn more, see [Fundamentals of Dimension
+  // Filters](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#dimension_filters)
+  // for examples. Metrics cannot be used in this filter.
+  FilterExpression dimension_filter = 5
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The filter clause of metrics. Applied after aggregating the
+  // report's rows, similar to SQL having-clause. Dimensions cannot be used in
+  // this filter.
+  FilterExpression metric_filter = 6 [(google.api.field_behavior) = OPTIONAL];
+
+  // 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 = 7 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The maximum 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`. For instance, there are
+  // fewer than 300 possible values for the dimension `country`, so when
+  // reporting on only `country`, you can't get more than 300 rows, even if you
+  // set `limit` to a higher value.
+  //
+  // To learn more about this pagination parameter, see
+  // [Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).
+  int64 limit = 8 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Aggregation of metrics. Aggregated metric values will be shown in
+  // rows where the dimension_values are set to "RESERVED_(MetricAggregation)".
+  // Aggregates including both comparisons and multiple date ranges will
+  // be aggregated based on the date ranges.
+  repeated MetricAggregation metric_aggregations = 9
+      [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Specifies how rows are ordered in the response.
+  // Requests including both comparisons and multiple date ranges will
+  // have order bys applied on the comparisons.
+  repeated OrderBy order_bys = 10 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. A currency code in ISO4217 format, such as "AED", "USD", "JPY".
+  // If the field is empty, the report uses the property's default currency.
+  string currency_code = 11 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Cohort group associated with this request. If there is a cohort
+  // group in the request the 'cohort' dimension must be present.
+  CohortSpec cohort_spec = 12 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. If false or unspecified, each row with all metrics equal to 0
+  // will not be returned. If true, these rows will be returned if they are not
+  // separately removed by a filter.
+  //
+  // Regardless of this `keep_empty_rows` setting, only data recorded by the
+  // Google Analytics property can be displayed in a report.
+  //
+  // For example if a property never logs a `purchase` event, then a query for
+  // the `eventName` dimension and  `eventCount` metric will not have a row
+  // eventName: "purchase" and eventCount: 0.
+  bool keep_empty_rows = 13 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Toggles whether to return the current state of this Google
+  // Analytics property's quota. Quota is returned in
+  // [PropertyQuota](#PropertyQuota).
+  bool return_property_quota = 14 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. The configuration of comparisons requested and displayed. The
+  // request only requires a comparisons field in order to receive a comparison
+  // column in the response.
+  repeated Comparison comparisons = 15 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Controls conversion reporting. This field is optional. If this
+  // field is set or any conversion metrics are requested, the report will be a
+  // conversion report.
+  ConversionSpec conversion_spec = 16 [(google.api.field_behavior) = OPTIONAL];
+}
+
+// The response report table corresponding to a request.
+message RunReportResponse {
+  // Describes dimension columns. The number of DimensionHeaders and ordering of
+  // DimensionHeaders matches the dimensions present in rows.
+  repeated DimensionHeader dimension_headers = 1;
+
+  // Describes metric columns. The number of MetricHeaders and ordering of
+  // MetricHeaders matches the metrics present in rows.
+  repeated MetricHeader metric_headers = 2;
+
+  // Rows of dimension value combinations and metric values in the report.
+  repeated Row rows = 3;
+
+  // If requested, the totaled values of metrics.
+  repeated Row totals = 4;
+
+  // If requested, the maximum values of metrics.
+  repeated Row maximums = 5;
+
+  // If requested, the minimum values of metrics.
+  repeated Row minimums = 6;
+
+  // The total number of rows in the query result, regardless of the number of
+  // rows returned in the response. For example if a query returns 175 rows and
+  // includes limit = 50 in the API request, the response will contain row_count
+  // = 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).
+  int32 row_count = 7;
+
+  // Metadata for the report.
+  ResponseMetaData metadata = 8;
+
+  // This Analytics Property's quota state including this request.
+  PropertyQuota property_quota = 9;
+
+  // Identifies what kind of resource this message is. This `kind` is always the
+  // fixed string "analyticsData#runReport". Useful to distinguish between
+  // response types in JSON.
+  string kind = 10;
+
+  // 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 = 11;
+}
+
+// Request for a property's dimension and metric metadata.
+message GetMetadataRequest {
+  // Required. The resource name of the metadata to retrieve. This name field is
+  // specified in the URL path and not URL parameters. Property is a numeric
+  // Google Analytics property identifier. To learn more, see [where to find
+  // your Property
+  // ID](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id).
+  //
+  // Example: properties/1234/metadata
+  //
+  // Set the Property ID to 0 for dimensions and metrics common to all
+  // properties. In this special mode, this method will not return custom
+  // dimensions and metrics.
+  string name = 1 [
+    (google.api.field_behavior) = REQUIRED,
+    (google.api.resource_reference) = {
+      type: "analyticsdata.googleapis.com/Metadata"
+    }
+  ];
+}
+
+// The dimensions, metrics and comparisons currently accepted in reporting
+// methods.
+message Metadata {
+  option (google.api.resource) = {
+    type: "analyticsdata.googleapis.com/Metadata"
+    pattern: "properties/{property}/metadata"
+  };
+
+  // Resource name of this metadata.
+  string name = 3;
+
+  // The dimension descriptions.
+  repeated DimensionMetadata dimensions = 1;
+
+  // The metric descriptions.
+  repeated MetricMetadata metrics = 2;
+
+  // The comparison descriptions.
+  repeated ComparisonMetadata comparisons = 4;
+
+  // The conversion descriptions.
+  repeated ConversionMetadata conversions = 5;
+}