نماذج

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

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

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

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

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

وصفات طعام

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

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

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