جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
Method: properties.reportTasks.create
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يبدأ إنشاء مهمة تقرير. تعرِض هذه الطريقة مهمة التقرير بسرعة وتبدأ طلبًا غير متزامن لفترة طويلة من أجل إنشاء تقرير مخصّص لبيانات أحداث "إحصاءات Google".
سيتم الاحتفاظ بمهمة التقرير وسيصبح بإمكانك طلب البحث عنها لمدة 72 ساعة بعد إنشائها.
يمكن إدراج مهمة تقرير أنشأها مستخدم واحد والاستعلام عنها من قِبل جميع المستخدمين الذين لديهم إذن الوصول إلى الموقع.
طلب HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
| المَعلمات |
parent |
string
مطلوبة. المورد الرئيسي الذي سيتم إنشاء مهمة التقرير هذه من خلاله. تنسيق الملف: properties/{propertyId}
|
نص الطلب
يحتوي نص الطلب على مثال ReportTask.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Operation تم إنشاؤه حديثًا.
نطاقات التفويض
يتطلب استخدام أحد نطاقات 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\u003eInitiates a long-running asynchronous request to create a customized report of Google Analytics event data.\u003c/p\u003e\n"],["\u003cp\u003eCreated report tasks are retained and available for querying for 72 hours.\u003c/p\u003e\n"],["\u003cp\u003eReport tasks are accessible to all users with property access.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either \u003ccode\u003ehttps://www.googleapis.com/auth/analytics.readonly\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/analytics\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["This describes the process to create a report task for Google Analytics event data. A `POST` request is sent to `https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks`, where `parent` specifies the property. The request body must include a `ReportTask` instance. Upon success, it will respond with an `Operation` instance. Authorization requires either the `analytics.readonly` or `analytics` scope. Created tasks are retained for 72 hours and accessible to all property users.\n"],null,["# Method: properties.reportTasks.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\nInitiates the creation of a report task. This method quickly returns a report task and initiates a long running asynchronous request to form a customized report of your Google Analytics event data.\n\nA report task will be retained and available for querying for 72 hours after it has been created.\n\nA report task created by one user can be listed and queried by all users who have access to the property.\n\n### HTTP request\n\n`POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/reportTasks`\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 report task will be created. Format: `properties/{propertyId}` |\n\n### Request body\n\nThe request body contains an instance of [ReportTask](/analytics/devguides/reporting/data/v1/rest/v1alpha/properties.reportTasks#ReportTask).\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`"]]
