REST Resource: spreadsheets.values

{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}

string

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

enum (Dimension)

السمة الرئيسية للقيم

بالنسبة إلى الإخراج، إذا كانت بيانات جدول البيانات هي: A1=1,B1=2,A2=3,B2=4، سيؤدي طلب range=A1:B2,majorDimension=ROWS إلى عرض [[1,2],[3,4]]، في حين سيؤدي طلب range=A1:B2,majorDimension=COLUMNS إلى عرض [[1,3],[2,4]].

بالنسبة إلى الإدخال، سيؤدي استخدام range=A1:B2,majorDimension=ROWS ثم [[1,2],[3,4]] إلى ضبط A1=1,B1=2,A2=3,B2=4. باستخدام range=A1:B2,majorDimension=COLUMNS، سيضبط [[1,2],[3,4]] القيمة A1=1,B1=3,A2=2,B2=4.

عند الكتابة، إذا لم يتم ضبط هذا الحقل، سيتم ضبطه تلقائيًا على ROWS.

array (ListValue format)

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

بالنسبة إلى الإخراج، لن يتم تضمين الصفوف والأعمدة الفارغة في نهاية التقرير.

بالنسبة إلى الإدخال، تكون أنواع القيم المسموح بها هي: bool وstring وdouble. سيتم تخطّي القيم الخالية. لضبط خلية على قيمة فارغة، اضبط قيمة السلسلة على سلسلة فارغة.