Method: spreadsheets.values.clear

يمحو القيم من جدول بيانات يجب أن يحدِّد المتصل رقم تعريف جدول البيانات ونطاقه. يتم محو القيم فقط، ويتم الاحتفاظ بجميع السمات الأخرى في الخلية (مثل التنسيق والتحقّق من صحة البيانات وما إلى ذلك).

طلب HTTP

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

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

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

المَعلمات
spreadsheetId

string

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

string

تدوين A1 أو ترميز R1C1 للقيم المطلوب محوها.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

الاستجابة عند محو نطاق من القيم في جدول بيانات

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

تمثيل JSON 
{
  "spreadsheetId": string,
  "clearedRange": string
}
الحقول
spreadsheetId

string

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

string

النطاق (في تدوين A1) الذي تم محوه. (إذا كان الطلب لنطاق غير محدود أو نطاقًا أكبر من حدود ورقة البيانات، يكون هذا هو النطاق الفعلي الذي تم محوه أو تم التقيّد بحدود ورقة البيانات).

نطاقات الأذونات

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

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

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