Method: spreadsheets.batchUpdate

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

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

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

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

طلب HTTP

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

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

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

المَعلمات
spreadsheetId

string

جدول البيانات الذي سيتم تطبيق التعديلات عليه

نص الطلب

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

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

object (Request)

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

boolean

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

string

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

boolean

صحيح إذا كان يجب عرض بيانات الشبكة. لا معنى لها إلا إذا كانت قيمة includeSpreadsheetInResponse هي "true". يتم تجاهل هذه المعلّمة في حال ضبط قناع حقل في الطلب.

نص الاستجابة

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

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

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

string

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

object (Response)

الردّ على التعديلات يؤدي هذا إلى ربط نسبة العرض إلى الارتفاع 1:1 بالتعديلات، إلا أنّ الردود على بعض الطلبات قد تكون فارغة.
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

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