بصرف النظر عن بيانات القيمة الموجودة في خلاياها، جدول البيانات يتضمن العديد من الأنواع الأخرى من البيانات، مثل:
- الأبعاد
- تنسيقات الخلايا وحدودها
- النطاقات المُعنونة
- النطاقات المحمية
- التنسيق المشروط
هذه بعض أنواع البيانات العديدة التي تتحكم في مظهر
عملية جدول بيانات. تتيح لك طريقة spreadsheets.batchUpdate
لتحديث أي من تفاصيل جدول البيانات هذه. يتم تجميع التغييرات في دفعة بحيث
إذا لم ينجح أحد الطلبات، فلا شيء آخر (يُحتمل أن يكون معتمدًا)
كتابة التغييرات.
تصف هذه الصفحة أساسيات استخدام
spreadsheets.batchUpdate
. إذا كنت بحاجة إلى قراءة بيانات قيمة الخلية وكتابتها، فيمكنك أيضًا استخدام
spreadsheets.values
مرجع تم وصفه في القراءة وكتابة قيم الخلايا.
فئات العمل
يمكن تجميع العمليات المحدّدة التي يتيحها spreadsheets.batchUpdate
في الفئات الواسعة التالية:
الفئة | الوصف |
---|---|
إضافة (ونسخة طبق الأصل) | أضِف كائنات جديدة (تستند أحيانًا إلى الكائنات القديمة، كما في "الطلبات المكرّرة"). |
تحديث (وضبط) | عدِّل خصائص معيّنة لعنصر، مع ترك السمات القديمة وحدها (في حين أنّ طلب "Set" يحلّ محلّ البيانات السابقة). |
حذف | إزالة العناصر |
تُستخدم هذه الفئات في القسم التالي لوصف سلوك عمليات محددة.
عمليات التحديث المجمع
تعمل طريقة spreadsheets.batchUpdate
من خلال استخدام طريقة واحدة أو أكثر
طلب
كل كائن يحدد نوعًا واحدًا من الطلب لتنفيذه. تتوفر
والعديد من أنواع الطلبات المختلفة. إليك تصنيفًا لأنواع الطلبات
مجمعة في فئات مختلفة.
كما توجد بعض الطلبات الإضافية التي تحاكي إجراءات المستخدم للتلاعب البيانات:
- AutoFillRequest
- CutPasteRequest
- CopyPasteRequest
- FindReplaceRequest
- PasteDataRequest
- TextToColumnsRequest
- SortRangeRequest
الحدود
لمعرفة مزيد من المعلومات عن حدود الخلايا والأوصاف في "جداول بيانات Google"، يُرجى الاطّلاع على الملفات التي يمكنك تخزينها في "جداول بيانات Google". Google Drive
أقنعة الحقل
العديد من "التحديث" الطلبات أقنعة حقل. هذه القيم مفصولة بفواصل
قائمة بالحقول لتحديث حقول معينة فقط في الكائن مع ترك
الحقول الأخرى بدون تغيير. يتم التعامل مع قناع الحقل *
على أنه
حرف بدل وهو اختصار لتحديد كل حقل في الرسالة (مما يعني
قد يعود الحقل إلى حالته الافتراضية إذا لم تحدد قيمة له في
الطلب).
لمزيد من المعلومات حول أقنعة الحقول، يُرجى الاطّلاع على مقالة استخدام الحقل.
كمامات.
يستخدم النموذج التالي دالة
UpdateSpreadsheetPropertiesRequest
لتحديث عنوان جدول البيانات فقط:
الطلب:
POST .../v4/spreadsheets/spreadsheetId:batchUpdate
نص الطلب:
{
"requests": [{
"updateSpreadsheetProperties": {
"properties": {"title": "TITLE"},
"fields": "title"
}
}]
}
استبدل TITLE بالعنوان الجديد لجدول البيانات.
الردود
عند تعديل جدول بيانات، قد تعرض بعض أنواع الطلبات ردودًا. هذه في صفيف، مع شغل كل استجابة الفهرس نفسه مثل الطلب المقابل. بعض الطلبات لا تتضمن ردودًا، وبالنسبة إلى الاستجابة فارغة.
عادة، "إضافة" تحتوي الطلبات على ردود تعرض معلومات مثل المعرّف للكائن المضاف. للحصول على قائمة بالردود المتوافقة، راجع الردود:
مثال
وينفذ نموذج الرمز البرمجي التالي الإجراءات التالية:
- لتعديل عنوان جدول البيانات باستخدام المتغيّر
title
. - للبحث عن قيم الخلايا واستبدالها في جدول البيانات باستخدام
find
متغيّران (replacement
)