Method: accounts.list
همه حسابهای قابل دسترسی تماسگیرنده را برمیگرداند.
توجه داشته باشید که این حسابها ممکن است در حال حاضر دارای ویژگیهای GA نباشند. حسابهای حذفشده نرم (یعنی «حذفشده») بهطور پیشفرض مستثنی هستند. اگر هیچ حساب مرتبطی پیدا نشد، یک لیست خالی برمی گرداند.
درخواست HTTP
GET https://analyticsadmin.googleapis.com/v1beta/accounts
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
پارامترها |
---|
page Size | integer حداکثر تعداد منابع برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند، حتی اگر صفحات اضافی وجود داشته باشد. اگر نامشخص باشد، حداکثر 50 منبع برگردانده می شود. حداکثر مقدار 200 است. (مقادیر بالاتر تا حداکثر اجباری خواهد بود) |
page Token | string یک نشانه صفحه، دریافت شده از تماس قبلی accounts.list . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحهبندی، تمام پارامترهای دیگر ارائهشده به accounts.list باید با فراخوانی که توکن صفحه را ارائه میکند مطابقت داشته باشد. |
show Deleted | boolean آیا شامل حسابهای حذفشده نرمافزار (یعنی «حذفشده») در نتایج میشود. حساب ها را می توان بررسی کرد تا مشخص شود که آیا حذف شده اند یا خیر. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
درخواست پیام برای accounts.list RPC.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"accounts": [
{
object (Account )
}
],
"nextPageToken": string
} |
فیلدها |
---|
accounts[] | object ( Account ) نتایجی که برای تماس گیرنده قابل دسترسی بود. |
next Page Token | string یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics.edit
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-01-14 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-01-14 بهوقت ساعت هماهنگ جهانی."],[[["Retrieves all Google Analytics 4 accounts accessible by the authenticated user, including pagination options."],["Allows filtering to include or exclude soft-deleted accounts."],["Returns an empty list if no matching accounts are found."],["Requires specific authorization scopes for data access."],["Provides details on the HTTP request, query parameters, and response structure."]]],["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"]]