- طلب 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 بعد تطبيق جميع التعديلات. يتم تضمين هذا فقط إذا كان الحقل |