Listings APIListings API
تسجيل الدخول

الصور

أضف صور الموقع واعرض قائمتها وأزلها وميّزها بنجمة عبر client.photos.

جميع دوال الصور متاحة ضمن client.photos. تقبل كل دالة location_id باستثناء upload_status، وتقبل location_id معرّفات رقمية أو معرّفات مرمّزة بصيغة base64؛ راجع معرّفات المواقع.

تُرفق الصور عبر عنوان URL عام بدلًا من رفعها كبيانات نموذج متعددة الأجزاء: تستضيف الصورة، وتجلبها المنصة، وتستمر المعالجة في الخلفية. أنواع الصور هي LOGO وCOVER وADDITIONAL.

photos.list

اجلب ملفات الوسائط المرفقة بموقع، سواء كانت مميّزة بنجمة أم غير مميّزة.

Python
client.photos.list(location_id: str | int) -> list[APIObject]
Python
photos = client.photos.list(16808)for photo in photos:  print(photo.id, photo.categoryName, photo.starred)

تُرجع قائمة mediaFilesOfLocation. يحتوي كل عنصر على id وurl وthumbnailUrl وcategoryName وcategoryId وfileType وstarred وviewsCount. قيمة id هي ما تمرّره إلى remove وstar. راجع جلب صور موقع.

photos.add

أرفق صورة واحدة أو أكثر بموقع. يحتاج كل عنصر في photos إلى مفتاح photo يحتوي على عنوان URL عام للصورة، ومفتاح type.

Python
client.photos.add(    location_id: str | int,    photos: list[dict[str, Any]],) -> APIObject
المفتاحالنوعالوصف
photostrعنوان URL العام للصورة المراد جلبها.
typestrLOGO أو COVER أو ADDITIONAL.
Python
result = client.photos.add(16808, [  {"photo": "https://cdn.example.com/acme-logo.png", "type": "LOGO"},  {"photo": "https://cdn.example.com/acme-storefront.jpg", "type": "ADDITIONAL"},])for photo in result.photos:  print(photo.id, photo.type)

تُرجع الكائن addLocationPhotos الذي يحتوي على success وphotos وrequest وerrors. يحتوي كل عنصر في photos على id وdatabaseId وurl وthumbnailUrl وtype وstarred. راجع رفع صور إلى موقع.

photos.remove

أزل ارتباط الصور بموقع باستخدام معرّفات الوسائط الخاصة بها.

Python
client.photos.remove(    location_id: str | int,    photo_ids: list[str],) -> APIObject
Python
result = client.photos.remove(16808, ["TWVkaWFGaWxlOjU4Nzg5MzE="])print(result.removedCount)

تُرجع الكائن removeLocationPhotos الذي يحتوي على removedCount وerrors. راجع إزالة صور من موقع.

photos.star

ميّز الصور بنجمة أو أزل هذا التمييز لتعرض منصات النشر التي تدعم هذه الميزة الصور المميّزة أولًا. مرّر starred=False لإزالة التمييز بنجمة. يمكن تمييز 4 صور بنجمة كحد أقصى لكل حساب.

Python
client.photos.star(    location_id: str | int,    media_ids: list[str],    *,    starred: bool = True,) -> APIObject

تُسمّى المعلمة في Python ‏media_ids، وتحتوي على قيم id نفسها للوسائط التي تُرجعها photos.list. ترسلها SDK في الحقل photoIds ضمن الطلب، لذا لا تحتاج أبدًا إلى إنشاء هذا الحقل بنفسك.

Python
# Star two photosclient.photos.star(16808, ["TWVkaWFGaWxlOjU4Nzg5MzI=", "TWVkaWFGaWxlOjU4Nzg5MzM="]) # Unstar oneresult = client.photos.star(16808, ["TWVkaWFGaWxlOjU4Nzg5MzI="], starred=False)for photo in result.photos:  print(photo.id, photo.starred)

تُرجع الكائن starUnstarLocationPhotos الذي يحتوي على success وphotos وerror. راجع تمييز صور موقع بنجمة.

photos.upload_status

تحقّق من تقدّم رفع الصور دفعة واحدة. استدعِ هذه الدالة دوريًا عند إضافة صور كثيرة دفعة واحدة والحاجة إلى نتائج لكل صورة.

Python
client.photos.upload_status(request_id: str) -> APIObject
Python
status = client.photos.upload_status("e6c2d9d9-9a18-4015-88cf-9a4e19a6f49a")print(status.to_dict())

راجع التحقّق من حالة رفع الصور دفعة واحدة للاطّلاع على حقول الحالة والخطأ لكل صورة، بما في ذلك أسباب الرفض التي قد تُرجع للصورة.

انظر أيضًا

  • رفع صور موقع: دليل الصور من البداية إلى النهاية، بما في ذلك حدود الحجم
  • المواقع: إنشاء المواقع التي تُرفق الصور بها وتحديثها
  • المنشورات: إرفاق صورة واحدة بمنشور باستخدام media_url