الحصول على تحليلات التقييمات حسب الموقع الإلكتروني

المعلمات

المسار

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

الاستعلام

الاسم	النوع	مطلوب	الوصف	الافتراضي
startDate	string	اختياري	Start of the comparison period (`YYYY-MM-DD`). The `delta` fields compare this period against the previous equivalent one.	—
endDate	string	اختياري	End of the comparison period (`YYYY-MM-DD`).	—

الاستجابات

200One entry per review source configured for the location. Response key `interactionsSitesStats`.

Response

{  "data": {    "interactionsSitesStats": {      "stats": [        {          "key": "google",          "siteUrl": "maps.google.com",          "averageRating": { "value": 4.6, "delta": 2.2 },          "totalInteractions": { "value": 412, "delta": 6.1 },          "newInteractions": { "value": 24, "delta": 33.3 },          "recency": "2026-09-06T14:12:00Z",          "baseRating": 4.5,          "baseInteractions": 388,          "humanizedRecency": "3 days ago"        },        {          "key": "facebook",          "siteUrl": "facebook.com",          "averageRating": { "value": 4.1, "delta": -1.4 },          "totalInteractions": { "value": 57, "delta": 0 },          "newInteractions": { "value": 0, "delta": -100 },          "recency": null,          "baseRating": 4.16,          "baseInteractions": 57,          "humanizedRecency": null        }      ]    }  }}

401Unauthenticated, missing or invalid API key.

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

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

يصف كل عنصر في stats مصدرًا واحدًا للتقييمات:

key / siteUrl: المفتاح المختصر للمصدر وعنوان URL لموقعه الإلكتروني. يطابق siteUrl الحقل siteSettings[].name من عرض مصادر التقييمات لموقع.
averageRating، totalInteractions، newInteractions: كل منها كائن يتضمن value للفترة المطلوبة وdelta، وهو نسبة التغيير المئوية مقارنة بالفترة السابقة المكافئة.
baseRating / baseInteractions: القيم المقابلة في بداية الفترة، وهي القيم التي يُقاس انطلاقًا منها delta.
recency: الطابع الزمني لأحدث تقييم من ذلك المصدر، وتكون قيمته null إذا لم يُرجع المصدر أي تقييم من قبل.
humanizedRecency: اللحظة الزمنية نفسها بصيغة مناسبة للعرض ("منذ 3 أيام").

حالة استخدام: تحديد المنصة التي غيّرت المتوسط

عندما ينخفض التقييم الإجمالي لموقع، يوضح هذا المسار مصدر الانخفاض. اقرأ averageRating.delta لكل مصدر: تشير قيمة سلبية شاذة واحدة مع ثبات قيم المصادر الأخرى إلى منصة واحدة، بينما تشير مجموعة من القيم السلبية على نطاق واسع إلى المتجر. عادةً ما تشير قيمة newInteractions.value البالغة 0 لمصدر يعود recency الخاص به إلى أشهر مضت إلى أن الاتصال لم يعد يوفّر تحديثات، وليس إلى أن العملاء توقفوا عن كتابة التقييمات، لذا تحقّق بمقارنة ذلك مع عرض مصادر التقييمات لموقع.

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