نظرة عامة على Listings API
تعرّف على كيفية تفعيل حسابك في ListingsAPI وإدارته. ترشدك الأدلة خطوة بخطوة لبدء التكامل، بينما تغطي شروحات نقاط النهاية كل نقطة نهاية في المورد. هل أنت جديد هنا؟ ابدأ من أول استدعاء لك لواجهة API.
ابدأ هنا
المواقع
البحث عن البلدان والولايات والفئات
اجلب البلدان المدعومة ورموز الولايات، وحدّد المعرّف الرقمي لفئة نشاط تجاري، وتعرّف على منصات النشر التي تشملها خطتك قبل إنشاء موقع.
اقرأ الدليلإضافة موقع
أنشئ موقعًا بالحقول التي تحتاج إليها منصات النشر، وتعامل مع أخطاء التحقق، وتأكد من إدراجه في قائمة انتظار الإرسال.
اقرأ الدليلتحديث تفاصيل موقع وساعات عمله
عدّل بيانات الاتصال، وانشر جدولًا أسبوعيًا كاملًا باستثناءات لمرة واحدة، وحدّد إغلاقًا مؤقتًا، واضبط فئات Google، واسترجع التغييرات.
اقرأ الدليلتحميل شعار وصورة غلاف وصور
أرفق شعارًا وصورة غلاف وصورًا للمعرض بموقع عبر عناوين URL، واعرض المرفقات، وميّز الصورة الرئيسية بنجمة، وأزل ما لم يعد مناسبًا.
اقرأ الدليلاعثر على المواقع وأرشف ما لم تعد تديره منها
ابحث بكلمة مفتاحية، واسترجع المواقع باستخدام رموز المتاجر ومعرّفاتها دفعة واحدة، وجدول أرشفة الفروع المغلقة في نهاية دورة الفوترة، وألغِ أرشفة مجدولة.
اقرأ الدليلربط المنصات
ربط Google Business Profile واستيراد مواقعك
أنشئ رابط ربط Google، وطابق إدراجات أنشطة المالك التجارية على Google مع مواقعك، وأكّد المطابقات، واستورد إدراجات الأنشطة التجارية التي لا موقع لها بعد.
اقرأ الدليلربط صفحات Facebook
أنشئ رابطًا لربط Facebook، وطابق صفحات المالك مع مواقعك، وأكّد الروابط أو اخترها يدويًا، وافصل الحساب عند مغادرة العميل.
اقرأ الدليلربط Apple Business Connect
انشر موقعًا على Apple Maps بحساب Apple Business الموثّق للمالك أو حساب ListingsAPI إن لم يملكه، وتحقق من الإدراج وافصل الربط عند مغادرة العميل.
اقرأ الدليلإنشاء Google Business Profile لموقع ليس لديه ملف
أرسل طلب إنشاء Google Business Profile جديد لموقع بحساب Google متصل، وتابع التحقق عبر الموقع وإدراجاته وأحداث webhooks.
اقرأ الدليلإدراجات الأنشطة التجارية
تحقّق من حالة إدراج النشاط التجاري واحصل على روابطه المنشورة
تابع مزامنة كل منصة نشر لموقع، واجمع روابط إدراجات الأنشطة التجارية المنشورة، ولخّص التغطية، وافحص المساعدات الصوتية، وتلقّ إشعارات webhook بدل الاستقصاء.
اقرأ الدليلالعثور على أخطاء إدراجات الأنشطة التجارية وإصلاحها
صفِّ إدراجات الأنشطة التجارية لموقع حسب ما يحتاج إلى اهتمام، واقرأ سبب منصة النشر، وطبّق الإصلاح المناسب، وأعد الاستعلام بأمان وافحص الحساب كله.
اقرأ الدليلالعثور على إدراجات الأنشطة التجارية المكررة وإخفاؤها
اعرض إدراجات الأنشطة التجارية المكررة المكتشفة لموقع وعبر الحساب، وأكّد المكرر الفعلي لإخفائه، واستبعد التصنيفات الخاطئة، وتتبّع كل حالة حتى حلها.
اقرأ الدليلالمراجعات
اجلب التقييمات لموقع واحد أو لحسابك بالكامل
اعرض أحدث تقييمات موقع، وصفِّ التقييمات المنخفضة بلا رد، وتنقّل بين الصفحات بالمؤشرات، واجلب تقييمات جميع مواقع الحساب، وتلقَّ إشعارات عبر webhook.
اقرأ الدليلالرد على التقييمات، ثم تعديل رد أو أرشفته
ابحث عن التقييمات التي تقبل ردًا من المالك، وانشر ردًا، وتأكد من وصوله إلى منصة النشر، ثم صحّح صياغته أو أرشفه.
اقرأ الدليلقياس أداء التقييمات
اقرأ مؤشرات الأداء الرئيسية لتقييمات موقع، وارسم المخطط الزمني اليومي، وقارن المصادر، واستخرج العبارات الشائعة، وتلقَّ لقطات يومية وأسبوعية عبر webhook.
اقرأ الدليلالمنشورات
التحليلات
الأتمتة
وكلاء الذكاء الاصطناعي
شروحات نقاط النهاية
المواقع
جميع نقاط نهاية المواقع بأمثلة cURL وPython وNode حسب ترتيب الاستخدام: السرد والبحث والجلب بالمعرّف ورمز المتجر والإنشاء والتحديث والأرشفة والصور.
اقرأ الدليلإدراجات الأنشطة التجارية
كل نقاط نهاية Listings API بأمثلة cURL وPython وNode: حالة مزامنة منصات النشر المميزة، والمساعدات الصوتية، وكشف التكرار لكل موقع وحساب ومنعه.
اقرأ الدليلالحسابات المتصلة
كل نقاط نهاية الحسابات المتصلة بأمثلة cURL وPython وNode: ربط Google وFacebook، سرد الحسابات، مطابقة إدراجات نشاط تجاري وربطها، مجلدات، إنشاء GMB، فصل.
اقرأ الدليلالمراجعات
كل نقاط نهاية التقييمات بأمثلة cURL وPython وNode: المصادر والإعدادات، القائمة، التجميع، التفاصيل، الرد، التعديل، الأرشفة، العبارات، التحليلات.
اقرأ الدليلالمنشورات
كل نقاط نهاية المنشورات بأمثلة cURL وPython وNode: إعلانات وفعاليات وعروض، جدولة وحملات لكل موقع وجماعية، استعلام دوري عن الحالة وحذف.
اقرأ الدليلSocial
جميع نقاط نهاية Social: العلامات التجارية، وروابط الاتصال المستضافة، والنشر الفردي والجماعي، والجدولة، والإحصاءات، والحد الأقصى للاتصالات الذي يحكم كل ذلك.
اقرأ الدليلالتحليلات
كل نقطة نهاية لتحليلات الملف التجاري مع مثال باستخدام cURL وPython وNode: مقاييس يومية من Google وFacebook ومشاهدات أسبوعية من Bing لموقع.
اقرأ الدليلواجهات API المساعدة
كل نقاط نهاية API المساندة بأمثلة cURL وPython وNode: البلدان والولايات المدعومة، ودليل الفئات الفرعية، ومواقع منصات النشر المشمولة بخطتك.
اقرأ الدليل