نماذج

يقدّم هذا القسم درسًا تطبيقيًا يمكنك استخدامه للتعرّف على Google Sheets API. وتتوفّر أيضًا مجموعة من مثالي "الوصفات" التي توضّح كيفية ترجمة خطوة مقصودة في "جداول بيانات Google" إلى طلب واجهة برمجة التطبيقات.

غالبًا ما تتوفّر أكثر من طريقة لإكمال مهمة معيّنة باستخدام واجهة برمجة التطبيقات. عند تحديد كيفية معالجة مهمة معيّنة، يجب أخذ ما يلي في الاعتبار:

  • إذا كنت بحاجة إلى قراءة قيم الخلايا أو كتابتها، فإنّ مجموعة spreadsheets.values هي خيار أفضل من مجموعة spreadsheets. واجهة الملف الأول أسهل في الاستخدام لإجراء عمليات القراءة/الكتابة البسيطة.

  • استخدِم طُرق الحِزم كلما أمكن، (spreadsheet.batchUpdate، spreadsheet.values.batchGet، و spreadsheet.values.batchUpdate) لتجميع طلبات متعدّدة في طلب طريقة واحد. يؤدي استخدام هذه الخطوات المبرمَجة إلى تحسين الكفاءة من خلال:

    • تقليل النفقات العامة لواجهة برمجة التطبيقات HTTP للعملاء
    • قلِّل عدد طلبات البحث التي يتم إجراؤها.
    • قلِّل عدد النُسخ السابقة للمستند.
    • تأكَّد من أنّ جميع التغييرات في الحزمة متّسقة.

وصفات طعام

توضِّح الأمثلة الواردة في هذا القسم كيفية التعبير عن الإجراءات الشائعة في جدول بيانات Google كطلبات Sheets API v4.

يتم تقديم هذه الأمثلة في شكل طلبات HTTP لتكون متعافِية من اللغة. للتعرّف على كيفية تنفيذ بروتوكولات طلبات Sheets API بلغة معيّنة باستخدام مكتبات عملاء Google API، اطّلِع على دليلَي قراءة ملف ملف & كتابة قيم الخلايا وتعديل جداول البيانات.

تنقسم الوصفات في هذا القسم إلى الفئات التالية: