النماذج

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

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