نماذج

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

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

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

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

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

وصفات طعام

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

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

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