سكربت Google Apps Script يبني موجز منتجات لـ Google Merchant Center من جدول منتجاتك الخاص

مثال على النتيجة

python merge_sales.py --month 2026-10

2026-11-02 09:14:03 INFO  المجلد: sales/2026-10، عُثر على 9 ملفات
2026-11-02 09:14:03 INFO  shop-01.csv: 1,284 صفًا
2026-11-02 09:14:04 INFO  shop-02.xlsx: 967 صفًا
2026-11-02 09:14:04 WARN  shop-07.csv: تُخطّيت 3 صفوف بلا سعر (الأسطر 88، 412، 913)
2026-11-02 09:14:05 INFO  تم: 10,412 صفًا -> report-2026-10.xlsx (الورقتان «المبيعات» و«الإجماليات»)

[columns]
date = التاريخ, تاريخ البيع, اليوم
product = المنتج, الصنف, الاسم
quantity = الكمية, العدد, قطع
price = السعر, سعر الوحدة

def read_shop_file(path: Path, columns: dict[str, list[str]]) -> pd.DataFrame:
    """يقرأ ملف متجر واحد ويمنح أعمدته أسماء أعمدة التقرير."""
    table = pd.read_excel(path) if path.suffix == ".xlsx" else pd.read_csv(path, encoding="utf-8-sig")
    renamed = {}
    for name, variants in columns.items():
        found = next((c for c in table.columns if c.strip() in variants), None)
        if found is None:
            raise ReportError(f"{path.name}: لا يوجد عمود لـ «{name}» (جرى البحث عن: {', '.join(variants)})")
        renamed[found] = name
    table = table.rename(columns=renamed)[list(columns)]
    table["shop"] = path.stem
    return table

عن هذه الخدمة

يستطيع Google Merchant Center قراءة المنتجات مباشرة من جدول بيانات Google، لكن بحقوله الخاصة فقط: id وtitle وdescription وlink وimage_link وavailability وprice مع رمز العملة وbrand وgtin وغيرها. يأخذ سكربت Google Apps Script هذا جدول منتجاتك، المرتب بالطريقة التي تعمل بها، ويبني تبويب Feed منفصلًا بذلك التنسيق: يكتب الأسعار مثل 19.99 USD، ويحوّل In stock أو 0 إلى الكلمات التي يقبلها Merchant Center، ويختصر العناوين إلى حد الطول الخاص به، وبدءًا من الباقة القياسية يسرد الصفوف التي ينقصها رابط أو صورة أو سعر قبل إرسالها. تربط تبويب Feed في Merchant Center بنفسك. الحقائق تأتي من جدولك ويجب أن تطابق موقعك؛ تراجع Google كل منتج، لذا لا يمكن لأحد أن يضمن الموافقة.

ما المشمول

• ما الذي تحصل عليهأرشيف ZIP يضم كود Apps Script وملف README يوضح كيفية إضافته إلى جدولك وربط تبويب Feed في Merchant Center؛ ويُعرض الكود أيضًا في صفحة الطلب.
• حقول Merchant Centerid وtitle وlink وimage_link وprice وavailability وغيرها
• جدولك يبقى كما هويُبنى الموجز في تبويب منفصل
• قيم يقبلهاأسعار مع العملة، والتوفر بكلماته
• المشكلات قبل الرفعبدءًا من الباقة القياسية، تُسرد الصفوف التي تنقصها الحقول المطلوبة
• كود مقروءمع تعليقات، ليسهل إضافة حقل لاحقًا

كيف يعمل

1. 1
   الجدولترسل أعمدة جدول منتجاتك وبلد متجرك وعملته
2. 2
   الكودنكتب السكربت ودليل تثبيته
3. 3
   جرّبهتبني الموجز وتربطه في Merchant Center
4. 4
   التعديلاتتطلب التعديلات ضمن باقتك وترسل أي رسالة خطأ

ما نحتاجه منك

أسماء أعمدة جدول منتجاتك مع 10-20 صفًا (منسوخة من كتالوجك الحقيقي أو مختلقة)، والبلد والعملة اللذان تبيع بهما، وكيف يُعرض المخزون (رقم، In stock، Yes أو No)، وهل للمنتجات مقاسات أو ألوان في صفوف منفصلة. العلامات التجارية والرموز الشريطية (GTIN) إن وُجدت، وتفاصيل الشحن والضرائب إن طلبها Merchant Center منك في الموجز، وهل تستخدم الجدول في حساب Google يمكنك تعديله.

سنسألك:

• كيف يبدو جدول منتجاتك؟
• أين تبيع؟
• هل للمنتجات متغيرات؟

قارن بين الباقات

الأسئلة والأجوبة

لم تجد إجابتك؟ اسألنا