النماذج

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

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

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

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

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

وصفات طعام

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

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

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