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. سيتم تخطّي القيم الخالية. لضبط خلية على قيمة فارغة، اضبط قيمة السلسلة على سلسلة فارغة.
|
الطُرق |
|
|
إلحاق القيم بجدول بيانات |
|
|
تمحو نطاقًا واحدًا أو أكثر من القيم من جدول بيانات. |
|
|
تمحو نطاقًا واحدًا أو أكثر من القيم من جدول بيانات. |
|
|
تعرض نطاقًا واحدًا أو أكثر من القيم من جدول بيانات. |
|
|
لعرض نطاق واحد أو أكثر من القيم التي تتطابق مع فلاتر البيانات المحدّدة. |
|
|
تُستخدَم لضبط القيم في نطاق واحد أو أكثر من جدول بيانات. |
|
|
تُستخدَم لضبط القيم في نطاق واحد أو أكثر من جدول بيانات. |
|
|
تمحو القيم من جدول بيانات. |
|
|
لعرض نطاق من القيم من جدول بيانات. |
|
|
تُستخدَم لضبط القيم في نطاق من جدول البيانات. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-03-22 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-03-22 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: spreadsheets.values\n\n- [Resource: ValueRange](#ValueRange)\n - [JSON representation](#ValueRange.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ValueRange\n--------------------\n\nData within a range of the spreadsheet.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"range\": string, \"majorDimension\": enum (/workspace/sheets/api/reference/rest/v4/Dimension), \"values\": [ array ] } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `range` | `string` The range the values cover, in [A1 notation](https://developers.google.com/workspace/sheets/api/guides/concepts#cell). For output, this range indicates the entire requested range, even though the values will exclude trailing rows and columns. When appending values, this field represents the range to search for a table, after which values will be appended. |\n| `majorDimension` | `enum (`[Dimension](/workspace/sheets/api/reference/rest/v4/Dimension)`)` The major dimension of the values. For output, if the spreadsheet data is: `A1=1,B1=2,A2=3,B2=4`, then requesting `range=A1:B2,majorDimension=ROWS` will return `[[1,2],[3,4]]`, whereas requesting `range=A1:B2,majorDimension=COLUMNS` will return `[[1,3],[2,4]]`. For input, with `range=A1:B2,majorDimension=ROWS` then `[[1,2],[3,4]]` will set `A1=1,B1=2,A2=3,B2=4`. With `range=A1:B2,majorDimension=COLUMNS` then `[[1,2],[3,4]]` will set `A1=1,B1=3,A2=2,B2=4`. When writing, if this field is not set, it defaults to ROWS. |\n| `values[]` | `array (`[ListValue](https://protobuf.dev/reference/protobuf/google.protobuf/#list-value)` format)` The data that was read or to be written. This is an array of arrays, the outer array representing all the data and each inner array representing a major dimension. Each item in the inner array corresponds with one cell. For output, empty trailing rows and columns will not be included. For input, supported value types are: bool, string, and double. Null values will be skipped. To set a cell to an empty value, set the string value to an empty string. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|\n| ### [append](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/append) | Appends values to a spreadsheet. |\n| ### [batchClear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClear) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchClearByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchClearByDataFilter) | Clears one or more ranges of values from a spreadsheet. |\n| ### [batchGet](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet) | Returns one or more ranges of values from a spreadsheet. |\n| ### [batchGetByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGetByDataFilter) | Returns one or more ranges of values that match the specified data filters. |\n| ### [batchUpdate](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate) | Sets values in one or more ranges of a spreadsheet. |\n| ### [batchUpdateByDataFilter](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdateByDataFilter) | Sets values in one or more ranges of a spreadsheet. |\n| ### [clear](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/clear) | Clears values from a spreadsheet. |\n| ### [get](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) | Returns a range of values from a spreadsheet. |\n| ### [update](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update) | Sets values in a range of a spreadsheet. |"]]
