محمود عبدالنبي
التجارة الإلكترونية · أداة سطر أوامر · 2

دليل المستودع: مدقق تشخيص خلاصة Merchant Center وسلامة كتالوج Google

صفحة تعريفية مستقلة بمستودع مدقق تشخيص خلاصة Merchant Center وسلامة كتالوج Google. توضّح ما الذي يحاول حله، ولمن يناسب، وما الملفات التي ستجدها قبل الانتقال إلى المصدر.

المشكلة التي يعالجها

يوضح التوثيق الأصلي نطاق المشكلة بهذا الوصف:

Develop a pure Python Google Merchant Center feed linter (gmc_feed_linter.py): 1) Parses XML (RSS 2.0 / Atom) and TSV/CSV product feeds, 2) Validates mandatory attributes (id, title, description, link, image_link, availability, price with ISO currency, brand, gtin), 3) Checks for prohibited title formatting (ALL CAPS, marketing fluff), 4) Outputs an executive terminal error summary and CSV export of defective SKUs.

لمن صُمم؟

الجمهور المحدد في README: PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

محتويات المستودع

الملفات الأساسية التي يسردها قسم بنية المستودع في README:

  • LICENSE
  • playbooks/merchant-center-suspension-recovery.md
  • README.md
  • reports/sample_error_report.csv
  • sample_data/sample_broken_feed.xml
  • src/gmc_feed_linter.py
  • tests/test_linter.py

طريقة مراجعته واستخدامه

  1. ابدأ بقراءة README وتأكد أن المشكلة المذكورة تطابق احتياجك الفعلي.
  2. افحص الملفات المذكورة أعلاه؛ أسماء الملفات توضح مكان البيانات والأدوات والقوالب والاختبارات.
  3. اتبع Quick Start الموجود في README، وتحقق من المتطلبات قبل تشغيل أي أمر.
  4. قارن المخرجات بعينة موثقة، وراجع القيود قبل استخدامها في قرار أو عمل عميل.

أمثلة أوامر البدء من README: python -m unittest discover -s tests · python src/gmc_feed_linter.py --help

النطاق والقيود

  • Mandatory XML/TSV Attribute Completeness: Validates presence of id, title, description, link, image_link, availability, price, gtin, and brand.
  • Currency & VAT Inclusivity: Enforces localized ISO 4217 currencies (SAR, AED, EGP) and mandates prices inclusive of statutory VAT for consumer feeds.
  • Google Taxonomy Categorization: Validates that product_type and google_product_category conform to Google's official taxonomy numerical IDs.

هذه الصفحة تلخص التوثيق المتاح ولا تثبت أداءً أو نتيجة تجارية. تحقق من صلاحية البيانات والمتطلبات قبل الاستخدام.

مستودعات مرتبطة