عيّنات

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

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

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

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

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

Recipes

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

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

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