Apps Scriptに似ているのSpreadsheetApp#Range#getValues()
は、SheetsRESTAPIのspreadsheets.values()
エンドポイントです。ここでの利点は、選択した場所からこれをデプロイできることであり、AppsScriptバージョンのJavascriptでの作業に限定されません。許可されたアクセスの実装を簡素化するクライアントライブラリは、Googleからさまざまな言語で入手できます。
さらに、Google REST APIにリクエストを送信する場合、標準パラメータの1つはfields
仕様です。これにより、返されるデータを、送信をリクエストしたデータのみに制限できます。
部分的な応答スニペットを引用するには:
スプレッドシートは大きく、多くの場合、スプレッドシートのすべての部分が必要なわけではありません。fields URLパラメータを使用して、GoogleSheetsAPIレスポンスで返されるものを制限できます。これは、spreadsheets.getメソッドで特に役立ちます。最高のパフォーマンスを得るには、返信に必要なフィールドのみを明示的にリストしてください。fieldsパラメータの形式は、FieldMaskのJSONエンコーディングと同じです。簡単に言うと、複数の異なるフィールドはコンマで区切られ、サブフィールドはドットで区切られます。便宜上、同じタイプの複数のサブフィールドを括弧内にリストすることができます。
たとえば、スプレッドシートのタイトル、シートのプロパティ、および範囲A1:C10の値と形式を取得します。次のリクエストを使用できます。
GET https://sheets.googleapis.com/v4/spreadsheets/YOURSHEETID?ranges=A1:C10&fields=properties.title,sheets(sheetProperties,data.rowData.values(effectiveValue,effectiveFormat))