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