جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
Method: properties.audiences.get
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ابحث عن شريحة جمهور واحدة. قد لا تتوفّر شرائح الجمهور التي تم إنشاؤها قبل عام 2020. لن تعرض الجماهير التلقائية تعريفات الفلاتر.
طلب HTTP
GET https://analyticsadmin.googleapis.com/v1alpha/{name=properties/*/audiences/*}
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
| المَعلمات |
name |
string
مطلوبة. اسم الجمهور الذي تريد الحصول عليه. مثال على التنسيق: properties/1234/audiences/5678
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال Audience.
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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\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`"]]
