لضبط القيم في نطاق واحد أو أكثر من جدول البيانات. يجب أن يحدّد المتصل معرّف جدول البيانات وvalueInputOption
وValueRanges
واحد أو أكثر.
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
يستخدم عنوان 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[] |
قيمة UpdateValuesResponse واحدة لكل نطاق مطلوب، بالترتيب نفسه الذي ظهرت فيه الطلبات. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.