# مزامنة Google Sheets

تحفظ مزامنة Google Sheets بيانات متجرك في جدول بيانات. الطلبات والسلات المتروكة تُكتَب فيه لحظة وقوعها، أمّا المنتجات والعملاء فيصلون إليه عبر التصدير اليدوي الموصوف أدناه.

## الإعداد[​](#الإعداد "رابط مباشر إلى الإعداد")

1. اذهب إلى `/dashboard/addons/google-sheets`.
2. انقر على **ربط حساب Google** وامنح الإذن عبر OAuth.
3. انقر على **إنشاء ورقة جديدة** (أو ربط ورقة موجودة أنشأها التطبيق). يسألك النموذج هل تنسخ طلباتك السابقة إلى الجدول (**أضف كل الطلبات السابقة**) أم تبدأ بجدول فارغ يمتلئ من الطلب التالي (**الطلبات الجديدة فقط**)، وأين تُضاف الطلبات الجديدة: **في الأسفل (الأقدم أولاً)**، وهو الافتراضي، أو **في الأعلى (الأحدث أولاً)**. تبدأ المزامنة فوراً في الخلفية.

إذا انتهت صلاحية الرمز لاحقاً، ستطلب الصفحة منك إعادة الربط.

## ما الذي يتزامن؟[​](#ما-الذي-يتزامن "رابط مباشر إلى ما الذي يتزامن؟")

| نوع البيانات    | الأعمدة المكتوبة                                                                                                                                                                                                                                                                                                                                                              |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| الطلبات         | رقم الطلب، التاريخ، اسم العميل، الهاتف، الولاية، البلدية، العنوان، المنتجات، المتغيّرات، الكمية، سعر الوحدة، المجموع الفرعي، تكلفة الشحن، الخصم، الإجمالي، الحالة، اسم العرض — إضافة إلى أعمدة اختيارية يمكنك تفعيلها: الملاحظات، رمز الخصم، نوع التوصيل، SKU، رقم الولاية. أما شركة التوصيل ورقم التتبع فلا يُصدَّران إلى Sheets.                                            |
| المنتجات        | معرّف المنتج، الاسم، السعر، السعر القديم، المخزون، الفئة، مؤشّر وجود متغيّرات، المتغيّرات، الحالة — إضافة إلى عمود اختياري واحد يمكنك تفعيله: SKU.                                                                                                                                                                                                                            |
| العملاء         | معرّف العميل، الاسم، الهاتف، البريد، الولاية، البلدية، عدد الطلبات، إجمالي الإنفاق، تاريخ التسجيل                                                                                                                                                                                                                                                                             |
| تحديثات المخزون | لا يُكتَب شيء تلقائياً. مفتاح **تحديثات المخزون** الخاص بكل ورقة يحفظ إعداداً بلا أثر اليوم: تغيّر المخزون لا يمسّ الورقة. الكميّة في تبويب **المنتجات** هي ما كتبه آخر تصدير كامل، فأعِد تشغيل **تصدير الآن** حين تحتاج أرقاماً محدَّثة. لا يوجد تبويب مخزون منفصل، ولا يُكتَب مخزون المتغيّرات إطلاقاً (عمود *المتغيّرات* في تبويب المنتجات ملخّص نصّي يكتبه التصدير نفسه). |
| السلات المتروكة | معرّف السلة، الهاتف، الاسم، الولاية، البلدية، المنتجات، عدد العناصر، إجمالي السلة، الحالة، تاريخ الإنشاء، آخر نشاط — إضافة إلى أعمدة اختيارية يمكنك تفعيلها: صفحة المصدر، البريد الإلكتروني، رقم الولاية، المتغيّرات، SKU.                                                                                                                                                    |

الورقة الأولى التي تربطها تزامن كل ما سبق. الأوراق الإضافية تزامن **الطلبات فقط** بشكل افتراضي.

الطلبات والسلات المتروكة وحدها تُكتَب لحظة وقوعها. أمّا المنتجات والعملاء فيصلون إلى الورقة عبر تشغيل **تصدير الآن** اليدوي الموصوف أدناه، لا عند تعديلك لها.

## إعدادات وأعمدة لكل ورقة[​](#إعدادات-وأعمدة-لكل-ورقة "رابط مباشر إلى إعدادات وأعمدة لكل ورقة")

لكل ورقة مرتبطة إعداداتها الخاصة، فيمكن أن تكون إحدى الأوراق سجل طلبات لفريق التأكيد بالاتصال بينما تكون الأخرى تصديراً كاملاً للكتالوج:

