العيّنات

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

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

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

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

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

Recipes

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

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

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