Method: spreadsheets.values.update

• طلب HTTP
• معلمات المسار
• معامِلات طلب البحث
• نص الطلب
• نص الاستجابة
• نطاقات التفويض
• جرِّبه الآن

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

طلب HTTP

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

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

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

المَعلمات
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

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