Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Obtenha uma coleção de recursos thumbnailSet para um recurso driveItem .
Zero ou mais recursos thumbnailSet podem representar um driveItem.
Cada thumbnailSet pode ter um ou mais objetos thumbnail, que são imagens que representam o item.
Por exemplo, um thumbnailSet podem incluir objetos thumbnail, como objetos comuns que incluem small, medium ou large.
Existem várias formas de trabalhar com miniaturas no OneDrive. Veja a seguir as mais comuns:
- Enumerar miniaturas disponíveis para um item
- Recuperar uma única miniatura para um item
- Recuperar o conteúdo da miniatura
- Recuperar miniaturas de vários itens em uma única solicitação
- Recuperar tamanhos personalizados de miniaturas
- Carregar uma miniatura personalizada para um item
- Determinar se uma miniatura personalizada carregada existe
Esta API está disponível nas seguintes implementações de cloud nacionais.
| Serviço global | US Government L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissões
Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.
| Tipo de permissão | Permissões com menos privilégios | Permissões com privilégios superiores |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Files.Read | Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) | Files.Read | Files.Read.All, Files.ReadWrite, Files.ReadWrite.All |
| Application | Files.Read.All | Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All |
Observação
O SharePoint Embedded requer a FileStorageContainer.Selected permissão para aceder ao conteúdo do contentor. Esta permissão é diferente das mencionadas anteriormente. Além das permissões do Microsoft Graph, a sua aplicação tem de ter as permissões de tipo de contentor necessárias para chamar esta API. Para obter mais informações, veja Autorização e autenticação do SharePoint Embedded.
Solicitação HTTP
GET /drives/{drive-id}/items/{item-id}/thumbnails
GET /groups/{group-id}/drive/items/{item-id}/thumbnails
GET /me/drive/items/{item-id}/thumbnails
GET /sites/{site-id}/drive/items/{item-id}/thumbnails
GET /users/{user-id}/drive/items/{item-id}/thumbnails
Parâmetros de consulta opcionais
Este método suporta o $selectparâmetro de consulta OData para personalizar a resposta.
Além disso, este método suporta a obtenção da miniatura com o valor EXIF de orientação original e sem a rotação aplicada ao acrescentar o originalOrientation=true parâmetro de consulta.
Atualmente, só é suportada no OneDrive Pessoal.
Resposta
Se for bem-sucedido, esse método retornará um código de resposta 200 OK e uma coleção de objetos ThumbnailSet no corpo da resposta.
Exemplo
O exemplo seguinte mostra um pedido que obtém as miniaturas disponíveis para um item no OneDrive do utilizador atual.
GET /me/drive/items/{item-id}/thumbnails
Devolve uma matriz de thumbnailSets disponíveis para o item. Qualquer item em uma unidade pode ter zero ou mais miniaturas.
Observação: Você pode usar o parâmetro da cadeia de caracteres de consulta select para controlar quais tamanhos de miniatura são retornados no ThumbnailSet.
Por exemplo, /thumbnails?select=medium recupera somente miniaturas de tamanho médio.
Resposta
O exemplo a seguir mostra a resposta.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "0",
"small": { "height": 64, "width": 96, "url": "https://sn3302files..."},
"medium": { "height": 117, "width": 176, "url": "https://sn3302files..."},
"large": { "height": 533, "width": 800, "url": "https://sn3302files..."}
}
]
}
Obter uma única miniatura
Recupere os metadados de uma única miniatura e tamanho tratando-os diretamente em uma solicitação.
Solicitação HTTP
GET /me/drive/items/{item-id}/thumbnails/{thumb-id}/{size}
Parâmetros do caminho
| Nome | Tipo | Descrição |
|---|---|---|
| item-id | string | O identificador exclusivo do item referenciado. |
| thumb-id | number | O índice da miniatura, geralmente de 0 a 4. Se existir uma miniatura personalizada, o respetivo índice é 0. |
| size | string | O tamanho da miniatura solicitada. Pode ser um dos tamanhos padrão listados abaixo ou um tamanho personalizado. |
HTTP/1.1 200 OK
Content-Type: application/json
{
"width": 100,
"height": 100,
"url": "https://onedrive.com/asd123a/asdjlkasjdkasdjlk.jpg"
}
Recuperar o conteúdo binário da miniatura
Você pode recuperar diretamente o conteúdo da miniatura solicitando a propriedade content dessa miniatura.
Solicitação HTTP
GET /me/drive/items/{item-id}/thumbnails/{thumb-id}/{size}/content
Resposta
O serviço responde com um redirecionamento para a URL da miniatura.
HTTP/1.1 302 Found
Location: https://b0mpua-by3301.files.1drv.com/y23vmagahszhxzlcvhasdhasghasodfi
URLs de miniaturas são seguras em cache. O URL é alterado se o item for alterado de uma forma que exija a geração de uma nova miniatura.
Obter miniaturas ao listar driveItems
Se estiver a obter uma lista de recursos driveItem a apresentar, pode utilizar o parâmetro $expand cadeia de consulta para incluir também as miniaturas desses recursos. Permite que a sua aplicação obtenha miniaturas e itens num único pedido, em vez de emitir muitos pedidos.
Solicitação HTTP
GET /me/drive/items/{item-id}/children?$expand=thumbnails
Resposta
As respostas do serviço com a lista de DriveItems e suas miniaturas.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "182331E8-2788-4932-B52A-A6550577043F",
"name": "my photo.jpg",
"thumbnails": [
{
"small": { "width": 96,
"height": 96,
"url": "https://sn3302files..."
}
}
]
},
{
"id": "2D223953-A56B-4D9B-ADF3-13E7820673A2",
"name": "presentation.pptx",
"thumbnails": [
{
"small": { "width": 96,
"height": 96,
"url": "https://sn3302files..."
}
}
]
}
]
}
Valores de tamanho
Essa tabela define os possíveis tamanhos de miniaturas. Embora você possa solicitar qualquer tamanho de miniatura arbitrário, os valores definidos provavelmente existem e retornam um valor rapidamente:
| Nome | Resolução | Taxa de proporção | Descrição |
|---|---|---|---|
small |
96 mais longa | Original | Miniatura pequena e altamente compactada, recortada em uma taxa de proporção quadrada. |
medium |
176 mais longa | Original | Recortada no tamanho do item padrão para o modo de exibição de Web do OneDrive. |
large |
800 mais longa | Original | Miniatura com a borda mais longa redimensionada para 800 pixels. |
smallSquare |
96x96 | Corte quadrado | Miniatura quadrada pequena |
mediumSquare |
176x176 | Corte quadrado | Miniatura quadrada pequena |
largeSquare |
800x800 | Corte quadrado | Miniatura quadrada grande |
Solicitar tamanhos personalizados de miniaturas
Além dos tamanhos definidos, seu aplicativo pode solicitar um tamanho personalizado de miniatura, especificando as dimensões da miniatura prefixadas com c.
Por exemplo, se o seu aplicativo precisar de miniaturas de 300 x 400, é possível solicitar esse tamanho desta forma:
GET /me/drive/items/{item-id}/thumbnails?select=c300x400_crop
Que responde com o tamanho de miniatura personalizado selecionado:
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "0",
"c300x400_crop": { "height": 300, "width": 400, "url": "https://sn3302files.onedrive.com/123"},
}
]
}
Você pode especificar as seguintes opções após o tamanho de miniatura solicitado:
Exemplos de identificadores personalizados
| Identificador de miniatura | Resolução | Taxa de proporção | Descrição |
|---|---|---|---|
| c300x400 | Limitado por uma caixa de 300 x 400 | Original | Gere uma miniatura que se ajuste em uma caixa de 300 x 400 pixels, mantendo a taxa de proporção |
| c300x400_crop | 300x400 | Recortada | Gere uma miniatura de 300 x 400 pixels. Funciona redimensionando a imagem para preencher a caixa 300x400 e recortar o que quer que seja derramado fora da caixa. |
Nota: A miniatura devolvida pode não corresponder exatamente às dimensões de píxeis que foram pedidas, mas corresponde à proporção. Em alguns casos, uma miniatura maior do que a solicitada pode retornar, se a miniatura já existir, e pode ser facilmente dimensionada para coincidir com a resolução solicitada.
Comentários
Observação No OneDrive for Business e no SharePoint:
A utilização destas chamadas para expandir a coleção de miniaturas não funciona:
GET /drive/root:/{item-path}?expand=children(expand=thumbnails)GET /drive/items/{item-id}/children?expand=thumbnails
As miniaturas não são suportadas no SharePoint Server 2016.
Respostas de erros
Veja Respostas de erros para obter mais informações sobre como os erros são devolvidos.