- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- DataFilterValueRange
- UpdateValuesByDataFilterResponse
- جرِّبه الآن
تضبط القيم في نطاق واحد أو أكثر من جدول البيانات. يجب أن يحدّد المتصل معرّف جدول البيانات وvalueInputOption
وDataFilterValueRanges
واحدًا أو أكثر.
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdateByDataFilter
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات المطلوب تعديله. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "valueInputOption": enum ( |
الحقول | |
---|---|
valueInputOption |
كيفية تفسير بيانات الإدخال. |
data[] |
القيم الجديدة المطلوب تطبيقها على جدول البيانات. إذا تمت مطابقة أكثر من نطاق واحد مع قيمة |
includeValuesInResponse |
تحدِّد هذه السياسة ما إذا كان يجب أن تتضمّن استجابة التحديث قيم الخلايا التي تم تعديلها. بشكلٍ تلقائي، لا تتضمّن الردود القيم المعدَّلة. يحتوي الحقل |
responseValueRenderOption |
تحدّد كيفية عرض القيم في الاستجابة. خيار العرض التلقائي هو |
responseDateTimeRenderOption |
يحدِّد كيفية عرض التواريخ والأوقات والمدد في الردّ. يتم تجاهل هذه القيمة إذا كانت قيمة |
نص الاستجابة
الاستجابة عند تحديث نطاق من القيم في جدول بيانات.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"spreadsheetId": string,
"totalUpdatedRows": integer,
"totalUpdatedColumns": integer,
"totalUpdatedCells": integer,
"totalUpdatedSheets": integer,
"responses": [
{
object ( |
الحقول | |
---|---|
spreadsheetId |
جدول البيانات الذي تم تطبيق التعديلات عليه. |
totalUpdatedRows |
إجمالي عدد الصفوف التي تم فيها تعديل خلية واحدة على الأقل في الصف |
totalUpdatedColumns |
إجمالي عدد الأعمدة التي تم فيها تعديل خلية واحدة على الأقل في العمود |
totalUpdatedCells |
تم تعديل إجمالي عدد الخلايا. |
totalUpdatedSheets |
إجمالي عدد الأوراق التي تم فيها تعديل خلية واحدة على الأقل في ورقة البيانات |
responses[] |
تم تعديل الرد لكل نطاق. |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.
DataFilterValueRange
نطاق من القيم يتم تحديد موقعه بواسطة DataFilter
.
تمثيل JSON |
---|
{ "dataFilter": { object ( |
الحقول | |
---|---|
dataFilter |
يصف عامل تصفية البيانات موقع القيم في جدول البيانات. |
majorDimension |
تمثّل هذه السمة البُعد الرئيسي للقيم. |
values[] |
البيانات المراد كتابتها. وإذا تجاوزت القيم المقدَّمة أيًا من النطاقات التي تمت مطابقتها بفلتر البيانات، سيتعذّر تنفيذ الطلب. إذا كانت القيم المقدَّمة أقل من النطاقات المطابِقة، تتم كتابة القيم المحددة فقط، ستظل القيم الحالية في النطاقات المطابِقة غير متأثرة. |
UpdateValuesByDataFilterResponse
الاستجابة عند تعديل نطاق من القيم باستخدام فلتر بيانات في جدول بيانات.
تمثيل JSON |
---|
{ "updatedRange": string, "updatedRows": integer, "updatedColumns": integer, "updatedCells": integer, "dataFilter": { object ( |
الحقول | |
---|---|
updatedRange |
النطاق (في تدوين A1) الذي تم تطبيق التعديلات عليه. |
updatedRows |
عدد الصفوف التي تم فيها تعديل خلية واحدة على الأقل في الصف |
updatedColumns |
عدد الأعمدة التي تم فيها تعديل خلية واحدة على الأقل في العمود |
updatedCells |
تم تعديل عدد الخلايا. |
dataFilter |
فلتر البيانات الذي اختار النطاق الذي تم تعديله. |
updatedData |
قيم الخلايا في النطاق المطابق لـ dataFilter بعد تطبيق جميع التحديثات. لا يتم تضمين ذلك إلا إذا كان حقل |