Reports: get
استطلاعات عن حالة طلب تقرير
تجربة ذلك الآن
يشير الردّ إلى حالة التقرير:
- إذا كان التقرير جاهزًا للتنزيل، سيحتوي الرد على
isReportReady: true
. يحتوي الردّ أيضًا على معلومات مثل عدد ملفات التقارير.
- إذا كان التقرير لا يزال قيد العمل، يتضمّن الردّ
isReportReady: false
.
- إذا تعذّر على DoubleClick Search إكمال التقرير، ستحتوي الاستجابة على رمز الخطأ تم إغلاق 410 وأحد الأسباب الموثَّقة في
رموز الاستجابة:
الطلب
طلب HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/reports/reportId
المعلمات
اسم المعلَمة |
القيمة |
الوصف |
مَعلمات المسار |
reportId |
string |
رقم تعريف طلب التقرير الذي يجري استطلاع رأيه
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
https://www.googleapis.com/auth/doubleclicksearch |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا توفِّر نصًّا للطلب باستخدام هذه الطريقة.
الرد
في حال نجاح هذه الطريقة، سيتم عرض مورد التقارير في نص الاستجابة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2024-08-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["Polls for the status of a report request to determine if it's ready for download, still processing, or if an error occurred."],["The response includes an `isReportReady` flag indicating the report status and, if ready, provides details like the number of report files."],["Uses a GET request to the specified endpoint, including the report ID as a path parameter, to retrieve the report status."],["Requires authorization with the `https://www.googleapis.com/auth/doubleclicksearch` scope for access."],["A successful response returns a Reports resource containing information about the requested report."]]],["This outlines polling a report request's status via a GET request to `https://www.googleapis.com/doubleclicksearch/v2/reports/reportId`, requiring authorization. The `reportId` path parameter identifies the report. A successful response indicates `isReportReady: true` if ready, including file information, or `isReportReady: false` if in progress. A 410 Gone error code signifies report failure. The method returns a Reports resource and doesn't use a request body.\n"]]