جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
Method: accounts.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عرض جميع الحسابات التي يمكن للمتصل الوصول إليها
يُرجى العِلم أنّ هذه الحسابات قد لا تتضمّن حاليًا مواقع على "إحصاءات Google". يتم استبعاد الحسابات التي تم حذفها مؤقتًا (أي "المُرسَلة إلى المهملات") تلقائيًا. تعرِض قائمة فارغة إذا لم يتم العثور على أي حسابات ذات صلة.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1beta/accounts
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
pageSize |
integer
الحد الأقصى لعدد الموارد التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة، حتى إذا كانت هناك صفحات إضافية. إذا لم يتم تحديد عدد، سيتم عرض 50 موردًا كحد أقصى. الحد الأقصى للقيمة هو 200 (سيتم تحويل القيم الأعلى إلى الحد الأقصى)
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من مكالمة accounts.list سابقة قدِّم هذا المرجع لاسترداد الصفحة اللاحقة. عند تقسيم الصفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى accounts.list مع الطلب الذي قدّم الرمز المميّز للصفحة.
|
showDeleted |
boolean
ما إذا كنت تريد تضمين الحسابات المحذوفة مؤقتًا (أي "المُرسَلة إلى المهملات") في النتائج يمكن فحص الحسابات لتحديد ما إذا تم حذفها أم لا.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
رسالة طلب لاستدعاء إجراء عن بُعد لـ accounts.list
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"accounts": [
{
object (Account)
}
],
"nextPageToken": string
} |
| الحقول |
accounts[] |
object (Account)
النتائج التي كان بإمكان المتصل الوصول إليها
|
nextPageToken |
string
رمز مميّز يمكن إرساله على شكل pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.
|
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics.edit
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves all Google Analytics 4 accounts accessible by the authenticated user, including pagination options.\u003c/p\u003e\n"],["\u003cp\u003eAllows filtering to include or exclude soft-deleted accounts.\u003c/p\u003e\n"],["\u003cp\u003eReturns an empty list if no matching accounts are found.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for data access.\u003c/p\u003e\n"],["\u003cp\u003eProvides details on the HTTP request, query parameters, and response structure.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of accessible accounts using the Analytics Admin API. The core action is sending a `GET` request to the specified URL. Optional query parameters, `pageSize` and `pageToken`, enable pagination. The `showDeleted` parameter allows inclusion of soft-deleted accounts. The request body must be empty. A successful response returns a JSON object containing an array of `accounts` and a `nextPageToken` for subsequent pages. Authorization requires specific OAuth scopes.\n"],null,["# Method: accounts.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.ListAccountsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns all accounts accessible by the caller.\n\nNote that these accounts might not currently have GA properties. Soft-deleted (ie: \"trashed\") accounts are excluded by default. Returns an empty list if no relevant accounts are found.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1beta/accounts`\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 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 `accounts.list` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `accounts.list` must match the call that provided the page token. |\n| `showDeleted` | `boolean` Whether to include soft-deleted (ie: \"trashed\") Accounts in the results. Accounts can be inspected to determine whether they are deleted or not. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nRequest message for accounts.list RPC.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"accounts\": [ { object (/analytics/devguides/config/admin/v1/rest/v1beta/accounts#Account) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------|\n| `accounts[]` | `object (`[Account](/analytics/devguides/config/admin/v1/rest/v1beta/accounts#Account)`)` Results that were accessible to the caller. |\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`"]]
