جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
Method: properties.recurringAudienceLists.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تُنشئ قائمة مستخدمين متكرّرة. تؤدي قوائم المستخدِمين المتكرّرة إلى إنشاء قوائم مستخدِمين جديدة كل يوم. قوائم المستخدِمين هي مستخدِمون متضمّنون في شريحة جمهور معيّنة في وقت إنشاء القائمة.
تضمن قائمة المستخدمين المتكرّرة أن يكون لديك قائمة مستخدمين تستند إلى أحدث البيانات المتاحة للاستخدام كل يوم. إذا أنشأت قائمة مستخدمين يدويًا، لن تعرف متى تتوفر قائمة مستخدمين تستند إلى بيانات يوم إضافي. وتعمل قائمة المستخدمين المتكرّرة هذه على إنشاء قائمة مستخدمين تلقائيًا عند توفُّر بيانات يوم إضافي. ستستهلك عددًا أقل من الرموز المميّزة للحصة من خلال استخدام قائمة مستخدمين متكرّرة مقابل إنشاء قائمة مستخدمين يدويًا في أوقات مختلفة من اليوم في محاولة لتخمين الوقت الذي تصبح فيه بيانات يوم إضافي جاهزة.
تم طرح هذه الطريقة في إصدار أوليّ مستقر بهدف جمع ملاحظات وآراء حول البنية والإمكانات قبل الدخول في إصدار تجريبي. لتقديم ملاحظاتك حول واجهة برمجة التطبيقات هذه، يُرجى إكمال نموذج ملاحظات حول Audience Export API في "إحصاءات Google".
طلب HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
| المَعلمات |
parent |
string
مطلوبة. المورد الرئيسي الذي سيتم إنشاء قائمة المستخدمين المتكرّرة هذه من خلاله. تنسيق الملف: properties/{property}
|
نص الطلب
يحتوي نص الطلب على مثال RecurringAudienceList.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل RecurringAudienceList تم إنشاؤه حديثًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCreates recurring audience lists daily, ensuring the most recent data is available for use.\u003c/p\u003e\n"],["\u003cp\u003eAutomates audience list creation, reducing manual effort and quota token consumption.\u003c/p\u003e\n"],["\u003cp\u003eIntroduced at alpha stability, seeking feedback through a provided form.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP POST request to create recurring audience lists under a specified property.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization.\u003c/p\u003e\n"]]],["This content details how to create a recurring audience list via an API. Key actions include sending a `POST` request to a specific URL (`https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists`). The request requires a `parent` path parameter indicating the property. The request body contains the `RecurringAudienceList` instance, and upon success, the response body returns a newly created `RecurringAudienceList`. This automated list generation uses less quota and ensures the use of the most recent data available. The use of certain authorization scopes are required.\n"],null,["# Method: properties.recurringAudienceLists.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 a recurring audience list. Recurring audience lists produces new audience lists each day. Audience lists are users in an audience at the time of the list's creation.\n\nA recurring audience list ensures that you have audience list based on the most recent data available for use each day. If you manually create audience list, you don't know when an audience list based on an additional day's data is available. This recurring audience list automates the creation of an audience list when an additional day's data is available. You will consume fewer quota tokens by using recurring audience list versus manually creating audience list at various times of day trying to guess when an additional day's data is ready.\n\nThis method is introduced at alpha stability with the intention of gathering feedback on syntax and capabilities before entering beta. 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/*}/recurringAudienceLists`\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 recurring audience list will be created. Format: `properties/{property}` |\n\n### Request body\n\nThe request body contains an instance of [RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [RecurringAudienceList](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.recurringAudienceLists#RecurringAudienceList).\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`"]]
