Method: stats.getQuery
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
الحصول على إحصاءات طلبات البحث للعميل
ملاحظة: تتطلّب واجهة برمجة التطبيقات هذه حساب مستخدم نهائي عادي لتنفيذها.
طلب HTTP
GET https://cloudsearch.googleapis.com/v1/stats/query
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
fromDate |
object (Date)
يتم عرض جميع الإحصاءات المتاحة من fromDate إلى toDate. يجب أن يكون fromDate ضمن السنة وtoDate >= fromDate.
|
toDate |
object (Date)
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
stats[] |
object (CustomerQueryStats)
|
totalQueryCount |
string (int64 format)
إجمالي عدد طلبات البحث الناجحة (رمز الحالة 200) خلال النطاق الزمني المحدّد
|
نطاقات التفويض
يتطلب أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/cloud_search.stats.indexinghttps://www.googleapis.com/auth/cloud_search.statshttps://www.googleapis.com/auth/cloud_search
لمزيد من المعلومات، يمكنك الاطّلاع على دليل التفويض.
CustomerQueryStats
| الحقول |
date |
object (Date)
التاريخ الذي تم احتساب إحصاءات طلبات البحث له. يتم عرض الإحصاءات التي تم احتسابها في اليوم التالي بالقرب من منتصف الليل.
|
queryCountByStatus[] |
object (QueryCountByStatus)
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Method: stats.getQuery\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GetCustomerQueryStatsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [CustomerQueryStats](#CustomerQueryStats)\n - [JSON representation](#CustomerQueryStats.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nGet the query statistics for customer.\n\n**Note:** This API requires a standard end user account to execute.\n\n### HTTP request\n\n`GET https://cloudsearch.googleapis.com/v1/stats/query`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `fromDate` | `object (`[Date](/workspace/cloud-search/docs/reference/rest/v1/Date)`)` All available stats from fromDate to toDate are returned. fromDate should be within the year and toDate \\\u003e= fromDate. |\n| `toDate` | `object (`[Date](/workspace/cloud-search/docs/reference/rest/v1/Date)`)` |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"stats\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/stats/getQuery#CustomerQueryStats) } ], \"totalQueryCount\": string } ``` |\n\n| Fields ||\n|-------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `stats[]` | `object (`[CustomerQueryStats](/workspace/cloud-search/docs/reference/rest/v1/stats/getQuery#CustomerQueryStats)`)` |\n| `totalQueryCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Total successful query count (status code 200) for the given date range. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/cloud_search.stats.indexing`\n- `https://www.googleapis.com/auth/cloud_search.stats`\n- `https://www.googleapis.com/auth/cloud_search`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nCustomerQueryStats\n------------------\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"date\": { object (/workspace/cloud-search/docs/reference/rest/v1/Date) }, \"queryCountByStatus\": [ { object (/workspace/cloud-search/docs/reference/rest/v1/stats.query.searchapplications#QueryCountByStatus) } ] } ``` |\n\n| Fields ||\n|------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `object (`[Date](/workspace/cloud-search/docs/reference/rest/v1/Date)`)` The date for which query stats were calculated. Stats calculated on the next day close to midnight are returned. |\n| `queryCountByStatus[]` | `object (`[QueryCountByStatus](/workspace/cloud-search/docs/reference/rest/v1/stats.query.searchapplications#QueryCountByStatus)`)` |"]]
