لضبط القيم في نطاق واحد أو أكثر من جداول البيانات يجب أن يحدّد المتصل رقم تعريف جدول البيانات، وvalueInputOption
، وValueRanges
أو أكثر.
طلب HTTP
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate
يستخدم عنوان URL بنية gRPC Transcode.
معلّمات المسار
المَعلمات | |
---|---|
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
لمزيد من المعلومات، اطّلِع على دليل التفويض.