実現したいこと

シート名(例:シート１)を指定し「A1: "aa", B1: "bb", C1: ""」といったデータがGoogleSheetにあった場合A1からC1まで空白を含めてすべて取得したいです。

発生している問題

https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet?majorDimension=ROWS&ranges=A1%3AC1&key={APIkey}
上記のURLで範囲指定をして実行しております。
ここではA1からC1と範囲指定をすることはできますが値が含まれているA1とB2までしか取得されず値が含まれていないC1は無視されてしまいます。
またシート指定ができず勝手に最初(1番目)のシートが指定されてしまいます。

実行結果としては以下になります。

json
1{
2  "spreadsheetId": {spreadsheetId},
3  "valueRanges": [
4    {
5      "range": "シート1!A1:C1",
6      "majorDimension": "ROWS",
7      "values": [
8        [
9          "aa",
10          "bb"
11        ]
12      ]
13    }
14  ]
15}

試したこと

範囲指定について

無理やりな方法になりますが「A1: "aa", B1: "bb", C1: "", D1: "1"」とD1を加えることでC1: ""を取得することができます。ですが不格好なためあまりこの方法は使いたくないです...

シート指定について

https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{sheetname}?key={APIkey}
こちらのurlを使うことでシート名を指定することが可能です。しかし今度は範囲指定できません。

上記の二つを使い無理やり範囲指定・シート指定する方法もありますが格好が悪いのでぜひ有識者の方に最適な手段をご教授いただきたいと考えております。
よろしくお願いいたします。

行動規範の内容に同意します

回答1件

ベストアンサー

シート指定について

たぶん参照したドキュメント(解説サイトとか？)が良くなかったのかなと思うのですが
公式のリファレンスに記載されている通り、指定するのは sheetname ではなく range です。

spreadsheets.values.get / 公式リファレンスより一部抜粋

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

range
値を取得する範囲の A1 表記または R1C1 表記。

Google Sheets API の概要 / 公式リファレンスより一部抜粋

A1 表記
セルまたはセル範囲を、シート名と、列の文字と行番号を使用した開始および終了のセル座標を含む文字列で定義するために使用される構文。

R1C1 表記
セルまたはセル範囲を、シート名、行番号、列番号を使用した開始セルおよび終了セル座標を含む文字列で定義するために使用される構文。

使用例

こんな感じで、別々のシートから指定範囲の取得とかもできます

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet?ranges=シート1!A1:B5&ranges=シート10!A1:C2&key={APIkey}

JSON:結果
1{
2  "spreadsheetId": "{spreadsheetId}",
3  "valueRanges": [
4    {
5      "range": "'シート1'!A1:B5",
6      "majorDimension": "ROWS",
7      "values": [
8        [
9          "名前",
10          "年齢"
11        ],
12        [
13          "user0",
14          "0"
15        ],
16        [
17          "user1",
18          "1"
19        ],
20        [
21          "user2",
22          "2"
23        ],
24        [
25          "user3",
26          "3"
27        ]
28      ]
29    },
30    {
31      "range": "'シート10'!A1:C2",
32      "majorDimension": "ROWS",
33      "values": [
34        [
35          "value1",
36          "value2",
37          "value3"
38        ],
39        [
40          "1",
41          "2"
42        ]
43      ]
44    }
45  ]
46}