本頁面由 Cloud Translation API 翻譯而成。

基本閱讀

Google Sheets API 可讓您讀取儲存格、範圍、一組範圍以及整份工作表本頁的範例說明瞭一些常見的讀物執行 spreadsheets.values敬上資源。您也可以使用 spreadsheets.get 方法，但通常 spreadsheets.values.get 或 spreadsheets.values.batchGet 變得較為簡單

這些範例是以 HTTP 要求的形式呈現中立。瞭解如何使用 API 用戶端程式庫，請參閱讀取與寫入儲存格值。

在這些範例中，預留位置 SPREADSHEET_ID 代表您的位置會提供試算表 ID 可以在試算表網址中找到。系統要讀取的範圍包括在要求中使用 A1 標記法來指定網址。範例範圍是 Sheet1!A1:D5。

來源資料

以下列範例來說，假設您要讀取的試算表包含下列來源匯入第一張工作表 (「Sheet1」) 中第一列的字串是包括個別資料欄如要在試算表請參閱 A1 標記法。

	A	B	C	D
1	項目	費用	存貨	出貨日期
2	車輪	$20.50 美元	4	2016 年 3 月 1 日
3	門	$15	2	2016 年 3 月 15 日
4	引擎	$100	1	2016 年 3 月 20 日
5	總計	$135.5 美元	7	2016 年 3 月 20 日

讀取單一範圍

下列 spreadsheets.values.get敬上程式碼範例顯示如何讀取範圍 Sheet1!A1:D5 中的值回應結尾會省略空白的結尾列和欄。

要求通訊協定會顯示在這裡。

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5

回應由 ValueRange敬上物件說明範圍值。 majorDimension 欄位表示陣列是按資料列排列的值清單。

{
  "range": "Sheet1!A1:D5",
  "majorDimension": "ROWS",
  "values": [
    ["Item", "Cost", "Stocked", "Ship Date"],
    ["Wheel", "$20.50", "4", "3/1/2016"],
    ["Door", "$15", "2", "3/15/2016"],
    ["Engine", "$100", "1", "30/20/2016"],
    ["Totals", "$135.5", "7", "3/20/2016"]
  ],
}

讀取依資料欄分組的單一範圍

下列 spreadsheets.values.get敬上程式碼範例顯示如何讀取範圍 Sheet1!A1:D3 中的值但會按照資料欄分組結尾是空的列和欄省略。

要求通訊協定會顯示在這裡。

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS

回應由 ValueRange敬上物件說明範圍值。 majorDimension 欄位代表陣列是依資料欄整理的值清單。

{
  "range": "Sheet1!A1:D3",
  "majorDimension": "COLUMNS",
  "values": [
    ["Item", "Wheel", "Door"],
    ["Cost", "$20.50", "$15"],
    ["Stocked", "4", "2"],
    ["Ship Date", "3/1/2016", "3/15/2016"]
  ],
}

讀取含有轉譯選項的單一範圍

下列 spreadsheets.values.get敬上程式碼範例顯示如何讀取範圍 Sheet1!A1:D5 中的值但會使用轉譯選項來管理這項資訊。 ValueRenderOption設定 FORMULA 的引數表示系統將傳回公式，而非計算值，以及 DateTimeRenderOption 設定 SERIAL_NUMBER 表示要以數字的形式傳回日期。你也可以使用其他設定。結尾是空的列和欄省略。

要求通訊協定會顯示在這裡。

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?
            valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER

回應由 ValueRange敬上物件說明範圍值。 majorDimension 欄位表示陣列是按資料列排列的值清單。

{
  "range": "Sheet1!A1:D5",
  "majorDimension": "ROWS",
  "values": [
    ["Item", "Cost", "Stocked", "Ship Date"],
    ["Wheel", "$20.50", "4", "42430"],
    ["Door", "$15", "2", "42444"],
    ["Engine", "$100", "1", "42449"],
    ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
  ],
}

讀取多個範圍

下列 spreadsheets.values.batchGet敬上程式碼範例顯示如何讀取 Sheet1!B:B 和 Sheet1!D:D 和就會在回應中傳回這些物件 ValueRenderOption設定的 UNFORMATTED_VALUE 表示值經過計算，但未設定格式回應。結尾會省略空白的結尾列和欄。

要求通訊協定會顯示在這裡。

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
            ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS

這個方法呼叫的回應是由具有試算表 ID 的物件組成和 ValueRange敬上與每個要求範圍對應的物件，並依照。 majorDimension 欄位代表陣列是依資料欄整理的值清單。例如：

{
  "spreadsheetId": SPREADSHEET_ID,
  "valueRanges": [
    {
      "range": "Sheet1!B1:B1000",
      "majorDimension": "COLUMNS",
      "values": [
        ["Cost",20.5,15,100,135.5]
      ]
    },
    {
      "range": "Sheet1!D1:D1000",
      "majorDimension": "COLUMNS",
      "values": [
        ["Ship Date",42430,42444,42449,42449]
      ]s
    }
  ]
}

讀取多份工作表中的多個範圍

下列 spreadsheets.values.batchGet敬上程式碼範例顯示如何讀取工作表 Sheet1!A1:D5 中的範圍值 Product!D1:D100 和 Sales!E4:F6，並在回應中傳回。 ValueRenderOption設定的 UNFORMATTED_VALUE 表示值經過計算，但未設定格式回應。結尾會省略空白的結尾列和欄。

要求通訊協定會顯示在這裡。

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
            ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS

{
  "spreadsheetId": SPREADSHEET_ID,
  "valueRanges": [
    {
      "range": "Sheet1!A1:D5",
      "majorDimension": "COLUMNS",
      "values": [
        [...],
        [...]
      ]
    },
    {
      "range": "Products!D1:D100",
      "majorDimension": "COLUMNS",
      "values": [
        [...]
      ]
    },
    {
      "range": "Sales!E4:F6",
      "majorDimension": "COLUMNS",
      "values": [
        [...],
        [...]
      ]
    }
  ]
}