تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
BasicMetricsRequest
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب للحصول على إحصاءات المقاييس الأساسية
| الحقول |
metricRequests[] |
object (MetricRequest)
مجموعة من المقاييس لعرض قيم تتضمن خيارات لكيفية عرض البيانات.
|
timeRange |
object (TimeRange)
النطاق المطلوب جمع مقاييس له. الحد الأقصى للنطاق هو 18 شهرًا من تاريخ الطلب. في بعض الحالات، قد تبقى البيانات مفقودة لأيام قريبة من تاريخ الطلب. سيتم تحديد البيانات الناقصة في metricValues ضمن الردّ.
|
MetricRequest
طلب لعرض قيم لمقياس واحد والخيارات المتعلقة بكيفية عرض هذه القيم.
| الحقول |
metric |
enum (Metric)
المقياس المطلوب
|
options[] |
enum (MetricOption)
الطريقة التي يجب أن تظهر بها القيم عند عرضها
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eBasicMetricsRequest\u003c/code\u003e allows retrieval of basic metric insights for a specified time range, up to 18 months.\u003c/p\u003e\n"],["\u003cp\u003eThe request specifies desired metrics and data return options using \u003ccode\u003eMetricRequest\u003c/code\u003e objects.\u003c/p\u003e\n"],["\u003cp\u003eEach \u003ccode\u003eMetricRequest\u003c/code\u003e defines the specific metric and how the values should be presented in the response.\u003c/p\u003e\n"],["\u003cp\u003eData for days near the request date might be unavailable and is indicated within the \u003ccode\u003emetricValues\u003c/code\u003e field of the response.\u003c/p\u003e\n"]]],[],null,["# BasicMetricsRequest\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [MetricRequest](#MetricRequest)\n - [JSON representation](#MetricRequest.SCHEMA_REPRESENTATION)\n\nA request for basic metric insights.\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"metricRequests\": [ { object (/my-business/reference/rest/v4/BasicMetricsRequest#MetricRequest) } ], \"timeRange\": { object (/my-business/reference/rest/v4/TimeRange) } } ``` |\n\n| Fields ||\n|--------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `metricRequests[]` | `object (`[MetricRequest](/my-business/reference/rest/v4/BasicMetricsRequest#MetricRequest)`)` A collection of metrics to return values for including the options for how the data should be returned. |\n| `timeRange` | `object (`[TimeRange](/my-business/reference/rest/v4/TimeRange)`)` The range to gather metrics for. The maximum range is 18 months from the request date. In some cases, the data may still be missing for days close to the request date. Missing data will be specified in the `metricValues` in the response. |\n\nMetricRequest\n-------------\n\nA request to return values for one metric and the options for how those values should be returned.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"metric\": enum (/my-business/reference/rest/v4/Metric), \"options\": [ enum (/my-business/reference/rest/v4/MetricOption) ] } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------|\n| `metric` | `enum (`[Metric](/my-business/reference/rest/v4/Metric)`)` The requested metric. |\n| `options[]` | `enum (`[MetricOption](/my-business/reference/rest/v4/MetricOption)`)` How the values should appear when returned. |"]]
