Optional. The number of rows to return from the report. 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. The number of rows
available to a QueryReportTaskRequest is further limited by the limit of
the associated ReportTask. A query can retrieve at most ReportTask.limit
rows. For example, if the ReportTask has a limit of 1,000, then a
QueryReportTask request with offset=900 and limit=500 will return at most
100 rows.
To learn more about this pagination parameter, see
Pagination.
Optional. The row count of the start row in the report. 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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Interface QueryReportTaskRequestOrBuilder (0.83.0)\n\nVersion latestkeyboard_arrow_down\n\n- [0.83.0 (latest)](/java/docs/reference/google-analytics-data/latest/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.81.0](/java/docs/reference/google-analytics-data/0.81.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.79.0](/java/docs/reference/google-analytics-data/0.79.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.78.0](/java/docs/reference/google-analytics-data/0.78.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.75.0](/java/docs/reference/google-analytics-data/0.75.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.74.0](/java/docs/reference/google-analytics-data/0.74.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.73.0](/java/docs/reference/google-analytics-data/0.73.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.71.0](/java/docs/reference/google-analytics-data/0.71.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.70.0](/java/docs/reference/google-analytics-data/0.70.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.69.0](/java/docs/reference/google-analytics-data/0.69.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.68.0](/java/docs/reference/google-analytics-data/0.68.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.67.0](/java/docs/reference/google-analytics-data/0.67.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.66.0](/java/docs/reference/google-analytics-data/0.66.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.65.0](/java/docs/reference/google-analytics-data/0.65.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.64.0](/java/docs/reference/google-analytics-data/0.64.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.63.0](/java/docs/reference/google-analytics-data/0.63.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.62.0](/java/docs/reference/google-analytics-data/0.62.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.60.0](/java/docs/reference/google-analytics-data/0.60.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.59.0](/java/docs/reference/google-analytics-data/0.59.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.58.0](/java/docs/reference/google-analytics-data/0.58.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.57.0](/java/docs/reference/google-analytics-data/0.57.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.56.0](/java/docs/reference/google-analytics-data/0.56.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.55.0](/java/docs/reference/google-analytics-data/0.55.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.54.0](/java/docs/reference/google-analytics-data/0.54.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.53.0](/java/docs/reference/google-analytics-data/0.53.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.52.0](/java/docs/reference/google-analytics-data/0.52.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.51.0](/java/docs/reference/google-analytics-data/0.51.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.50.0](/java/docs/reference/google-analytics-data/0.50.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.48.0](/java/docs/reference/google-analytics-data/0.48.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.47.0](/java/docs/reference/google-analytics-data/0.47.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.46.0](/java/docs/reference/google-analytics-data/0.46.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.45.0](/java/docs/reference/google-analytics-data/0.45.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.44.0](/java/docs/reference/google-analytics-data/0.44.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.43.0](/java/docs/reference/google-analytics-data/0.43.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.42.0](/java/docs/reference/google-analytics-data/0.42.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.41.0](/java/docs/reference/google-analytics-data/0.41.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.40.0](/java/docs/reference/google-analytics-data/0.40.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.39.0](/java/docs/reference/google-analytics-data/0.39.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.38.0](/java/docs/reference/google-analytics-data/0.38.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.35.0](/java/docs/reference/google-analytics-data/0.35.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.34.0](/java/docs/reference/google-analytics-data/0.34.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.33.0](/java/docs/reference/google-analytics-data/0.33.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.32.0](/java/docs/reference/google-analytics-data/0.32.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.31.0](/java/docs/reference/google-analytics-data/0.31.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.30.0](/java/docs/reference/google-analytics-data/0.30.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.29.0](/java/docs/reference/google-analytics-data/0.29.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.28.0](/java/docs/reference/google-analytics-data/0.28.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.27.0](/java/docs/reference/google-analytics-data/0.27.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.26.0](/java/docs/reference/google-analytics-data/0.26.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.25.0](/java/docs/reference/google-analytics-data/0.25.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.24.0](/java/docs/reference/google-analytics-data/0.24.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.23.0](/java/docs/reference/google-analytics-data/0.23.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.22.0](/java/docs/reference/google-analytics-data/0.22.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.21.0](/java/docs/reference/google-analytics-data/0.21.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.20.0](/java/docs/reference/google-analytics-data/0.20.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.19.0](/java/docs/reference/google-analytics-data/0.19.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.18.0](/java/docs/reference/google-analytics-data/0.18.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.17.0](/java/docs/reference/google-analytics-data/0.17.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.16.0](/java/docs/reference/google-analytics-data/0.16.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder)\n- [0.15.0](/java/docs/reference/google-analytics-data/0.15.0/com.google.analytics.data.v1alpha.QueryReportTaskRequestOrBuilder) \n\n public interface QueryReportTaskRequestOrBuilder extends MessageOrBuilder\n\nImplements\n----------\n\n[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)\n\nMethods\n-------\n\n### getLimit()\n\n public abstract long getLimit()\n\nOptional. The number of rows to return from the report. If unspecified,\n10,000 rows are returned. The API returns a maximum of 250,000 rows per\nrequest, no matter how many you ask for. `limit` must be positive.\n\nThe API can also return fewer rows than the requested `limit`, if there\naren't as many dimension values as the `limit`. The number of rows\navailable to a QueryReportTaskRequest is further limited by the limit of\nthe associated ReportTask. A query can retrieve at most ReportTask.limit\nrows. For example, if the ReportTask has a limit of 1,000, then a\nQueryReportTask request with offset=900 and limit=500 will return at most\n100 rows.\n\nTo learn more about this pagination parameter, see\n[Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).\n\n`int64 limit = 3 [(.google.api.field_behavior) = OPTIONAL];`\n\n### getName()\n\n public abstract String getName()\n\nRequired. The report source name.\nFormat: `properties/{property}/reportTasks/{report}`\n\n`string name = 1 [(.google.api.field_behavior) = REQUIRED];`\n\n### getNameBytes()\n\n public abstract ByteString getNameBytes()\n\nRequired. The report source name.\nFormat: `properties/{property}/reportTasks/{report}`\n\n`string name = 1 [(.google.api.field_behavior) = REQUIRED];`\n\n### getOffset()\n\n public abstract long getOffset()\n\nOptional. The row count of the start row in the report. The first row is\ncounted as row 0.\n\nWhen paging, the first request does not specify offset; or equivalently,\nsets offset to 0; the first request returns the first `limit` of rows. The\nsecond request sets offset to the `limit` of the first request; the second\nrequest returns the second `limit` of rows.\n\nTo learn more about this pagination parameter, see\n[Pagination](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#pagination).\n\n`int64 offset = 2 [(.google.api.field_behavior) = OPTIONAL];`"]]