إضافة صف إلى جدول بيانات

يضيف الإجراء إضافة صف إلى جدول بيانات صفًا واحدًا من البيانات إلى جدول بيانات Google Sheets.

الاتصال

للبدء في استخدام إجراءات Sheets، يجب عليك أولاً ربط Flow بحسابك على Google Sheets. يجب أن يتمتع هذا المستخدم بصلاحية تعديل جدول البيانات.

إذا لم تكن متأكدًا من المستخدم الذي ربط إجراء Sheets، فيمكنك العثور على تفاصيل اتصالك في محرّر Flow.

الحقول

يحتوي الإجراء إضافة صف إلى جدول بيانات على الحقول التالية.

الحقول المستخدمة في إجراء إضافة صف إلى جدول بيانات.
الحقلالوصف
عنوان URL لجدول البياناتمطلوب. أدخل عنوان URL لجدول البيانات المعروض في المتصفح.
اسم علامة التبويبمطلوب. أدخل اسم علامة تبويب حالية في جدول البيانات.
محتويات الصف (مفصولة بفواصل)مطلوب. أدخل قائمة حقول مفصولة بفواصل. تشير كل فاصلة إلى عمود جديد.

المشغّلات

يمكن استخدام الإجراء إضافة صف إلى جدول بيانات مع أي مشغّل.

مرجع واجهة برمجة التطبيقات (API)

يستدعي Flow واجهة برمجة تطبيقات Google Sheets لإضافة صف إلى جدول بيانات. لمعرفة المزيد، راجع واجهة برمجة تطبيقات Google Sheets.

الأسئلة الشائعة

تمتد البيانات من Flow عبر عدة أعمدة. لماذا يحدث هذا؟

يتم فصل الأعمدة في Sheets بفواصل. إذا كان من المحتمل أن تتضمن البيانات من Flow فاصلة، فسيتم تقسيم البيانات إلى عدة أعمدة. لتجنب ذلك، استخدم فلتر Liquid لإزالة الفواصل. على سبيل المثال، استخدم {{ order.note | replace:",", " " }} لاستبدال الفواصل بمسافة.

تبدأ البيانات من Flow في العمود الخطأ.

إذا كانت ورقة العمل لديك تحتوي على قيم فارغة في الأعمدة القليلة الأولى من الصف الأخير، فستُدرج Sheets العمود التالي بدءًا من العمود الأول الذي يحتوي على محتوى (المستندات). لا يمكنك إصلاح هذا الخطأ إلا من خلال إصلاح ورقة العمل لديك وتجنب إدخال قيم فارغة في جدول البيانات.

أريد إضافة صف لكل صنف في الطلب.

يمكنك استخدام الإجراء For each في Flow للتكرار عبر كل صنف واستدعاء الإجراء إضافة صف إلى جدول بيانات لكل صنف من الأصناف.

أتلقى الخطأ 403 عندما أحاول إضافة صف إلى جدول بيانات. ماذا يعني هذا؟

في العادة، يعني هذا أنه لا يمكن الوصول إلى ورقة العمل للمستخدم الذي قام بربط Google Sheets بـ Flow. للتحقق من ذلك، راجع المستخدم الذي ربط إجراء Sheets. تأكد من أن هذا المستخدم يمكنه تعديل ورقة العمل من واجهة المشاركة في Sheets.

إذا تلقيت هذا الخطأ بعد إجراء اتصال جديد، فمن المحتمل أنك فشلت في منح الإذن لـ Flow لتعديل أوراق العمل لديك في هذه الشاشة:

مشكلة في أذونات Sheets

يجب تحديد خانة الاختيار See, edit, create, and delete all your Google Sheets spreadsheets.

أتلقى الخطأ 429 أو 500 عندما أحاول إضافة صف إلى جدول بيانات. ماذا يعني هذا؟

في العادة، يعني هذا أن ورقة العمل تواجه مشكلة في إضافة صفوف جديدة. يمكن أن يحدث هذا عندما يتلقى Google API طلبات أكثر من اللازم، أو عندما تحتوي ورقة العمل على عدد كبير جدًا من الحقول أو الصفوف.

كيف يمكنني إعادة الاتصال بـ Sheets؟

تتّبع اتصالات Flow عملية إعادة اتصال مشابهة.