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