* **أنواع البيانات التي تستقبلها** — الطلبات، المنتجات، العملاء، تحديثات المخزون، السلات المتروكة، أو الطلبات فقط.
* **تشغيل أو إيقاف المزامنة التلقائية** لتلك الورقة.
* **الأعمدة التي تظهر وترتيبها.** ثلاث قوائم بالسحب والإفلات، مع مفتاح على كل سطر: 22 عموداً للطلبات، و10 للمنتجات، و16 للسلات المتروكة. رقم الطلب مثبَّت ولا يمكن إطفاؤه. أمّا العملاء فليس لهم قائمة أعمدة أصلاً، بل مفتاح واحد للورقة كلّها، وأعمدتهم التسعة ثابتة.

وعند إنشاء ورقة تستطيع أيضاً حصرها في **قائمة منتجات محددة** بدل الكتالوج كله.

## تصدير كل شيء دفعة واحدة[​](#تصدير-كل-شيء-دفعة-واحدة "رابط مباشر إلى تصدير كل شيء دفعة واحدة")

إلى جانب المزامنة الحيّة، هناك إجراء يدوي **تصدير الآن** يدفع البيانات الموجودة إلى الورقة في مرة واحدة — الطلبات أو المنتجات أو العملاء أو السلات المتروكة أو الطلبات + السلات أو كل شيء. يعمل في الخلفية مع شريط تقدّم، وهو محدود بـ 10 عمليات في الدقيقة.

## تغييرات الحالة تُكتب في الورقة[​](#تغييرات-الحالة-تُكتب-في-الورقة "رابط مباشر إلى تغييرات الحالة تُكتب في الورقة")

عند تغيير حالة طلب في لوحة التحكم، يحدّث DZBuild **الصف الموجود** لذلك الطلب في الورقة بدل إضافة صف مكرّر. وينطبق الأمر نفسه على السلات المتروكة (`abandoned` و`contacted` و`recovered` و`expired`)، كما تُلوَّن صفوف السلات المتروكة حسب حالتها.

## حدود الأوراق النشطة حسب الخطة[​](#حدود-الأوراق-النشطة-حسب-الخطة "رابط مباشر إلى حدود الأوراق النشطة حسب الخطة")

| الخطة      | الحد الأقصى للأوراق النشطة |
| ---------- | -------------------------- |
| المجانية   | 1                          |
| الاحترافية | 6                          |
| غير محدود  | 10                         |
| المؤسسات   | 30                         |

عند بلوغ الحد ستظهر رسالة: *"لقد وصلت إلى الحد الأقصى للأوراق المفعلة"*. افصل ورقة غير مستخدمة أو قم بالترقية.

## استكشاف الأخطاء[​](#استكشاف-الأخطاء "رابط مباشر إلى استكشاف الأخطاء")

| المشكلة                                  | الحل                                                               |
| ---------------------------------------- | ------------------------------------------------------------------ |
| رسالة "انتهت الصلاحية" / طلب إعادة الربط | انقر على إعادة الربط وامنح الإذن مجدداً                            |
| توقف الورقة عن التحديث                   | تحقق من حالة الاتصال؛ Google تلغي الرموز بعد فترة غياب طويلة       |
| تعذّر إنشاء أوراق إضافية                 | بلغت حد الخطة — انظر الجدول أعلاه                                  |
| الصفحة تقول "غير متصل" رغم أنك ربطتها    | تعذّرت قراءة الرمز المخزَّن؛ أعد الربط فقط عبر **ربط حساب Google** |

**فصل الاتصال** يفعل أكثر من مسح الربط: فهو يلغي أيضاً وصول DZBuild من جهة Google ويمحو الرموز المخزَّنة، ما يعني أن إعادة الربط تتطلب منح الإذن من الصفر.

## Octomatic[​](#octomatic "رابط مباشر إلى Octomatic")

[Octomatic](https://octomatic.shop) أداة تشغيل آلي تابعة لطرف ثالث تتصل بـ DZBuild **عبر Google Sheets**. أعدّ Google Sheets أولاً، ثم اتبع الدليل على `/dashboard/addons/octomatic`. يقرأ Octomatic خانة **نوع التوصيل** كلمةً بكلمة، لذلك يجب أن يكون النص الذي يكتبه DZBuild فيها إحدى الكلمات التي يعرفها (مثل `desk` أو `مكتب`). غيّر ذلك النص لطلبات المنزل والمكتب والاستلام من المتجر تحت **نص نوع التوصيل في الورقة** في صفحة Google Sheets؛ الطلبات التي تُكتب بعد التغيير تستعمله.

📺 [فيديو شرح إعداد Google Sheets](https://www.youtube.com/watch?v=YymREJXr53k)