إدراجات الأنشطة التجارية
إدارة إدراجات الأنشطة التجارية المميزة والصوتية والمكررة في الأدلة عبر client.listings.
جميع توابع إدراجات الأنشطة التجارية ضمن client.listings. تقبل التوابع التي تأخذ location_id معرّفات رقمية أو معرّفات بترميز base64، راجع معرّفات المواقع.
listings.premium
اجلب إدراجات النشاط التجاري في الأدلة المميزة (Google وYelp وFacebook وغيرها) لموقع.
client.listings.premium(location_id: str | int) -> list[APIObject]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).
client.listings.voice(location_id: str | int) -> list[APIObject]voice = client.listings.voice(16808)print(f"{len(voice)} voice assistant listings")listings.duplicates
اجلب إدراجات النشاط التجاري المكررة لموقع واحد.
client.listings.duplicates(location_id: str | int) -> list[APIObject]dupes = client.listings.duplicates(16808)print(f"Found {len(dupes)} duplicate listings")listings.all_duplicates
اجلب إدراجات الأنشطة التجارية المكررة عبر جميع المواقع، مع إمكانية التصفية حسب وسم.
client.listings.all_duplicates( *, tag: str | None = None, page: int | None = None,) -> APIObjectrollup = 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
علّم عناصر إدراجات النشاط التجاري لموقع بأنها مكررة.
client.listings.mark_duplicate( location_id: str | int, listing_item_ids: list[str],) -> APIObjectresult = client.listings.mark_duplicate( location_id=16808, listing_item_ids=["item-uuid-1", "item-uuid-2"],)print(result.to_dict())listings.mark_not_duplicate
أزل حالة التكرار عن عناصر إدراجات النشاط التجاري.
client.listings.mark_not_duplicate( location_id: str | int, listing_item_ids: list[str],) -> APIObjectclient.listings.mark_not_duplicate(16808, ["item-uuid-1"])listings.connect
اربط موقعًا بإدراج نشاط تجاري من حساب متصل.
client.listings.connect( location_id: str | int, connected_account_listing_id: str, connected_account_id: str,) -> APIObjectresult = client.listings.connect( location_id=16808, connected_account_listing_id="ca-listing-uuid", connected_account_id="ca-uuid",)listings.disconnect
افصل موقعًا عن إدراج نشاطه التجاري على Google أو Facebook.
client.listings.disconnect( location_id: str | int, site: str,) -> APIObjectلا تتأثر site بحالة الأحرف؛ تحوّلها حزمة SDK إلى أحرف كبيرة قبل الإرسال.
client.listings.disconnect(16808, site="google")client.listings.disconnect(16808, site="facebook")listings.create_gmb
أنشئ إدراج نشاط تجاري على Google Business Profile لموقع موجود في Listings API.
client.listings.create_gmb( location_id: str | int, connected_account_id: str, *, folder_id: str | None = None,) -> APIObjectresult = client.listings.create_gmb( location_id=16808, connected_account_id="ca-uuid",)انظر أيضًا
- المواقع: معرّفات المواقع ودورة حياتها
- حالات الاستخدام: خطوات تدقيق إدراجات الأنشطة التجارية (حالة الاستخدام 6)