تضبط القيم في نطاق جدول بيانات. يجب أن يحدّد المتصل رقم تعريف جدول البيانات والنطاق وvalueInputOption
.
طلب HTTP
PUT https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}
يستخدم عنوان URL بنية gRPC Transcode.
معلّمات المسار
المَعلمات | |
---|---|
spreadsheetId |
رقم تعريف جدول البيانات المطلوب تعديله |
range |
تدوين A1 للقيم المطلوب تعديلها. |
معلمات طلب البحث
المَعلمات | |
---|---|
valueInputOption |
كيفية تفسير بيانات الإدخال |
includeValuesInResponse |
تُحدِّد هذه السياسة ما إذا كان يجب أن تتضمّن استجابة التعديل قيم الخلايا التي تم تعديلها. بشكل تلقائي، لا تتضمّن الردود القيم المعدَّلة. إذا كان النطاق المراد كتابته أكبر من النطاق المكتوب فعليًا، ستتضمّن الاستجابة جميع القيم في النطاق المطلوب (باستثناء الصفوف والأعمدة الفارغة الفارغة). |
responseValueRenderOption |
ويحدِّد كيفية عرض القيم في الرد. إنّ خيار العرض التلقائي هو |
responseDateTimeRenderOption |
يحدّد كيفية عرض التواريخ والأوقات والمُدد في الرد. ويتم تجاهل السياسة إذا كانت قيمة |
نص الطلب
يحتوي نص الطلب على مثال ValueRange
.
نص الاستجابة
إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثال UpdateValuesResponse
.
نطاقات الأذونات
يتطلب ذلك أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
لمزيد من المعلومات، اطّلِع على دليل التفويض.