نماذج

يقدّم هذا القسم codelab يمكنك استخدامه للتعرّف على 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، اطّلِع على دليلَي قراءة ملف ملف جدول بيانات القيم وكتابتها وتعديل ملف جدول بيانات.

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