Method: spreadsheets.values.clear

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

طلب HTTP

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

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

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

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

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