نظرة عامة على Google Sheets API

Google Sheets API هي واجهة REST تتيح لك قراءة وتعديل لبيانات جدول البيانات. تشمل الاستخدامات الأكثر شيوعًا لواجهة برمجة التطبيقات هذه ما يلي: المهام:

  • إنشاء جداول بيانات
  • قراءة قيم خلايا جدول البيانات وكتابتها
  • تعديل تنسيق جدول البيانات
  • إدارة أوراق البيانات المرتبطة

في ما يلي قائمة بالمصطلحات الشائعة المستخدمة في Sheets API:

جدول بيانات

هو الكائن الأساسي في جداول بيانات Google الذي يمكن أن يحتوي على أوراق متعددة، مع المعلومات المهيكلة المضمنة في الخلايا. حاسمة مورد جدول البيانات يمثل كل جدول بيانات ويحتوي على قيمة spreadsheetId فريدة، التي تتضمن أحرفًا أو أرقامًا أو واصلات أو شُرطًا سفلية. يمكنك العثور على رقم تعريف جدول البيانات في عنوان URL لـ "جداول بيانات Google":

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

جدول بيانات Google

صفحة أو علامة تبويب داخل جدول بيانات. حاسمة يمثّل مصدر ورقة البيانات كلّ ورقة بيانات ويضم عنوانًا فريدًا ورقميًا sheetId. إِنْتَ يمكنك العثور على معرف الورقة في عنوان URL لـ Google Sheets:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

الخلية

حقل فردي من النص أو البيانات داخل ورقة. يتم ترتيب الخلايا في الصفوف والأعمدة، ويمكن تجميعها كنطاق من الخلايا. حاسمة يمثل مورد CellData كل خلية، ولكن ليس له قيمة معرف فريدة. بدلاً من ذلك، يمكن استخدام وتحدد إحداثيات العمود الخلايا.

الترميز A1

بناء جملة يستخدم لتحديد خلية أو نطاق من الخلايا بسلسلة على اسم الورقة بالإضافة إلى إحداثيات خلية البداية والنهاية باستخدام أحرف الأعمدة وأرقام الصفوف. وهذه الطريقة هي الأكثر شيوعًا والأكثر فائدة عند الإشارة إلى نطاق مطلق من الخلايا.

عرض الأمثلة

  • تشير Sheet1!A1:B2 إلى أول خليتين في أعلى صفين من Sheet1.
  • تشير Sheet1!A:A إلى جميع الخلايا في أول عمود من Sheet1.
  • تشير Sheet1!1:2 إلى جميع الخلايا في أول صفين من Sheet1.
  • تشير Sheet1!A5:A إلى جميع خلايا العمود الأول في الورقة 1، بدءًا من الصف 5 فصاعدًا.
  • تشير السمة A1:B2 إلى أول خليتين في أعلى صفَّين من أول ورقة بيانات مرئية.
  • تشير Sheet1 إلى جميع الخلايا في Sheet1.
  • تشير 'My Custom Sheet'!A:A إلى جميع الخلايا في العمود الأول من ورقة بيانات تحمل اسم "ورقة البيانات المخصّصة". يجب إدخال علامات الاقتباس المفردة في أسماء الأوراق التي تحتوي على مسافات أو أحرف خاصة أو تركيبة من الأحرف الأبجدية الرقمية.
  • تشير السمة 'My Custom Sheet' إلى جميع الخلايا في "جدول البيانات المخصّص".

نصيحة: استخدِم أسماء مختلفة للكائنات داخل جداول البيانات، حيثما أمكن. على سبيل المثال، تشير A1 إلى الخلية A1 في أول ورقة مرئية، بينما تشير A1 إلى الخلية A1 يشير إلى جميع الخلايا في ورقة تسمى A1. وبالمثل، تشير Sheet1 إلى جميع الخلايا في Sheet1. ومع ذلك، إذا كان هناك نطاق مُعنوَن بعنوان "Sheet1"، تشير Sheet1 إلى النطاق المعنوَن و"Sheet1". يشير إلى الورقة.
ترميز R1C1

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

عرض الأمثلة

  • تشير Sheet1!R1C1:R2C2 إلى أول خليتين في أعلى صفين من Sheet1.
  • تشير السمة R1C1:R2C2 إلى أول خليتين في أعلى صفَّين من أول ورقة بيانات مرئية.
  • تشير Sheet1!R[3]C[1] إلى الخلية المكونة من ثلاثة صفوف أسفلها وعمود واحد على يمين الخلية الحالية.
النطاق المُعنون

خلية محدَّدة أو نطاق من الخلايا باسم مخصّص لتبسيطه المراجع في جميع أنحاء التطبيق. حاسمة يمثّل مورد تصفيةView نطاقًا مُعنوَنًا.

النطاق المحمي

خلية محددة أو نطاق من الخلايا لا يمكن تعديله. حاسمة يمثل مورد ProtectedRange نطاقًا محميًا.

الخطوات التالية