نماذج

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

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

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

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

    • تقلّل من النفقات العامة لبروتوكول HTTP على العميل.
    • تقلّل من عدد طلبات البحث المُقدَّمة.
    • تقلّل من عدد المراجعات في المستند.
    • تضمن تنفيذ جميع التغييرات في المجموعة بشكل متكامل.

وصفات طعام

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

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

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