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

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