Method: spreadsheets.batchUpdate

يتم تطبيق تعديل واحد أو أكثر على جدول البيانات.

يتم التحقّق من صحة كل request قبل تطبيقها. إذا كان أي طلب غير صالح، فسيفشل الطلب بالكامل ولن يتم تطبيق أي شيء.

تحتوي بعض الطلبات على replies لتزويدك ببعض المعلومات عن كيفية تطبيقها. ستعكس الردود الطلبات. على سبيل المثال، إذا طبّقت 4 تعديلات وكان الردّ الثالث يتضمّن ردًا، سيتضمّن الردّ ردَّين فارغَين، الردّ الفعلي وردًّا آخر فارغًا بهذا الترتيب.

نظرًا للطبيعة التعاونية لجداول البيانات، لا يمكن ضمان أن يعكس جدول البيانات التغييرات التي أجريتها بالضبط بعد اكتمال ذلك، ولكن يمكنك أن تضمن تطبيق التعديلات في الطلب معًا بشكل شامل. قد يتم إجراء تغييرات على تغييرات المتعاونين. إذا لم يكن هناك متعاونون، يجب أن يعكس جدول البيانات التغييرات التي أجريتها.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

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

المَعلمات
spreadsheetId

string

جدول البيانات الذي تريد تطبيق التعديلات عليه.

نص الطلب

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

تمثيل JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
الحقول
requests[]

object (Request)

قائمة التعديلات التي سيتم تطبيقها على جدول البيانات. سيتم تطبيق الطلبات بالترتيب الذي تم تحديدها به. وفي حال كان أي طلب غير صالح، لن يتم تطبيق أي طلبات.
includeSpreadsheetInResponse

boolean

تحدِّد ما إذا كان يجب أن تتضمّن استجابة التحديث مورد جدول البيانات.
responseRanges[]

string

يحدّ هذا الخيار من النطاقات المضمّنة في جدول بيانات الردود. يكون مفيدًا فقط إذا كانت قيمة includeSpreadsheetInResponse هي "true".
responseIncludeGridData

boolean

True إذا كان يجب عرض بيانات الشبكة. يكون مفيدًا فقط إذا كانت قيمة includeSpreadsheetInResponse هي "true". يتم تجاهل هذه المَعلمة في حال ضبط قناع حقل في الطلب.

نص الاستجابة

الردّ على التعديل المجمّع لجدول بيانات.

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

تمثيل JSON 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
الحقول
spreadsheetId

string

جدول البيانات الذي تم تطبيق التعديلات عليه.
replies[]

object (Response)

الردّ على التعديلات يؤدي هذا إلى الربط بين شخصين بالتعديلات، على الرغم من أنّ الردود على بعض الطلبات قد تكون فارغة.
updatedSpreadsheet

object (Spreadsheet)

جدول البيانات بعد تطبيق التعديلات. ولا يتم ضبط هذه السياسة إلا إذا كانت قيمة السمة BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response هي true.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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

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