بالإضافة إلى بيانات القيمة الواردة في خلاياه، يتضمن جدول البيانات العديد من الأنواع الأخرى من البيانات، مثل:
- الأبعاد
- تنسيقات الخلايا وحدودها
- النطاقات المُعنونة
- النطاقات المحمية
- التنسيق المشروط
هذه بعض أنواع البيانات العديدة التي تتحكم في
مظهر جدول البيانات وعمله. تتيح لك طريقة spreadsheets.batchUpdate
تعديل أي من تفاصيل جدول البيانات هذه. يتم تجميع التغييرات في دفعة بحيث
إذا لم ينجح أحد الطلبات، فلا تتم كتابة أي من التغييرات الأخرى (التي يحتمل أن تكون تابعة).
توضّح هذه الصفحة أساسيات استخدام طريقة
spreadsheets.batchUpdate
. إذا كنت بحاجة إلى قراءة بيانات قيمة الخلية وكتابتها، يمكنك أيضًا استخدام مورد
spreadsheets.values
الموضّح في قراءة قيم الخلية وكتابتها.
فئات العمل
يمكن تجميع العمليات المحدّدة التي يتيحها spreadsheets.batchUpdate
في الفئات الواسعة التالية:
الفئة | الوصف |
---|---|
إضافة (ونسخة طبق الأصل) | أضِف كائنات جديدة (تستند أحيانًا إلى الكائنات القديمة، كما في "الطلبات المكرّرة"). |
تحديث (وضبط) | عدِّل خصائص معيّنة لعنصر، مع ترك السمات القديمة وحدها (في حين أنّ طلب "Set" يحلّ محلّ البيانات السابقة). |
حذف | إزالة العناصر |
تُستخدم هذه الفئات في القسم التالي لوصف سلوك عمليات معينة.
عمليات التحديث المجمع
تعمل الطريقة 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
.