REST Resource: spreadsheets.values

المورد: ValueRange

البيانات داخل نطاق من جدول البيانات.

تمثيل JSON 
{
  "range": string,
  "majorDimension": enum (Dimension),
  "values": [
    array
  ]
}
الحقول
range

string

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

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.
values[]

array (ListValue format)

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

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

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

الطُرق

append

 لإلحاق القيم بجدول بيانات.

batchClear

 لمحو نطاق أو أكثر من القيم من جدول بيانات.

batchClearByDataFilter

 لمحو نطاق أو أكثر من القيم من جدول بيانات.

batchGet

 لعرض نطاق واحد أو أكثر من القيم من جدول بيانات.

batchGetByDataFilter

 تعرض نطاق واحد أو أكثر من القيم التي تطابق فلاتر البيانات المحدّدة.

batchUpdate

 لضبط القيم في نطاق واحد أو أكثر من جدول البيانات.

batchUpdateByDataFilter

 لضبط القيم في نطاق واحد أو أكثر من جدول البيانات.

clear

 لمحو القيم من جدول بيانات.

get

 تعرض مجموعة من القيم من جدول بيانات.

update

 لضبط القيم في نطاق من جدول البيانات.