Method: properties.list
ویژگی های فرزند را در حساب اصلی مشخص شده برمی گرداند.
اگر تماس گیرنده دسترسی نداشته باشد، ویژگی ها حذف می شوند. ویژگی های حذف شده نرم (یعنی "حذف شده") به طور پیش فرض مستثنی هستند. اگر هیچ ویژگی مرتبطی پیدا نشد، یک لیست خالی برمی گرداند.
درخواست HTTP
GET https://analyticsadmin.googleapis.com/v1beta/properties
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای پرس و جو
پارامترها |
---|
filter | string مورد نیاز. عبارتی برای فیلتر کردن نتایج درخواست. فیلدهای واجد شرایط فیلتر عبارتند از: parent: (نام منبع حساب/مالکیت اصلی) یا ancestor: (نام منبع حساب اصلی) یا firebase_project: (شناسه یا شماره پروژه firebase پیوند شده). چند نمونه از فیلترها: | Filter | Description |
|-----------------------------|-------------------------------------------|
| parent:accounts/123 | The account with account id: 123. |
| parent:properties/123 | The property with property id: 123. |
| ancestor:accounts/123 | The account with account id: 123. |
| firebase_project:project-id | The firebase project with id: project-id. |
| firebase_project:123 | The firebase project with number: 123. |
|
page Size | integer حداکثر تعداد منابع برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند، حتی اگر صفحات اضافی وجود داشته باشد. اگر نامشخص باشد، حداکثر 50 منبع برگردانده می شود. حداکثر مقدار 200 است. (مقادیر بالاتر تا حداکثر اجباری خواهد بود) |
page Token | string یک نشانه صفحه، دریافت شده از تماس قبلی properties.list . این را برای بازیابی صفحه بعدی ارائه کنید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به properties.list باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد. |
show Deleted | boolean آیا شامل ویژگیهای حذف شده نرم (یعنی «حذفشده») در نتایج میشود یا خیر. می توان ویژگی ها را بررسی کرد تا مشخص شود که آیا حذف شده اند یا خیر. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پیام پاسخ برای properties.list RPC.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"properties": [
{
object (Property )
}
],
"nextPageToken": string
} |
فیلدها |
---|
properties[] | object ( Property ) نتایجی که با معیارهای فیلتر مطابقت داشت و برای تماس گیرنده قابل دسترسی بود. |
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 بهوقت ساعت هماهنگ جهانی."],[[["Returns a list of \"GA4\" properties under a specified parent Account, excluding those without user access and soft-deleted ones."],["Allows filtering results by parent, ancestor, or linked Firebase project using the `filter` query parameter."],["Supports pagination with `pageSize` and `pageToken` parameters to retrieve large result sets."],["Requires `analytics.readonly` or `analytics.edit` authorization scopes for access."],["Provides a JSON response containing an array of properties and a token for retrieving subsequent pages."]]],["This document details how to retrieve a list of child properties under a specified parent account using a `GET` request to the provided URL. Key actions involve using query parameters such as `filter`, `pageSize`, `pageToken`, and `showDeleted` to refine the search. The `filter` parameter allows specification of parent account/property, ancestor, or firebase project. The response body, in JSON format, returns a list of accessible properties and a `nextPageToken` for pagination. The process requires specific authorization scopes.\n"]]