عيّنات

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

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