سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
Method: properties.audienceLists.create
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
فهرست مخاطبان را برای بازیابی بعدی ایجاد می کند. این روش به سرعت نام منبع فهرست مخاطبان را برمی گرداند و یک درخواست ناهمزمان طولانی را برای تشکیل لیست مخاطبان آغاز می کند. برای قرار دادن کاربران در فهرست مخاطبان، ابتدا فهرست مخاطبان را از این روش ایجاد کنید و سپس نام منبع مخاطب را به روش audienceLists.query ارسال کنید.
برای آشنایی با فهرست مخاطبان همراه با مثال، به ایجاد فهرست مخاطبان مراجعه کنید.
فهرست مخاطبان تصویری از کاربرانی است که در حال حاضر در زمان ایجاد فهرست مخاطبان در بین مخاطبان حضور دارند. ایجاد فهرست مخاطبان برای یک مخاطب در روزهای مختلف نتایج متفاوتی را با ورود و خروج کاربران به مخاطبان به همراه خواهد داشت.
مخاطبان در Google Analytics 4 به شما این امکان را می دهند که کاربران خود را به روش هایی که برای کسب و کار شما مهم هستند تقسیم بندی کنید. برای کسب اطلاعات بیشتر، به https://support.google.com/analytics/answer/9267572 مراجعه کنید. فهرست مخاطبان شامل کاربران هر مخاطب است.
این روش در ثبات بتا در audienceExports.create موجود است. برای ارائه بازخورد خود در مورد این API، فرم بازخورد Google Analytics Audience Export API را تکمیل کنید.
درخواست HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
parent | string ضروری. منبع اصلی که در آن این لیست مخاطب ایجاد می شود. فرمت: properties/{property} |
درخواست بدن
بدنه درخواست شامل یک نمونه از AudienceList است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Operation است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.readonly -
https://www.googleapis.com/auth/analytics
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eCreates an audience list containing a snapshot of users in an audience at the time of creation, allowing for later retrieval and querying.\u003c/p\u003e\n"],["\u003cp\u003eThe method utilizes an asynchronous request, returning the audience list resource name immediately while the list formation process occurs in the background.\u003c/p\u003e\n"],["\u003cp\u003eAudience lists are dynamic and reflect the current state of an audience; creating lists on different days for the same audience may yield varied results due to user fluctuations.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003eaudienceExports.create\u003c/code\u003e method at beta stability, requiring specific authorization scopes for access.\u003c/p\u003e\n"]]],["This API method facilitates the creation of audience lists in Google Analytics 4. It initiates an asynchronous process to generate a list of users matching a defined audience. Key actions include sending a POST request to `audienceLists` with a defined `parent` path parameter, representing the property. The request body defines the audience list, and the successful response includes the audience list's resource name and an Operation instance. Authorization requires specific OAuth scopes. The newly created list can then be used for user segmentation.\n"],null,["# Method: properties.audienceLists.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an audience list for later retrieval. This method quickly returns the audience list's resource name and initiates a long running asynchronous request to form an audience list. To list the users in an audience list, first create the audience list through this method and then send the audience resource name to the `audienceLists.query` method.\n\nSee [Creating an Audience List](https://developers.google.com/analytics/devguides/reporting/data/v1/audience-list-basics) for an introduction to Audience Lists with examples.\n\nAn audience list is a snapshot of the users currently in the audience at the time of audience list creation. Creating audience lists for one audience on different days will return different results as users enter and exit the audience.\n\nAudiences in Google Analytics 4 allow you to segment your users in the ways that are important to your business. To learn more, see \u003chttps://support.google.com/analytics/answer/9267572\u003e. Audience lists contain the users in each audience.\n\nThis method is available at beta stability at [audienceExports.create](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/properties.audienceExports/create). To give your feedback on this API, complete the [Google Analytics Audience Export API Feedback](https://forms.gle/EeA5u5LW6PEggtCEA) form.\n\n### HTTP request\n\n`POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource where this audience list will be created. Format: `properties/{property}` |\n\n### Request body\n\nThe request body contains an instance of [AudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.audienceLists#AudienceList).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/analytics/devguides/reporting/data/v1/rest/Shared.Types/Operation).\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`"]]
