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