الحصول على المخطط الزمني لتحليلات التقييمات

المعلمات

المسار

الاسم	النوع	مطلوب	الوصف
locationId	string	مطلوب	Location ID, a raw numeric database ID (e.g. `1800289`) or its Base64-encoded Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`).

الاستعلام

الاسم	النوع	مطلوب	الوصف	الافتراضي
startDate	string	اختياري	First day of the series (`YYYY-MM-DD`). Omitting it lets the service pick its default window, so pass it whenever the chart's range matters.	—
endDate	string	اختياري	Last day of the series (`YYYY-MM-DD`).	—
site	string	اختياري	Restrict the series to a single review source, by site URL (e.g. `maps.google.com`). Omit for all sources combined.	—

الاستجابات

200One entry per day in the requested range. Response key `interactionsChartData`.

Response

{  "data": {    "interactionsChartData": {      "data": [        { "date": "2026-08-01", "interactionCount": 4, "averageRating": 4.5 },        { "date": "2026-08-02", "interactionCount": 0, "averageRating": null },        { "date": "2026-08-03", "interactionCount": 7, "averageRating": 4.285714285714286 }      ]    }  }}

401Unauthenticated, missing or invalid API key.

403The key is valid but not permitted to read this location (`SY90003`).

يُرجع سلسلة التقييمات يومًا بيوم التي يستند إليها مخطط الاتجاه: عدد التقييمات الواردة في كل تاريخ، ومتوسط تقييم تلك التقييمات بالنجوم. وهو النظير الزمني لكلٍّ من الحصول على تحليلات التفاعلات (مؤشرات الأداء الرئيسية الإجمالية) والحصول على تحليلات التقييمات حسب الموقع الإلكتروني (تفصيل حسب كل مصدر).

يحتوي كل عنصر على ثلاثة حقول:

date: اليوم التقويمي، بصيغة YYYY-MM-DD.
interactionCount: التقييمات الواردة في ذلك اليوم.
averageRating: متوسط التقييم بالنجوم لتقييمات ذلك اليوم، وتكون قيمته null في يوم لا توجد فيه تقييمات. وهو المتوسط اليومي، وليس متوسطًا تراكميًا، لذا يظهر تقييم واحد بتقييم نجمة واحدة في يوم قليل النشاط بالقيمة 1.0 حتى لمتجر ذي تقييم مرتفع.

حالة استخدام: مخطط مصغر على مدى 30 يومًا

لرسم اتجاه على مدى 30 يومًا أسفل متوسط تقييم موقع بالنجوم، استدعِ هذا المسار مع startDate وendDate بحيث يغطيان الفترة، واعرض interactionCount على هيئة أعمدة وaverageRating على هيئة خط. استخدم معه مسار النظرة العامة للحصول على الأرقام الرئيسية؛ فحقول delta في النظرة العامة تتضمن بالفعل مقارنة بالفترة السابقة المماثلة، لذا لا تحتاج إلى جلب فترتين بنفسك.

مرِّر site لتقسيم السلسلة حسب المصدر، مثلًا لإظهار أن انخفاض التقييم جاء من منصة واحدة وليس من جميع المنصات. القيمة هي عنوان URL للمصدر كما يظهر في siteSettings[].name من عرض مصادر التقييمات لموقع.

الاستجابة أعلاه مثال.