スプレッドシートから値をクリアします。呼び出し元は、スプレッドシートの ID と範囲を指定する必要があります。クリアされるのは値のみです。セルのその他すべてのプロパティ(書式設定やデータの入力規則など)は保持されます。
HTTP リクエスト
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
spreadsheetId |
更新するスプレッドシートの ID。 |
range |
クリアする値の A1 表記または R1C1 表記。 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
スプレッドシートの値の範囲をクリアする際のレスポンス。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "spreadsheetId": string, "clearedRange": string } |
フィールド | |
---|---|
spreadsheetId |
更新が適用されたスプレッドシート。 |
clearedRange |
クリアされた範囲(A1 表記)。(制限なしの範囲またはシートの境界より大きいレンジャーに対するリクエストの場合、これはクリアされた実際の範囲であり、シートの上限に制限されます)。 |
認可スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
詳しくは、認可ガイドをご覧ください。