النماذج

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

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