Excel Services REST API のリソース URI
Excel Services の REST API を使用して直接エンティティにリンクできます。
注意
Excel Services REST API は、SharePoint および SharePoint 2016 オンプレミスに適用されます。Office 365 Education、Business、および Enterprise の各アカウントには、Microsoft Graph エンドポイントの一部である Excel REST API を使用します。
ベース REST URL
ブック内の特定の要素に対する REST URL の例を以下に示します。
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
相対 REST URL はベース REST URL に基づきます。特定のブックに対するベース REST URL の例を以下に示します。
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>
たとえば、次のドキュメント ライブラリに「sampleWorkbook.xlsx」という名前のブックがある場合、
http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
ブックに対するベース REST URL は次のとおりです。
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx
リソース URI
表 1 は、Excel Services の REST API にあるすべてのアクセス可能なリソースを示しています。特定のリソースにアクセスするには、ブックに対するベース REST URL の末尾にリソースの場所を付加します。
表 1. Excel Services の REST API でアクセス可能なリソース
リソースの場所 | フォーマット | 例 | 注意事項 |
---|---|---|---|
/model |
Atom (既定) |
/model |
Excel Services の REST API がサポートするリソースが付いた Atom フィードを返します。サポートされているリソースは、範囲、グラフ、表、ピボット テーブルです。 |
/model |
ブック |
/model?$format=workbook |
これはブックです。サポートするブックの形式は xlsx、xlsb、xlsm です。 |
/model/Ranges |
Atom (既定) |
/model/Ranges?$format=atom |
ブック内の名前付き範囲をすべて一覧表示する Atom フィードです。 |
/model/Ranges('[Name]') |
HTML (既定) |
/model/Ranges('MyRange')?$format=html |
要求された範囲の HTML フラグメントです。 |
/model/Ranges('[Name]') |
Atom |
/model/Ranges('MyRange')?$format=atom |
範囲内のデータの XML 表現を含む Atom エントリです。 |
/model/Charts |
Atom (既定) |
/model/Charts?$format=atom |
ブック内のグラフをすべて一覧表示する Atom フィードです。 |
/model/Charts('[Name]') |
Image (既定) |
/model/Charts('MyChart')?$format=image |
グラフのイメージです。イメージはポータブル ネットワーク グラフィックス (PNG) 形式です。 |
/model/Tables |
Atom (既定) |
/model/Tables?$format=atom |
ブックのすべての利用可能なテーブルを一覧表示する Atom フィードです。 |
/model/Tables('[Name]') |
HTML (既定) |
/model/Tables('MyTable')?$format=html |
要求されたテーブルの HTML フラグメントです。 |
/model/Tables('[Name]') |
Atom |
/model/Tables('MyTable')?$format=atom |
テーブル内のデータの XML 表現が含まれる Atom エントリです。 |
/model/PivotTables |
Atom (既定) |
/model/PivotTables?$format=atom |
ブック内に使用可能なピボットテーブルをすべて一覧表示する Atom フィードです。 |
/model/PivotTables('[Name]') |
HTML (既定) |
/model/PivotTables('MyPivotTable)?$format=html |
要求されたピボットテーブルの HTML フラグメントです。 |
/model/PivotTables('[Name]') |
Atom |
/model/PivotTables('MyPivotTable')?$format=atom |
ピボットテーブル内のデータの XML 表記が含まれる Atom エントリです。 |
注意
Excel Services は、URL に含めることのできる範囲の最大数を 10 に制限しています。 10 より多くの範囲を URL に含めると、サービスが使用できないことを示すエラーが表示されます。