جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
Method: accountSummaries.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تعرِض هذه السمة ملخصات لجميع الحسابات التي يمكن للمتصل الوصول إليها.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1beta/accountSummaries
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
pageSize |
integer
الحد الأقصى لعدد موارد AccountSummary المطلوب عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة، حتى إذا كانت هناك صفحات إضافية. إذا لم يتم تحديد عدد، سيتم عرض 50 موردًا كحد أقصى. الحد الأقصى للقيمة هو 200 (سيتم تحويل القيم الأعلى إلى الحد الأقصى)
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من مكالمة accountSummaries.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى accountSummaries.list مع الطلب الذي قدّم الرمز المميّز للصفحة.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة الاستجابة لاستدعاء إجراء accountSummaries.list عن بُعد
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"accountSummaries": [
{
object (AccountSummary)
}
],
"nextPageToken": string
} |
| الحقول |
accountSummaries[] |
object (AccountSummary)
ملخّصات الحسابات لجميع الحسابات التي يمكن للمتصل الوصول إليها
|
nextPageToken |
string
رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
|
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
AccountSummary
مورد افتراضي يمثّل نظرة عامة على حساب وجميع مواقعه الفرعية على "إحصاءات Google".
| تمثيل JSON |
{
"name": string,
"account": string,
"displayName": string,
"propertySummaries": [
{
object (PropertySummary)
}
]
} |
| الحقول |
name |
string
اسم المورد لملخّص الحساب هذا. التنسيق: accountSummaries/{account_id} مثال: "accountSummaries/1000"
|
account |
string
اسم مورد الحساب المُشار إليه في ملخّص الحساب هذا. التنسيق: accounts/{account_id}. مثال: "accounts/1000"
|
displayName |
string
الاسم المعروض للحساب المُشار إليه في ملخّص الحساب هذا.
|
propertySummaries[] |
object (PropertySummary)
قائمة بالملخّصات لحسابات الأطفال التابعة لهذا الحساب
|
PropertySummary
مورد افتراضي يمثّل البيانات الوصفية لموقع على "إحصاءات Google".
| تمثيل JSON |
{
"property": string,
"displayName": string,
"propertyType": enum (PropertyType),
"parent": string
} |
| الحقول |
property |
string
اسم المورد للموقع المُشار إليه في ملخّص الموقع هذا. التنسيق: properties/{property_id}. مثال: "properties/1000"
|
displayName |
string
الاسم المعروض للموقع المُشار إليه في ملخّص الموقع هذا.
|
propertyType |
enum (PropertyType)
نوع الموقع.
|
parent |
string
اسم المورد للعنصر الرئيسي المنطقي لهذا الموقع ملاحظة: يمكن استخدام واجهة مستخدم نقل المواقع لتغيير العنصر الرئيسي. التنسيق: accounts/{account}، properties/{property}. مثال: "accounts/100"، "properties/200"
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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\" |"]]
