Method: spreadsheets.values.batchUpdate

لضبط القيم في نطاق واحد أو أكثر من جداول البيانات يجب أن يحدّد المتصل رقم تعريف جدول البيانات، وvalueInputOption، وValueRanges أو أكثر.

طلب HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchUpdate

يستخدم عنوان URL بنية gRPC Transcode.

معلّمات المسار

المَعلمات
spreadsheetId

string

رقم تعريف جدول البيانات المطلوب تعديله

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "valueInputOption": enum (ValueInputOption),
  "data": [
    {
      object (ValueRange)
    }
  ],
  "includeValuesInResponse": boolean,
  "responseValueRenderOption": enum (ValueRenderOption),
  "responseDateTimeRenderOption": enum (DateTimeRenderOption)
}
الحقول
valueInputOption

enum (ValueInputOption)

كيفية تفسير بيانات الإدخال
data[]

object (ValueRange)

القيم الجديدة التي سيتم تطبيقها على جدول البيانات
includeValuesInResponse

boolean

تُحدِّد هذه السياسة ما إذا كان يجب أن تتضمّن استجابة التعديل قيم الخلايا التي تم تعديلها. بشكل تلقائي، لا تتضمّن الردود القيم المعدَّلة. يحتوي الحقل updatedData في كل قيمة من BatchUpdateValuesResponse.responses على القيم المعدَّلة. إذا كان النطاق المراد كتابته أكبر من النطاق المكتوب فعليًا، ستتضمّن الاستجابة جميع القيم في النطاق المطلوب (باستثناء الصفوف والأعمدة الفارغة الفارغة).
responseValueRenderOption

enum (ValueRenderOption)

ويحدِّد كيفية عرض القيم في الرد. إنّ خيار العرض التلقائي هو FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

يحدّد كيفية عرض التواريخ والأوقات والمُدد في الرد. ويتم تجاهل السياسة إذا كانت قيمة responseValueRenderOption هي FORMATTED_VALUE. إنّ خيار العرض التلقائي للتاريخ والوقت هو SERIAL_NUMBER.

نص الاستجابة

الاستجابة عند تعديل نطاق من القيم في جدول بيانات.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "spreadsheetId": string,
  "totalUpdatedRows": integer,
  "totalUpdatedColumns": integer,
  "totalUpdatedCells": integer,
  "totalUpdatedSheets": integer,
  "responses": [
    {
      object (UpdateValuesResponse)
    }
  ]
}
الحقول
spreadsheetId

string

جدول البيانات الذي تم تطبيق التحديثات عليه.
totalUpdatedRows

integer

إجمالي عدد الصفوف التي تم فيها تعديل خلية واحدة على الأقل في الصف.
totalUpdatedColumns

integer

إجمالي عدد الأعمدة التي تم تعديل خلية واحدة على الأقل فيها.
totalUpdatedCells

integer

تم تعديل إجمالي عدد الخلايا.
totalUpdatedSheets

integer

إجمالي عدد جداول البيانات التي تم تعديل خلية واحدة على الأقل فيها.
responses[]

object (UpdateValuesResponse)

قيمة UpdateValuesResponse واحدة لكل نطاق مطلوب، بالترتيب نفسه الذي ظهرت به الطلبات.

نطاقات الأذونات

يتطلب ذلك أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

لمزيد من المعلومات، اطّلِع على دليل التفويض.