المراجعات

اعرض التقييمات، وانشر الردود وعدّلها، واجلب التحليلات عبر client.reviews.

توجد جميع توابع التقييمات ضمن client.reviews. وتوجد تحليلات التقييمات ضمن المورد الفرعي المتداخل client.reviews.analytics.

تُرجع توابع القراءة كائنًا من نوع APIObject (يدعم الوصول باستخدام النقطة، والوصول بأسلوب dict، و.get()، و.to_dict())، أو قائمة من كائنات APIObject، أو كائنًا من نوع SyncPage للنتائج المقسّمة إلى صفحات. تثير توابع الكتابة (respond، edit_response، archive_response، edit_settings) الاستثناء ValidationError إذا رفضت المنصة التغيير، حتى عندما تكون حالة HTTP هي 200، لذا لا تحتاج مطلقًا إلى التحقق من مؤشرات النجاح في النتيجة.


reviews.list

سرد تقييمات موقع مع مرشحات اختيارية. يُرجع كائنًا من نوع SyncPage.

Python
client.reviews.list(    location_id: str | int,    *,    first: int | None = None,    after: str | None = None,    before: str | None = None,    last: int | None = None,    site_urls: list[str] | None = None,    start_date: str | None = None,    end_date: str | None = None,    category: str | None = None,    rating_filters: list[int] | None = None,) -> SyncPage
المعلمةالنوعالوصف
location_idstr | intالموقع المراد سرد تقييماته، بمعرّف رقمي (16808) أو بمعرّف بتنسيق base64 ("TG9jYXRpb246MTY4MDg=").
first / lastintحجم الصفحة، ويُحتسب من بداية مجموعة النتائج أو نهايتها.
after / beforestrمؤشرات معتمة للتنقل بين الصفحات.
site_urlslist[str]التقييمات الواردة من عناوين URL لصفحات التقييمات هذه فقط.
start_date / end_datestrحدود النطاق الزمني بتنسيق YYYY-MM-DD.
categorystrالتصفية حسب فئة التقييم.
rating_filterslist[int]تقييمات النجوم هذه فقط، e.g. [1, 2].
Python
# Recent reviewspage = client.reviews.list(16808, first=10)for review in page:  print(review.rating, review.authorName) # 1- and 2-star only, this yearpage = client.reviews.list(  16808,  rating_filters=[1, 2],  start_date="2026-01-01",  first=50,) # Auto-paginate all reviewsfor review in client.reviews.list(16808, first=100).auto_paging_iter():  print(review.content)

reviews.details

الحصول على معلومات تفصيلية عن تقييمات محددة باستخدام معرّف التفاعل. تُؤخذ معرّفات التفاعل من الحقل interactionId في العناصر التي يُرجعها reviews.list.

Python
client.reviews.details(interaction_ids: list[str]) -> APIObject
Python
details = client.reviews.details(["uuid-1", "uuid-2"])print(details.to_dict())

reviews.respond

نشر رد على تقييم.

Python
client.reviews.respond(interaction_id: str, content: str) -> APIObject
Python
result = client.reviews.respond(  interaction_id="review-uuid",  content="Thank you for your feedback, we really appreciate it!",)print(result.to_dict())

reviews.edit_response

تعديل رد موجود.

Python
client.reviews.edit_response(    review_id: str,    response_id: str,    content: str,) -> APIObject
Python
client.reviews.edit_response(  review_id="review-uuid",  response_id="response-uuid",  content="Updated reply text.",)

reviews.archive_response

أرشفة رد (إخفاؤه).

Python
client.reviews.archive_response(response_id: str) -> APIObject
Python
client.reviews.archive_response("response-uuid")

reviews.settings

الحصول على إعدادات مصادر التقييمات لموقع.

Python
client.reviews.settings(location_id: str | int) -> APIObject
Python
settings = client.reviews.settings(16808)print(settings.to_dict())

reviews.edit_settings

تحديث عناوين URL لمصادر التقييمات لموقع. كل عنصر هو dict يصف صفحة تقييمات واحدة.

Python
client.reviews.edit_settings(    location_id: str | int,    site_urls: list[dict],) -> APIObject
Python
client.reviews.edit_settings(16808, site_urls=[  {"url": "https://www.google.com/maps/...", "active": True},])

reviews.site_config

الحصول على مواقع التقييمات المؤهلة للحساب.

Python
client.reviews.site_config() -> list[APIObject]
Python
sites = client.reviews.site_config()for site in sites:  print(site.to_dict())

reviews.phrases

الحصول على العبارات الشائعة المستخرجة من التقييمات. مرّر معرّفات المواقع بتنسيق base64.

Python
client.reviews.phrases(    location_ids: list[str],    *,    site_urls: list[str] | None = None,    start_date: str | None = None,    end_date: str | None = None,) -> list[APIObject]
Python
phrases = client.reviews.phrases(  ["TG9jYXRpb246MTY4MDg=", "TG9jYXRpb246MTQwMjQ="],  start_date="2026-01-01",  end_date="2026-06-30",)for p in phrases:  print(p.to_dict())

المورد الفرعي للتحليلات

reviews.analytics.overview

الحصول على الإحصاءات الإجمالية للتقييمات (الإجماليات، ومتوسط التقييم، ومعدل الرد).

Python
client.reviews.analytics.overview(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject
Python
stats = client.reviews.analytics.overview(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(stats.to_dict())

reviews.analytics.timeline

الحصول على تحليلات التقييمات عبر الزمن.

Python
client.reviews.analytics.timeline(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject
Python
timeline = client.reviews.analytics.timeline(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(timeline.to_dict())

reviews.analytics.sites_stats

الحصول على تحليلات التقييمات مقسّمة حسب الموقع (Google، Facebook، Yelp).

Python
client.reviews.analytics.sites_stats(    location_id: str | int,    *,    start_date: str | None = None,    end_date: str | None = None,) -> APIObject
Python
sites = client.reviews.analytics.sites_stats(  16808,  start_date="2026-01-01",  end_date="2026-06-30",)print(sites.to_dict())

انظر أيضًا