Method: spreadsheets.values.update

تُستخدَم لضبط القيم في نطاق من جدول البيانات. على المتصل تحديد معرّف جدول البيانات والنطاق وvalueInputOption.

طلب HTTP

PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

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

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

المعلمات
spreadsheetId

string

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

string

ترميز A1 للقيم المطلوب تعديلها

مَعلمات طلب البحث

المعلمات
valueInputOption

enum (ValueInputOption)

كيفية تفسير بيانات الإدخال
includeValuesInResponse

boolean

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

enum (ValueRenderOption)

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

enum (DateTimeRenderOption)

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

نص الطلب

يحتوي نص الطلب على مثال ValueRange.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال UpdateValuesResponse.

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

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

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

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