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