إدراجات الأنشطة التجارية

إدارة إدراجات الأنشطة التجارية المميزة والصوتية والمكررة في الأدلة عبر client.listings.

جميع توابع إدراجات الأنشطة التجارية ضمن client.listings. تقبل التوابع التي تأخذ location_id معرّفات رقمية أو معرّفات بترميز base64، راجع معرّفات المواقع.


listings.premium

اجلب إدراجات النشاط التجاري في الأدلة المميزة (Google وYelp وFacebook وغيرها) لموقع.

Python
client.listings.premium(location_id: str | int) -> list[APIObject]
Python
listings = client.listings.premium(16808)for listing in listings:  site = listing.get("site", "N/A")  status = listing.get("syncStatus", "N/A")  print(f"{site}: {status}")

القيم الشائعة لـ syncStatus: SYNCED، PENDING، NOT_SYNCED، ERROR.


listings.voice

اجلب إدراجات النشاط التجاري لدى المساعدات الصوتية (Google Assistant وAlexa وSiri).

Python
client.listings.voice(location_id: str | int) -> list[APIObject]
Python
voice = client.listings.voice(16808)print(f"{len(voice)} voice assistant listings")

listings.duplicates

اجلب إدراجات النشاط التجاري المكررة لموقع واحد.

Python
client.listings.duplicates(location_id: str | int) -> list[APIObject]
Python
dupes = client.listings.duplicates(16808)print(f"Found {len(dupes)} duplicate listings")

listings.all_duplicates

اجلب إدراجات الأنشطة التجارية المكررة عبر جميع المواقع، مع إمكانية التصفية حسب وسم.

Python
client.listings.all_duplicates(    *,    tag: str | None = None,    page: int | None = None,) -> APIObject
المعاملالنوعالوصف
tagstrاحصر نطاق التجميع في وسم واحد. احذف هذا المعامل لتضمين كل موقع يمكن للمفتاح الاطلاع عليه.
pageintرقم الصفحة، بدءًا من 1.
Python
rollup = client.listings.all_duplicates(page=1)print(rollup.to_dict()) # Scope to one tagrollup = client.listings.all_duplicates(tag="northeast", page=1)

لا يلزم تمرير أي من الوسيطتين. عند حذفهما، تكون القيمتان الافتراضيتان status: POTENTIAL وtag: all، لذا يُرجع الاستدعاء دون وسيطات حالات التكرار المحتملة المفتوحة في الحساب. الحمولة هي صفحة تعتمد على الإزاحة: records[] بالإضافة إلى pageInfo مع totalRecords / totalPages.


listings.mark_duplicate

علّم عناصر إدراجات النشاط التجاري لموقع بأنها مكررة.

Python
client.listings.mark_duplicate(    location_id: str | int,    listing_item_ids: list[str],) -> APIObject
Python
result = client.listings.mark_duplicate(  location_id=16808,  listing_item_ids=["item-uuid-1", "item-uuid-2"],)print(result.to_dict())

listings.mark_not_duplicate

أزل حالة التكرار عن عناصر إدراجات النشاط التجاري.

Python
client.listings.mark_not_duplicate(    location_id: str | int,    listing_item_ids: list[str],) -> APIObject
Python
client.listings.mark_not_duplicate(16808, ["item-uuid-1"])

listings.connect

اربط موقعًا بإدراج نشاط تجاري من حساب متصل.

Python
client.listings.connect(    location_id: str | int,    connected_account_listing_id: str,    connected_account_id: str,) -> APIObject
Python
result = client.listings.connect(  location_id=16808,  connected_account_listing_id="ca-listing-uuid",  connected_account_id="ca-uuid",)

listings.disconnect

افصل موقعًا عن إدراج نشاطه التجاري على Google أو Facebook.

Python
client.listings.disconnect(    location_id: str | int,    site: str,) -> APIObject

لا تتأثر site بحالة الأحرف؛ تحوّلها حزمة SDK إلى أحرف كبيرة قبل الإرسال.

Python
client.listings.disconnect(16808, site="google")client.listings.disconnect(16808, site="facebook")

listings.create_gmb

أنشئ إدراج نشاط تجاري على Google Business Profile لموقع موجود في Listings API.

Python
client.listings.create_gmb(    location_id: str | int,    connected_account_id: str,    *,    folder_id: str | None = None,) -> APIObject
Python
result = client.listings.create_gmb(  location_id=16808,  connected_account_id="ca-uuid",)

انظر أيضًا