عيّنات

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

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