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

للإدخال، سيتم تعيين A1=1,B1=2,A2=3,B2=4 على range=A1:B2,majorDimension=ROWS، ثم [[1,2],[3,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

تُحدِّد القيم في نطاق من جدول البيانات.