سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
Method: accountSummaries.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
خلاصه‌ای از تمام حساب‌های قابل دسترسی تماس‌گیرنده را برمی‌گرداند.
درخواست HTTP
GET https://analyticsadmin.googleapis.com/v1beta/accountSummaries
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer حداکثر تعداد منابع AccountSummary برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند، حتی اگر صفحات اضافی وجود داشته باشد. اگر نامشخص باشد، حداکثر 50 منبع برگردانده می شود. حداکثر مقدار 200 است. (مقادیر بالاتر تا حداکثر اجباری خواهد بود) |
pageToken | string یک نشانه صفحه، دریافت شده از تماس قبلی accountSummaries.list . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به accountSummaries.list باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای accountSummaries.list RPC.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"accountSummaries": [
{
object (AccountSummary)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
accountSummaries[] | object ( AccountSummary ) خلاصه حساب تمام حساب هایی که تماس گیرنده به آنها دسترسی دارد. |
nextPageToken | string یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.readonly -
https://www.googleapis.com/auth/analytics.edit
خلاصه حساب
یک منبع مجازی که نمایانگر یک نمای کلی از یک حساب و تمام ویژگی های Google Analytics فرزند آن است.
| نمایندگی JSON |
|---|
{
"name": string,
"account": string,
"displayName": string,
"propertySummaries": [
{
object (PropertySummary)
}
]
} |
| فیلدها |
|---|
name | string نام منبع برای خلاصه این حساب. قالب: accountSummaries/{account_id} مثال: "accountSummaries/1000" |
account | string نام منبع حساب که توسط این خلاصه حساب به آن اشاره شده است قالب: حساب‌ها/{account_id} مثال: "accounts/1000" |
displayName | string نام نمایشی برای حساب مورد اشاره در این خلاصه حساب. |
propertySummaries[] | object ( PropertySummary ) فهرست خلاصه‌های حساب‌های فرزند این حساب. |
PropertySummary
یک منبع مجازی که ابرداده را برای یک ویژگی Google Analytics نشان می دهد.
| نمایندگی JSON |
|---|
{
"property": string,
"displayName": string,
"propertyType": enum (PropertyType),
"parent": string
} |
| فیلدها |
|---|
property | string نام منبع دارایی که توسط این خلاصه ویژگی ارجاع داده شده است فرمت: properties/{property_id} مثال: "properties/1000" |
displayName | string نام نمایشی برای ملکی که در خلاصه این ملک به آن اشاره شده است. |
propertyType | enum ( PropertyType ) نوع ملک. |
parent | string نام منبع والد منطقی این ویژگی. توجه: از رابط کاربری Property-Moving می توان برای تغییر والد استفاده کرد. قالب: حساب‌ها/{حساب}، خواص/{ملاک} مثال: "accounts/100"، "properties/200" |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThis endpoint returns summaries of all Google Analytics 4 accounts and their properties accessible by the caller.\u003c/p\u003e\n"],["\u003cp\u003eSummaries provide an overview of account details such as name, display name, and associated properties including their types and parent information.\u003c/p\u003e\n"],["\u003cp\u003eThe response can be paginated using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters for retrieving large sets of account data.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires either \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eUse the \u003ccode\u003eTry it!\u003c/code\u003e section to experiment with the API directly.\u003c/p\u003e\n"]]],["This document details how to retrieve summaries of Google Analytics accounts. It uses a `GET` HTTP request to `https://analyticsadmin.googleapis.com/v1beta/accountSummaries`. Optional query parameters include `pageSize` (up to 200) and `pageToken` for pagination. The request body is empty. The response contains `accountSummaries` (an array with each element being `AccountSummary`), and `nextPageToken`. Each `AccountSummary` contains account details and an array of `PropertySummary`, which includes a property's metadata. The request requires either `analytics.readonly` or `analytics.edit` OAuth scopes.\n"],null,["# Method: accountSummaries.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAccountSummariesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AccountSummary](#AccountSummary)\n - [JSON representation](#AccountSummary.SCHEMA_REPRESENTATION)\n- [PropertySummary](#PropertySummary)\n - [JSON representation](#PropertySummary.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReturns summaries of all accounts accessible by the caller.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1beta/accountSummaries`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of AccountSummary resources to return. The service may return fewer than this value, even if there are additional pages. If unspecified, at most 50 resources will be returned. The maximum value is 200; (higher values will be coerced to the maximum) |\n| `pageToken` | `string` A page token, received from a previous `accountSummaries.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `accountSummaries.list` must match the call that provided the page token. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse message for accountSummaries.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accountSummaries\": [ { object (/analytics/devguides/config/admin/v1/rest/v1beta/accountSummaries/list#AccountSummary) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountSummaries[]` | `object (`[AccountSummary](/analytics/devguides/config/admin/v1/rest/v1beta/accountSummaries/list#AccountSummary)`)` Account summaries of all accounts the caller has access to. |\n| `nextPageToken` | `string` A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/analytics.readonly`\n- `https://www.googleapis.com/auth/analytics.edit`\n\nAccountSummary\n--------------\n\nA virtual resource representing an overview of an account and all its child Google Analytics properties.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"account\": string, \"displayName\": string, \"propertySummaries\": [ { object (/analytics/devguides/config/admin/v1/rest/v1beta/accountSummaries/list#PropertySummary) } ] } ``` |\n\n| Fields ||\n|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name for this account summary. Format: accountSummaries/{account_id} Example: \"accountSummaries/1000\" |\n| `account` | `string` Resource name of account referred to by this account summary Format: accounts/{account_id} Example: \"accounts/1000\" |\n| `displayName` | `string` Display name for the account referred to in this account summary. |\n| `propertySummaries[]` | `object (`[PropertySummary](/analytics/devguides/config/admin/v1/rest/v1beta/accountSummaries/list#PropertySummary)`)` List of summaries for child accounts of this account. |\n\nPropertySummary\n---------------\n\nA virtual resource representing metadata for a Google Analytics property.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"property\": string, \"displayName\": string, \"propertyType\": enum (/analytics/devguides/config/admin/v1/rest/v1beta/properties#PropertyType), \"parent\": string } ``` |\n\n| Fields ||\n|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `property` | `string` Resource name of property referred to by this property summary Format: properties/{property_id} Example: \"properties/1000\" |\n| `displayName` | `string` Display name for the property referred to in this property summary. |\n| `propertyType` | `enum (`[PropertyType](/analytics/devguides/config/admin/v1/rest/v1beta/properties#PropertyType)`)` The property's property type. |\n| `parent` | `string` Resource name of this property's logical parent. Note: The Property-Moving UI can be used to change the parent. Format: accounts/{account}, properties/{property} Example: \"accounts/100\", \"properties/200\" |"]]
