Caminho e a estrutura básica do URI

Este tópico explica como construir a estrutura e o caminho do URI para comandos do serviço REST nos serviços do Serviços do Excel.

Observação

A API REST de serviços do Excel aplica-se ao SharePoint e SharePoint 2016 no local. Para contas do Office 365 Education, Business e Enterprise, use as APIs REAST do Excel que fazem parte do ponto de extremidade do Microsoft Graph.

Caminho e estrutura básicos do URI

A API REST em Excel Services oferece a capacidade para acessar recursos, como gráficos, tabelas dinâmicas, tabelas e intervalos nomeados em uma pasta de trabalho diretamente por meio de uma URL. Cada URL REST em Excel Services baseia-se de três partes. A seguir é a estrutura básica do URL para acessar os recursos em uma pasta de trabalho:

1. REST aspx URI da página O ponto de entrada para uma página. aspx
2. Local da pasta de trabalho O caminho para a pasta de trabalho
3. Localização do recurso O caminho para o recurso solicitado dentro da pasta de trabalho

A seguir é a construção da URL do REST para um elemento específico em uma pasta de trabalho:

http://<ServerName>/_vti_bin/ExcelRest.aspx/<DocumentLibrary>/<FileName>/<ResourceLocation>

A seguir está um exemplo da aparência de uma URL de restante no Excel Services com todos os três partes combinadas. Neste exemplo, a URL do REST está acessando uma pasta de trabalho chamada "sampleWorkbook.xlsx" que contém um quadro chamado "SampleChart":

http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('SampleChart')

A pasta de trabalho é armazenada em uma biblioteca de documentos. O caminho completo para o livro é http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx.

As três partes da URL REST são:

1. URI da Página REST aspx: http://<ServerName>/_vti_bin/ExcelRest.aspx
2. Local da pasta de trabalho: /Docs/Documents/sampleWorkbook.xlsx
3. Localização do recurso: /model/Ranges('nameOfTheNamedRange')

Acessando Usando a Interface do Usuário de Descoberta

Você também pode acessar o gráfico por meio da interface de usuário de descoberta. Para saber como aceder a recursos como gráficos, tabelas, tabelas dinâmicas e intervalos com o mecanismo de deteção apresentado na captura de ecrã seguinte, veja Deteção na API REST dos Serviços do Excel.

Caminho do Marcador

A seguir é a página aspx para o serviço REST no Excel Services:

http://<ServerName>/_vti_bin/ExcelRest.aspx

Para aceder ao serviço REST nos Serviços do Excel, tem de preceder o URL com http://<ServerName>/_vti_bin/ExcelRest.aspx.

Local do plano de trabalho

O local de pasta de trabalho é o caminho relativo para a pasta de trabalho tem recursos que você está interessado acessando. Por exemplo, suponha que você tenha uma pasta de trabalho denominada sampleWorkbook.xlsx, salvo em uma biblioteca de documentos confiável do SharePoint. Neste exemplo, o seguinte é o caminho até o local dos sampleWorkbook.xlsx:

http://<ServerName>/Docs/Documents/sampleWorkbook.xlsx

Você pode levar o caminho relativo para a pasta de trabalho ( Docs/Documents/sampleWorkbook.xlsx) e acrescentá-la para o caminho de marcador. A seguir é a URL com o local de caminho e a pasta de trabalho do marcador acrescentado:

http://<ServerName>/_vti_bin/ExcelRest.aspx

Local do Recurso

A localização do recurso é o caminho de pasta de trabalho para o elemento que você solicitar. Por exemplo, se quiser obter um gráfico, a localização do recurso será semelhante a /model/Charts('Chart 1').

Para a URL completa, você anexá-lo para o caminho de marcador e o caminho relativo para a pasta de trabalho. A seguir é a URL de exemplo completo:

http://<ServerName>/_vti_bin/ExcelRest.aspx/Docs/Documents/sampleWorkbook.xlsx/model/Charts('Chart 1')

Confira também

Conceitos

• Recursos URI para a API REST de serviços do Excel
• Descoberta na API de REST de serviços do Excel