المراجعات
اعرض التقييمات، وانشر الردود وعدّلها، واجلب التحليلات عبر 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.
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# 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.
client.reviews.details(interaction_ids: list[str]) -> APIObjectdetails = client.reviews.details(["uuid-1", "uuid-2"])print(details.to_dict())reviews.respond
نشر رد على تقييم.
client.reviews.respond(interaction_id: str, content: str) -> APIObjectresult = client.reviews.respond( interaction_id="review-uuid", content="Thank you for your feedback, we really appreciate it!",)print(result.to_dict())reviews.edit_response
تعديل رد موجود.
client.reviews.edit_response( review_id: str, response_id: str, content: str,) -> APIObjectclient.reviews.edit_response( review_id="review-uuid", response_id="response-uuid", content="Updated reply text.",)reviews.archive_response
أرشفة رد (إخفاؤه).
client.reviews.archive_response(response_id: str) -> APIObjectclient.reviews.archive_response("response-uuid")reviews.settings
الحصول على إعدادات مصادر التقييمات لموقع.
client.reviews.settings(location_id: str | int) -> APIObjectsettings = client.reviews.settings(16808)print(settings.to_dict())reviews.edit_settings
تحديث عناوين URL لمصادر التقييمات لموقع. كل عنصر هو dict يصف صفحة تقييمات واحدة.
client.reviews.edit_settings( location_id: str | int, site_urls: list[dict],) -> APIObjectclient.reviews.edit_settings(16808, site_urls=[ {"url": "https://www.google.com/maps/...", "active": True},])reviews.site_config
الحصول على مواقع التقييمات المؤهلة للحساب.
client.reviews.site_config() -> list[APIObject]sites = client.reviews.site_config()for site in sites: print(site.to_dict())reviews.phrases
الحصول على العبارات الشائعة المستخرجة من التقييمات. مرّر معرّفات المواقع بتنسيق base64.
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]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
الحصول على الإحصاءات الإجمالية للتقييمات (الإجماليات، ومتوسط التقييم، ومعدل الرد).
client.reviews.analytics.overview( location_id: str | int, *, start_date: str | None = None, end_date: str | None = None,) -> APIObjectstats = client.reviews.analytics.overview( 16808, start_date="2026-01-01", end_date="2026-06-30",)print(stats.to_dict())reviews.analytics.timeline
الحصول على تحليلات التقييمات عبر الزمن.
client.reviews.analytics.timeline( location_id: str | int, *, start_date: str | None = None, end_date: str | None = None,) -> APIObjecttimeline = 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).
client.reviews.analytics.sites_stats( location_id: str | int, *, start_date: str | None = None, end_date: str | None = None,) -> APIObjectsites = client.reviews.analytics.sites_stats( 16808, start_date="2026-01-01", end_date="2026-06-30",)print(sites.to_dict())انظر أيضًا
- المواقع: استرجاع معرّفات المواقع
- التحليلات: مقاييس الملفات التعريفية على Google وBing وFacebook
- حالات الاستخدام: خطوات عملية لمراقبة التقييمات والرد التلقائي