يقدّم هذا القسم codelab يمكنك استخدامه للتعرّف على Google Sheets API. وتتوفّر أيضًا مجموعة من مثالي "الوصفات" التي توضّح كيفية ترجمة خطوة مقصودة في "جداول بيانات Google" إلى طلب واجهة برمجة التطبيقات.
غالبًا ما تتوفّر أكثر من طريقة لإكمال مهمة معيّنة باستخدام واجهة برمجة التطبيقات. عند تحديد كيفية معالجة مهمة معيّنة، ضع ما يلي في الاعتبار:
- إذا كنت بحاجة إلى قراءة قيم الخلايا أو كتابتها، فإنّ مجموعة
spreadsheets.valuesهي خيار أفضل من مجموعةspreadsheets. وتكون واجهة هذا النوع من الملفات أسهل في الاستخدام لإجراء عمليات قراءة/كتابة بسيطة. استخدِم طُرق الحِزم كلما أمكن، (
spreadsheet.batchUpdate،spreadsheet.values.batchGet، وspreadsheet.values.batchUpdate) لتجميع طلبات متعدّدة في طلب طريقة واحد. يؤدي استخدام هذه الخطوات المبرمَجة إلى تحسين الكفاءة من خلال:- تقليل النفقات العامة لخدمة HTTP للعملاء
- قلِّل عدد طلبات البحث التي يتم إجراؤها.
- قلِّل عدد النُسخ السابقة للمستند.
- تأكَّد من أنّ جميع التغييرات في الحزمة متّسقة.
وصفات طعام
توضِّح الأمثلة الواردة في هذا القسم كيفية التعبير عن الإجراءات الشائعة في جدول بيانات Google كطلبات Sheets API v4.
يتم تقديم هذه الأمثلة في شكل طلبات HTTP لتكون متعافِية من اللغة. للتعرّف على كيفية تنفيذ بروتوكولات طلبات Sheets API بلغة معيّنة باستخدام مكتبات عملاء Google API، اطّلِع على دليلَي قراءة ملف ملف جدول بيانات القيم وكتابتها وتعديل ملف جدول بيانات.
تنقسم الوصفات في هذا القسم إلى الفئات التالية:
- القراءة الأساسية: وصفات توضِّح كيفية قراءة القيم من ورقة بيانات
- الكتابة الأساسية: وصفات تهدف إلى عرض كيفية كتابة القيم في ورقة بيانات
- التنسيق الأساسي: وصفات توضّح كيفية تغيير مظهر الجداول والخلايا.
- الرسوم البيانية: وصفات توضّح كيفية إنشاء الرسوم البيانية وتعديلها في ورقة بيانات.
- التنسيق الشرطي: وصفات توضّح كيفية تغيير مظهر الخلية استنادًا إلى الشروط
- عمليات البيانات: وصفات تهدف إلى عرض كيفية إنشاء البيانات ونقلها ومعالجتها في جدول بيانات
- النطاقات المُسمّاة والمحمية: وصفات توضّح كيفية إنشاء النطاقات المُسمّاة والمحمية وتعديلها وإزالتها في جدول بيانات.
- الجداول المحورية: وصفات توضّح كيفية إنشاء جداول محورية في جدول بيانات.
- عمليات الصفوف والأعمدة: وصفات توضّح كيفية إضافة الصفوف والأعمدة وإزالتها ونقلها وتعديل خصائصها.
- عمليات الأوراق: وصفات توضّح كيفية إنشاء الأوراق وحذفها ونسخها وتنظيفها، بالإضافة إلى التحكّم في خصائصها