Ресурсы URI для интерфейса API REST служб Excel
Непосредственно с помощью API-Интерфейс REST в Службы Excel можно связать сущности.
Примечание.
REST API служб Excel применим к локальным развертываниям SharePoint и SharePoint 2016. Для учетных записей Office 365 для образования, Office 365 бизнес и Office 365 корпоративный используйте REST API Excel, входящие в состав конечной точки Microsoft Graph.
URL-адрес базовый REST
Ниже приведен пример URL-адреса REST конкретного элемента в книге.
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>
Относительный URL-адрес REST зависит от базовый URL-адрес REST. Ниже приведен пример базовый URL-адрес REST для конкретной книги.
http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>
Например, если у вас есть книгу с именем «sampleWorkbook.xlsx» в библиотеке документов, следующие:
http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx
Это базовый URL-адрес REST в книге:
http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx
Универсальные коды ресурсов
В таблице 1 приведены всех доступных ресурсах в Службы Excel API-интерфейса REST. Для доступа к определенному ресурсу, добавьте расположение ресурсов базовый URL-адрес REST в книгу.
Таблица 1. Ресурсы со специальными возможностями в REST API службы Excel
| Расположение ресурсов | Формат | Пример | Примечания |
|---|---|---|---|
| / модель |
Atom (по умолчанию) |
/ модель |
Возвращает канала с ресурсами, поддерживаемый Службы Excel API-Интерфейс REST Atom. Поддерживаемые ресурсы, диапазоны, диаграмм, таблиц и сводных таблиц. |
| аудио- и модель |
workbook |
аудио- и модель? $format = книги |
Это рабочей книги. Поддерживаемые книги форматов, xlsx, xlsb и xlsm. |
| / модели/диапазонов |
Atom (по умолчанию) |
Диапазоны/модели /? $format = atom |
Веб-канала Atom, listis всех именованных диапазонов в книге. |
| /Model/Ranges('[name]') |
HTML (по умолчанию) |
/model/Ranges('MyRange')?$format=html |
Фрагмент HTML-кода для запрошенного диапазона. |
| /Model/Ranges('[name]') |
Atom |
/model/Ranges('MyRange')?$format=atom |
Запись Atom, содержащий XML-представление данных в диапазоне. |
| / модели/диаграмм |
Atom (по умолчанию) |
Диаграммы/модели /? $format = atom |
Канала Atom, в котором приведены все диаграммы в книге. |
| /Model/Charts('[name]') |
Изображение (по умолчанию) |
/model/Charts('MyChart')?$format=image |
Изображение диаграммы. Это изображение в формате Portable Network Graphics (PNG). |
| / модели/таблиц |
Atom (по умолчанию) |
Таблицы/модели /? $format = atom |
Канала Atom, который перечисляет все таблицы, доступные в книге. |
| /Model/Tables('[name]') |
HTML (по умолчанию) |
/model/Tables('MyTable')?$format=html |
Фрагмент HTML-кода для запрошенного таблицы. |
| /Model/Tables('[name]') |
Atom |
/model/Tables('MyTable')?$format=atom |
Запись Atom, содержащий XML-представление данных в таблице. |
| /model/PivotTables |
Atom (по умолчанию) |
/model/PivotTables?$format=atom |
Канала Atom, в котором приведены все доступные сводных таблиц в книге |
| /model/PivotTables('[Имя]') |
HTML (по умолчанию) |
/model/PivotTables('MyPivotTable)?$format=html |
Фрагмент HTML-кода для запрошенного сводных таблиц. |
| /model/PivotTables('[Имя]') |
Atom |
/model/PivotTables('MyPivotTable')?$format=atom |
Запись Atom, содержащий XML-представление данных в сводных таблицах. |
Примечание.
[!Примечание] Службы Excel ограничивает количество диапазоны, которые можно включить в URL-адрес для 10. При наличии более 10 диапазонов в URL-адрес, вы получите сообщение о том, что служба недоступна.