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