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