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، سيتم ضبط A1=1,B1=3,A2=2,B2=4 على [[1,2],[3,4]].

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

array (ListValue format)

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

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

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