سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
OrderBy
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ترتیب بر اساس تعیین می کند که ردیف ها چگونه در پاسخ مرتب می شوند. به عنوان مثال، ترتیب ردیف‌ها بر اساس تعداد رویداد نزولی یک مرتبه است و ترتیب ردیف‌ها بر اساس رشته نام رویداد یک ترتیب متفاوت است.
| نمایندگی JSON |
|---|
{
"desc": boolean,
// Union field one_order_by can be only one of the following:
"metric": {
object (MetricOrderBy)
},
"dimension": {
object (DimensionOrderBy)
},
"pivot": {
object (PivotOrderBy)
}
// End of list of possible types for union field one_order_by.
} |
| فیلدها |
|---|
desc | boolean اگر درست است، به ترتیب نزولی مرتب می شود. |
فیلد اتحادیه one_order_by . یک نوع سفارش توسط برای OrderBy مشخص کنید. one_order_by می تواند تنها یکی از موارد زیر باشد: |
metric | object ( MetricOrderBy ) نتایج را بر اساس مقادیر یک متریک مرتب می کند. |
dimension | object ( DimensionOrderBy ) نتایج را بر اساس مقادیر یک بعد مرتب می کند. |
pivot | object ( PivotOrderBy ) نتایج را بر اساس مقادیر یک متریک در یک گروه ستون محوری مرتب می کند. |
MetricOrderBy
بر اساس مقادیر متریک مرتب می شود.
| نمایندگی JSON |
|---|
{
"metricName": string
} |
| فیلدها |
|---|
metric Name | string یک نام متریک در درخواست سفارش توسط. |
DimensionOrderBy
بر اساس مقادیر ابعاد مرتب می شود.
| نمایندگی JSON |
|---|
{
"dimensionName": string,
"orderType": enum (OrderType)
} |
| فیلدها |
|---|
dimension Name | string نام ابعاد در درخواست سفارش توسط. |
order Type | enum ( OrderType ) قانون ترتیب ارزش ابعاد را کنترل می کند. |
نوع سفارش
قانون ترتیب دادن مقادیر ابعاد رشته بر اساس.
| Enums |
|---|
ORDER_TYPE_UNSPECIFIED | نامشخص |
ALPHANUMERIC | مرتب سازی الفبایی بر اساس نقطه کد یونیکد. به عنوان مثال، "2" < "A" < "X" < "b" < "z". |
CASE_INSENSITIVE_ALPHANUMERIC | مرتب سازی حروف عددی بدون حروف بزرگ و کوچک بر اساس نقطه کد یونیکد. به عنوان مثال، "2" < "A" < "b" < "X" < "z". |
NUMERIC | مقادیر ابعاد قبل از مرتب سازی به اعداد تبدیل می شوند. به عنوان مثال در مرتب سازی NUMERIC، "25" < "100"، و در مرتب سازی ALPHANUMERIC ، "100" < "25". مقادیر ابعاد غیر عددی همگی دارای ارزش ترتیب برابری زیر همه مقادیر عددی هستند. |
PivotOrderBy
بر اساس گروه ستون محوری مرتب می شود.
| نمایندگی JSON |
|---|
{
"metricName": string,
"pivotSelections": [
{
object (PivotSelection)
}
]
} |
| فیلدها |
|---|
metric Name | string در پاسخ به ترتیب بر اساس، ردیف ها را بر اساس این ستون مرتب کنید. باید یک نام متریک از درخواست باشد. |
pivot Selections[] | object ( PivotSelection ) برای انتخاب نام بعد و محور مقدار استفاده می شود. اگر چندین انتخاب محوری داده شود، مرتب‌سازی در ردیف‌هایی اتفاق می‌افتد که در آن همه جفت‌های نام و مقدار بعد انتخاب محوری با نام بعد و جفت مقدار سطر مطابقت دارند. |
PivotSelection
یک جفت نام ابعاد و مقادیر. سطرهایی با این جفت محوری بعد بر اساس مقدار متریک مرتب می شوند.
برای مثال، اگر pivots = ('browser', 'Chrome') و metricName = "Sessions" باشد، سطرها بر اساس Sessions در Chrome مرتب خواهند شد.
---------|----------|----------------|----------|----------------
| Chrome | Chrome | Safari | Safari
---------|----------|----------------|----------|----------------
Country | Sessions | Pages/Sessions | Sessions | Pages/Sessions
---------|----------|----------------|----------|----------------
US | 2 | 2 | 3 | 1
---------|----------|----------------|----------|----------------
Canada | 3 | 1 | 4 | 1
---------|----------|----------------|----------|----------------
| نمایندگی JSON |
|---|
{
"dimensionName": string,
"dimensionValue": string
} |
| فیلدها |
|---|
dimension Name | string باید یک نام بعد از درخواست باشد. |
dimension Value | string فقط زمانی ترتیب دهید که بعد نامگذاری شده این مقدار باشد. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eOrderBys determine the sorting of rows in a response, based on metrics, dimensions, or pivots.\u003c/p\u003e\n"],["\u003cp\u003eYou can order by metrics (e.g., event count), dimensions (e.g., event name), or pivot column groups.\u003c/p\u003e\n"],["\u003cp\u003eSorting can be done in ascending or descending order, specified by the \u003ccode\u003edesc\u003c/code\u003e boolean field.\u003c/p\u003e\n"],["\u003cp\u003eDimension sorting offers alphanumeric, case-insensitive alphanumeric, and numeric order types.\u003c/p\u003e\n"],["\u003cp\u003ePivotOrderBy allows sorting within specific pivot column groups based on metric values.\u003c/p\u003e\n"]]],["This content details various methods for sorting data rows in a response, known as \"OrderBys.\" Sorting can be based on metrics (`MetricOrderBy`) or dimensions (`DimensionOrderBy`). Dimensions can be ordered alphanumerically, case-insensitively, or numerically (`OrderType`). `PivotOrderBy` allows sorting by metric values within pivot column groups, using `PivotSelection` to specify dimension-value pairs for focused sorting. `OrderBys` can also be applied in descending order, indicated by the `desc` field.\n"],null,["# OrderBy\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [MetricOrderBy](#MetricOrderBy)\n - [JSON representation](#MetricOrderBy.SCHEMA_REPRESENTATION)\n- [DimensionOrderBy](#DimensionOrderBy)\n - [JSON representation](#DimensionOrderBy.SCHEMA_REPRESENTATION)\n- [OrderType](#OrderType)\n- [PivotOrderBy](#PivotOrderBy)\n - [JSON representation](#PivotOrderBy.SCHEMA_REPRESENTATION)\n- [PivotSelection](#PivotSelection)\n - [JSON representation](#PivotSelection.SCHEMA_REPRESENTATION)\n\nOrder bys define how rows will be sorted in the response. For example, ordering rows by descending event count is one ordering, and ordering rows by the event name string is a different ordering.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"desc\": boolean, // Union field `one_order_by` can be only one of the following: \"metric\": { object (/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#MetricOrderBy) }, \"dimension\": { object (/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#DimensionOrderBy) }, \"pivot\": { object (/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#PivotOrderBy) } // End of list of possible types for union field `one_order_by`. } ``` |\n\n| Fields ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `desc` | `boolean` If true, sorts by descending order. |\n| Union field `one_order_by`. Specify one type of order by for `OrderBy`. `one_order_by` can be only one of the following: ||\n| `metric` | `object (`[MetricOrderBy](/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#MetricOrderBy)`)` Sorts results by a metric's values. |\n| `dimension` | `object (`[DimensionOrderBy](/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#DimensionOrderBy)`)` Sorts results by a dimension's values. |\n| `pivot` | `object (`[PivotOrderBy](/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#PivotOrderBy)`)` Sorts results by a metric's values within a pivot column group. |\n\nMetricOrderBy\n-------------\n\nSorts by metric values.\n\n| JSON representation |\n|----------------------------------|\n| ``` { \"metricName\": string } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------|\n| `metric``Name` | `string` A metric name in the request to order by. |\n\nDimensionOrderBy\n----------------\n\nSorts by dimension values.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"dimensionName\": string, \"orderType\": enum (/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#OrderType) } ``` |\n\n| Fields ||\n|-------------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `dimension``Name` | `string` A dimension name in the request to order by. |\n| `order``Type` | `enum (`[OrderType](/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#OrderType)`)` Controls the rule for dimension value ordering. |\n\nOrderType\n---------\n\nRule to order the string dimension values by.\n\n| Enums ||\n|---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `ORDER_TYPE_UNSPECIFIED` | Unspecified. |\n| `ALPHANUMERIC` | Alphanumeric sort by Unicode code point. For example, \"2\" \\\u003c \"A\" \\\u003c \"X\" \\\u003c \"b\" \\\u003c \"z\". |\n| `CASE_INSENSITIVE_ALPHANUMERIC` | Case insensitive alphanumeric sort by lower case Unicode code point. For example, \"2\" \\\u003c \"A\" \\\u003c \"b\" \\\u003c \"X\" \\\u003c \"z\". |\n| `NUMERIC` | Dimension values are converted to numbers before sorting. For example in NUMERIC sort, \"25\" \\\u003c \"100\", and in `ALPHANUMERIC` sort, \"100\" \\\u003c \"25\". Non-numeric dimension values all have equal ordering value below all numeric values. |\n\nPivotOrderBy\n------------\n\nSorts by a pivot column group.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"metricName\": string, \"pivotSelections\": [ { object (/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#PivotSelection) } ] } ``` |\n\n| Fields ||\n|-----------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `metric``Name` | `string` In the response to order by, order rows by this column. Must be a metric name from the request. |\n| `pivot``Selections[]` | `object (`[PivotSelection](/analytics/devguides/reporting/data/v1/rest/v1beta/OrderBy#PivotSelection)`)` Used to select a dimension name and value pivot. If multiple pivot selections are given, the sort occurs on rows where all pivot selection dimension name and value pairs match the row's dimension name and value pair. |\n\nPivotSelection\n--------------\n\nA pair of dimension names and values. Rows with this dimension pivot pair are ordered by the metric's value.\n\nFor example if pivots = ('browser', 'Chrome') and metricName = \"Sessions\", then the rows will be sorted based on Sessions in Chrome. \n\n ---------|----------|----------------|----------|----------------\n | Chrome | Chrome | Safari | Safari\n ---------|----------|----------------|----------|----------------\n Country | Sessions | Pages/Sessions | Sessions | Pages/Sessions\n ---------|----------|----------------|----------|----------------\n US | 2 | 2 | 3 | 1\n ---------|----------|----------------|----------|----------------\n Canada | 3 | 1 | 4 | 1\n ---------|----------|----------------|----------|----------------\n\n| JSON representation |\n|---------------------------------------------------------------|\n| ``` { \"dimensionName\": string, \"dimensionValue\": string } ``` |\n\n| Fields ||\n|--------------------|----------------------------------------------------------------|\n| `dimension``Name` | `string` Must be a dimension name from the request. |\n| `dimension``Value` | `string` Order by only when the named dimension is this value. |"]]
