获取表格数据

本接口用于获取指定范围内的在线表格信息，单次查询的范围大小需满足以下限制：

1. 查询范围行数 <=1000
2. 查询范围列数 <=200
3. 范围内的总单元格数量 <=10000

请求方式：POST（HTTPS）
请求地址: https://qyapi.weixin.qq.com/cgi-bin/wedoc/spreadsheet/get_sheet_range_data?access_token=ACCESS_TOKEN

请求包体

{
	"docid": "DOCID",
	"sheet_id": "AABBCC",
	"range": "A1:B2"
}

参数说明

权限说明

• 自建应用需配置到“可调用应用”列表中的应用secret所获取的accesstoken来调用（accesstoken如何获取？）
• 第三方应用需具有“文档”权限
• 代开发自建应用需具有“文档”权限

返回示例

{
	"errcode": 0,
	"errmsg": "ok",
	"data": {
		"result": {
			
		}
	}
}

参数说明

参数详细说明

由于返回结果比较复杂，在本节分Object分别说明

GridData

GridData定义了表格的具体数据内容

示例

{
	"start_row": 1,
	"start_column": 1,
	"rows": [
		{}, {}
	]
}

RowData

行数据的资源描述

示例

{
	"values": [
		{}, {}
	]
}

CellData

单元格的信息

示例

{
	"cell_value": {},
	"cell_format": {}
}

CellValue

单元格的数据内容，暂时只支持文本、链接，一个CellValue中只能选填一个字段

示例

{
		"text": "hello world"
}

{
	"link": {
		"text": "hello world",
		"url": "http://xxxx.com"
	}
}

CellFormat

单元格的样式信息

示例

{
	"text_format": {}
}

TextFormat

文本样式信息

示例

{
	"font": "Courier New",
	"font_size": 14,
	"bold": false, 
	"italic": false,
	"strikethrough": false,
	"underline": false,
	"color": {}
}

Color

颜色信息，采用 RGBA 表示法

示例

{
	"red": 0,
	"green": 0,
	"blue": 255,
	"alpha": 255
}

Link

超链接的相关信息

示例

{
	"url": "https://xxxx",
	"text": "Website"
}

Dimension

声明维度属性为行或者列的字符串枚举值

其他

A1表示法

A1 表示法 是比较常见的范围表格数据引用的表示方法，可以表示一个左上角坐标到右下角坐标之间的连续区域。示例：

字体列表

在线表格api支持开发者设置单元格内的字体，以下是可供选择的字体列表：

• Microsoft YaHei
• SimSun
• SimHei
• FangSong
• KaiTi
• DFKai-SB
• STFangsong
• STKaiti
• STSong
• NSimSun
• Microsoft JhengHei
• PMingLiU
• Arial
• Times New Roman
• Calibri
• Comic Sans MS
• Courier New
• Georgia
• Microsoft Uighur
• Impact
• Trebuchet MS
• Verdana
• Aharoni
• Andalus
• AngsanaUPC
• Angsana New
• Aparajita
• Arabic Typesetting
• Arial Black
• Arial Narrow
• Batang
• BatangChe
• Bookman Old Style
• Book Antiqua
• Bradley Hand ITC
• BrowalliaUPC
• Browallia New
• Cambria
• Cambria Math
• Candara
• Century
• Century Gothic
• Consolas
• Constantia
• Corbel
• CordiaUPC
• Cordia New
• DaunPenh
• David
• DilleniaUPC
• DokChampa
• Dotum
• DotumChe
• Ebrima
• Estrangelo Edessa
• EucrosiaUPC
• Euphemia
• Franklin Gothic
• Franklin Gothic Medium
• FrankRuehl
• FreesiaUPC
• Freestyle Script
• French Script MT
• Gabriola
• Gadugi
• Garamond
• Gisha
• Gulim
• GulimChe
• Gungsuh
• GungsuhChe
• Haettenschweiler
• IrisUPC
• Iskoola Pota
• JasmineUPC
• Juice ITC
• Kalinga
• Kartika
• Khmer UI
• KodchiangUPC
• Kokila
• Kristen ITC
• Lao UI
• Latha
• Leelawadee
• Levenim MT
• LilyUPC
• Lucida Console
• Lucida Handwriting
• Lucida Sans Unicode
• Malgun Gothic
• Mangal
• Marlett
• Meiryo
• Meiryo UI
• Microsoft Himalaya
• Microsoft JhengHei UI
• Microsoft JhengHei UI Light
• Microsoft New Tai Lue
• Microsoft PhagsPa
• Microsoft Sans Serif
• Microsoft Tai Le
• Microsoft YaHei UI
• Microsoft YaHei UI Light
• Microsoft Yi Baiti
• MingLiU-ExtB
• MingLiU_HKSCS-ExtB
• MingLiU_HKSCS
• Miriam
• Miriam Fixed
• Mistral
• Mongolian Baiti
• Monotype.com
• Monotype Corsiva
• MoolBoran
• MS Gothic
• MS Mincho
• MS Outlook
• MS PGothic
• MS PMincho
• MS UI Gothic
• MT Extra
• MV Boli
• Narkisim
• Nirmala UI
• Nyala
• Palatino Linotype
• Papyrus
• Plantagenet Cherokee
• PMingLiU-ExtB
• Pristina
• Raavi
• Rod
• Sakkal Majalla
• Segoe Print
• Segoe Script
• Segoe UI Symbol
• Shonar Bangla
• Shruti
• Simplified Arabic Fixed
• Sylfaen
• Symbol
• Tahoma
• Tempus Sans ITC
• Traditional Arabic
• Tunga
• Utsaah
• Vani
• Vijaya
• Vrinda
• Webdings
• Wingdings