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

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

array (ListValue format)

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

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

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

الطُرق

append

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

batchClear

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

batchClearByDataFilter

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

batchGet

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

batchGetByDataFilter

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

batchUpdate

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

batchUpdateByDataFilter

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

clear

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

get

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

update

 تُستخدَم لضبط القيم في نطاق من جدول البيانات.