سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
Method: properties.audiences.get
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
جستجو برای یک مخاطب مخاطبانی که قبل از سال 2020 ایجاد شده اند ممکن است پشتیبانی نشوند. مخاطبان پیش‌فرض تعاریف فیلتر را نشان نمی‌دهند.
درخواست HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{name=properties/*/audiences/*}
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| مولفه های |
|---|
name | string ضروری. نام مخاطب برای دریافت. فرمت مثال: properties/1234/audiences/5678 |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه ای از Audience است.
محدوده مجوز
به یکی از حوزه های 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-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eRetrieve a specific Audience resource using its unique name, formatted as properties/{propertyId}/audiences/{audienceId}.\u003c/p\u003e\n"],["\u003cp\u003eRequest requires authorization using either \u003ccode\u003eanalytics.readonly\u003c/code\u003e or \u003ccode\u003eanalytics.edit\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eOnly audiences created after 2020 and non-default audiences can be successfully retrieved.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes the Audience object if found, otherwise an error.\u003c/p\u003e\n"]]],["This document outlines how to retrieve a single Audience using a `GET` HTTP request to the Google Analytics Admin API. The request URL requires a path parameter, `name`, specifying the Audience's identifier (e.g., `properties/1234/audiences/5678`). The request body must be empty. Successful responses return an Audience instance. Authorization requires either the `analytics.readonly` or `analytics.edit` OAuth scope. The example uses the gRPC Transcoding syntax. Audiences created before 2020 might not be supported.\n"],null,["# Method: properties.audiences.get\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\nLookup for a single Audience. Audiences created before 2020 may not be supported. Default audiences will not show filter definitions.\n\n### HTTP request\n\n`GET https://analyticsadmin.googleapis.com/v1alpha/{name=properties/*/audiences/*}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. The name of the Audience to get. Example format: properties/1234/audiences/5678 |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [Audience](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.audiences#Audience).\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`"]]
