عيّنات

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

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

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

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

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

Recipes

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

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

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