tipo de recurso driveItem
Namespace: microsoft.graph
O recurso DriveItem representa um arquivo, pasta ou outro item armazenado em uma unidade.
Todos os objetos do sistema de arquivos no OneDrive e no SharePoint são retornados como recursos driveItem. Os itens nas bibliotecas de documentos do Microsoft Office SharePoint Online podem ser representados como recursos listItem ou driveItem.
Há duas maneiras principais de endereçar um recurso driveItem:
- Pelo identificador exclusivo de driveItem usando
drive/items/{item-id} - Usando o caminho do sistema de arquivos
/drive/root:/path/to/file
Para obter mais informações, consulte o endereçamento de ItensDaUnidade.
Os recursos de driveItem têm facetas modeladas como propriedades que fornecem dados sobre as identidades e recursos do driveItem. Por exemplo:
- As pastas têm uma faceta de pasta
- Os arquivos têm uma faceta de arquivo.
- Imagens têm uma faceta image além das facetas file.
- Imagens obtidas com uma câmera (fotos) se comportam como uma faceta photo que identifica o item como uma foto e fornece as propriedades de quando a foto foi tirada e com qual dispositivo.
Itens com a faceta folder atuam como contêineres de itens e, portanto, têm uma referência children apontando para um conjunto de driveItems na pasta.
Nota: Em OneDrive for Business ou bibliotecas de documentos do SharePoint, a propriedade cTag não será retornada, se o driveItem tiver uma faceta de pasta.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Obter item | driveItem | Recupere os metadados de um driveItem em uma unidade. |
| Obter análises | itemAnalytics | Obter análises para este recurso. |
| Obter atividades por intervalo | itemActivityStat | Obter uma coleção de itemActivityStats dentro do intervalo de tempo especificado. |
| Listar secundários | Coleção de driveItem | Retorne uma coleção de driveItems na relação filho de um driveItem. |
| Listar versões | coleção driveItemVersion | Recupere as versões de um arquivo na unidade do usuário atual. |
| Criar item | driveItem | Crie um driveItem na unidade especificada. |
| Atualizar item | driveItem | Atualize um driveItem na unidade. |
| Carregar conteúdo | driveItem | Carregue conteúdo no driveItem. |
| Baixar conteúdo | URL de download | Baixe o conteúdo de um driveItem. |
| Baixar o formato de arquivo específico | URL de download | Baixe o conteúdo de um driveItem com um formato específico. |
| Excluir item | Nenhum | Exclua um driveItem. |
| Item PermanentDelete | Nenhum | Exclua permanentemente um driveItem usando sua ID. |
| Mover item | driveItem | Mover um driveItem para um novo item pai. |
| Copiar item | detalhes sobre como monitorar o progresso da cópia | Crie uma cópia de um driveItem (incluindo todas as crianças). |
| Pesquisar itens | Coleção driveItem | Pesquise a hierarquia de itens para itens que correspondam a uma consulta. |
| Listar alterações em uma unidade | link delta | Listar quaisquer alterações na unidade. |
| Seguir o item | driveItem | Siga um driveItem. |
| Deixar de seguir o item | Nenhum | Unfollow a driveItem. |
| Listar miniaturas | Coleção driveItem | Liste driveItems com suas miniaturas. |
| Criar link de compartilhamento | link de compartilhamento | Crie um link para compartilhar o driveItem. |
| Adicionar permissões | Coleção permission | Envie um convite de compartilhamento para um usuário. |
| Listar permissões | Coleção permission | Recupere a coleção de permissões em um driveItem. |
| Excluir permissão | Nenhum | Remova a permissão do driveItem. |
| Obter canal WebSocket | assinatura | Receba notificações de alteração quase em tempo real para uma unidade usando socket.io. |
| Item de visualização | objeto json | Obtenha URLs incorporáveis de curta duração para um item de modo a renderizar uma visualização temporária. |
| Fazer ceck-in | Nenhum | Faça check-in em um recurso driveItem verificado, que disponibiliza a versão do documento para outras pessoas. |
| Fazer check-out | Nenhum | Confira um recurso driveItem para impedir que outras pessoas editem o documento e impeça que suas alterações fiquem visíveis até que o documentado seja verificado. |
| Extrair rótulos de confidencialidade | extractSensitivityLabelsResult | Extraia um ou mais rótulos de confidencialidade atribuídos a um item de unidade e atualize os metadados de um item de unidade com os detalhes mais recentes do rótulo atribuído. |
| Atribuir rótulo de confidencialidade | Cadeia de caracteres | Atribuir assíncronamente um rótulo de confidencialidade a um driveItem. |
| Obter rótulo de retenção | itemRetentionLabel | Obtenha informações de metadados para um rótulo de retenção aplicado em um driveItem. |
| Definir rótulo de retenção | itemRetentionLabel | Aplicar (definir) um rótulo de retenção em um driveItem (arquivos e pastas). |
| Remover rótulo de retenção | Nenhum | Remova um rótulo de retenção de um driveItem. |
| Bloquear ou desbloquear registro | itemRetentionLabel | Bloquear ou desbloquear um rótulo de retenção em um driveItem que classifica o conteúdo como registros. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| audio | audio | Metadados de áudio, se o item for um arquivo de áudio. Somente leitura. Somente leitura. Somente no OneDrive Personal. |
| pacote | Agrupar | Agrupar os metadados, se o item for um pacote. Somente leitura. |
| conteúdo | Fluxo | O fluxo de conteúdo, se o item representar um arquivo. |
| createdBy | identitySet | Identidade do usuário, dispositivo e aplicativo que criou o item. Somente leitura. |
| createdDateTime | DateTimeOffset | Data e hora de criação do item. Somente leitura. |
| cTag | String | Uma eTag para o conteúdo do item. Essa eTag não será alterada se apenas os metadados forem alterados. Nota Essa propriedade não será retornada se o item for uma pasta. Somente leitura. |
| deleted | deleted | Informações sobre o estado excluído do item. Somente leitura. |
| description | String | Fornece uma descrição do item visível para o usuário. Leitura e gravação. Somente no OneDrive Personal. |
| eTag | String | eTag para o item inteiro (metadados + conteúdo). Somente leitura. |
| file | file | Metadados de arquivo, se o item for um arquivo. Somente leitura. |
| fileSystemInfo | fileSystemInfo | Informações do sistema de arquivos no cliente. Leitura e gravação. |
| folder | folder | Metadados de pasta, se o item for uma pasta. Somente leitura. |
| id | String | O identificador exclusivo do item na Unidade. Somente leitura. |
| imagem | image | Metadados de imagem, se o item for uma imagem. Somente leitura. |
| lastModifiedBy | identitySet | Identidade do usuário, dispositivo e aplicativo que modificou o item pela última vez. Somente leitura. |
| lastModifiedDateTime | DateTimeOffset | Data e hora em que o item foi modificado pela última vez. Somente leitura. |
| location | geoCoordinates | Metadados de localização, se o item tiver dados de localização. Somente leitura. |
| malware | malware | Metadados de malware, se o item for detectado como contendo malware. Somente leitura. |
| name | String | O nome do item (nome do arquivo e extensão). Leitura e gravação. |
| pacote | package | Se presente, indica que esse item é um pacote, e não uma pasta ou um arquivo. Pacotes são tratados como arquivos em alguns contextos e como pastas em outros. Somente leitura. |
| parentReference | itemReference | Informações do pai, se o item tiver um pai. Leitura e gravação. |
| pendingOperations | pendingOperations | Se houver, indica que uma ou mais operações que podem afetar o estado da driveItem estão pendentes. Somente leitura. |
| photo | photo | Metadados de foto, se o item for uma foto. Somente leitura. |
| publication | publicationFacet | Fornece informações sobre o estado de publicação ou de check-out de um item, nos locais que oferecem suporte a essas ações. Essa propriedade não é retornada por padrão. Somente leitura. |
| remoteItem | remoteItem | Dados do item remoto, se o item for compartilhado de uma unidade diferente daquela que está sendo acessada. Somente leitura. |
| root | root | Se essa propriedade for não nula, indicará que o driveItem é o principal driveItem na unidade. |
| searchResult | searchResult | Metadados de pesquisa, se o item for de um resultado de pesquisa. Somente leitura. |
| shared | compartilhado | Indica que o item foi compartilhado com outras pessoas e fornece informações sobre o estado compartilhado do item. Somente leitura. |
| sharepointIds | sharepointIds | Retorna os identificadores úteis para fins de compatibilidade do REST do SharePoint. Somente leitura. |
| size | Int64 | O tamanho do item em bytes. Somente leitura. |
| specialFolder | specialFolder | Se o item atual também estiver disponível como uma pasta especial, essa faceta será retornada. Somente leitura. |
| video | video | Metadados de vídeo, se o item for um vídeo. Somente leitura. |
| webDavUrl | String | URL compatível com WebDAV para o item. |
| webUrl | String | URL que exibe o recurso no navegador. Somente leitura. |
Observação: As propriedades eTag e cTag funcionam de maneira diferente em contêineres (pastas). O valor de cTag é modificado quando o conteúdo ou os metadados de qualquer descendente da pasta são alterados. O valor de eTag é modificado apenas quando as propriedades da pasta são alteradas, exceto para propriedades derivadas de descendentes (como childCount ou lastModifiedDateTime).
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| activities | Conjunto itemActivity | A lista de atividades recentes que ocorreram neste item. |
| análise | recurso itemAnalytics | Análise sobre as atividades de visualização que ocorreram neste item. |
| children | coleção driveItem | Coleção que contêm objetos Item para os filhos imediatos do Item. Somente os itens que representam pastas têm filhos. Somente leitura. Anulável. |
| createdByUser | user | A identidade do usuário que criou o item. Somente leitura. |
| lastModifiedByUser | user | A identidade do usuário que modificou o item pela última vez. Somente leitura. |
| listItem | listItem | Para unidades no SharePoint, o item da lista da biblioteca de documentos associado. Somente leitura. Anulável. |
| permissões | Coleção permission | O conjunto de permissões do item. Somente leitura. Anulável. |
| retentionLabel | itemRetentionLabel | Informações sobre o rótulo de retenção e as configurações impostas no driveItem. Leitura e gravação. |
| assinaturas | conjunto de assinaturas | O conjunto de assinaturas no item. Compatível somente na raiz de uma unidade. |
| miniaturas | Coleção thumbnailSet | Coleção de objetos thumbnailSet associados ao item. Para obter mais informações, confira como obter miniaturas. Somente leitura. Anulável. |
| versões | coleção driveItemVersion | A lista de todas as versões anteriores do item. Para saber mais, confira as informações sobre a obtenção de versões anteriores. Somente leitura. Anulável. |
| pasta de trabalho | pasta de trabalho | Para arquivos que são planilhas do Excel, acesse a API da pasta de trabalho para trabalhar com o conteúdo da planilha. Anulável. |
Atributos de instância
Atributos de instância são propriedades com comportamentos especiais. Essas propriedades são temporárias e definem o comportamento que o serviço deve executar ou fornecer valores de propriedade de curto prazo, como uma URL de download para um item que expira.
| Nome da propriedade | Tipo | Descrição |
|---|---|---|
| @microsoft.graph.conflictBehavior | string | O comportamento de resolução de conflitos para ações que criam um novo item. Você pode usar os valores fail, replace ou rename. O padrão para PUT é replace. Um item nunca é retornado com essa anotação. Somente gravação. |
| @microsoft.graph.downloadUrl | string | Uma URL que pode ser usada para baixar conteúdo desse arquivo. A autenticação não é necessária com essa URL. Somente leitura. |
| @microsoft.graph.sourceUrl | string | Essa anotação de instância pode ser usada para instruir o serviço a baixar o conteúdo da URL ao emitir uma solicitação PUT e armazená-la como o arquivo. Somente gravação. |
Observações: O parâmetro
@microsoft.graph.conflictBehaviordeve ser incluído no URL em vez do corpo da solicitação.O valor
@microsoft.graph.downloadUrlé um URL de curta duração e não pode ser armazenado em cache. A URL é invalidada após um curto período de tempo (1 hora). Remover permissões de arquivo para um usuário pode não invalidar imediatamente o URL.O uso da
@microsoft.graph.sourceUrlpropriedade para carregamento de arquivo não é compatível no OneDrive for Business, SharePoint Online e SharePoint Server 2016.
Representação JSON
A representação JSON a seguir mostra o tipo de recurso.
O recurso driveItem é derivado de baseItem e herda propriedades desse recurso.
{
"audio": { "@odata.type": "microsoft.graph.audio" },
"bundle": { "@odata.type": "microsoft.graph.bundle" },
"content": { "@odata.type": "Edm.Stream" },
"cTag": "string (etag)",
"deleted": { "@odata.type": "microsoft.graph.deleted"},
"description": "string",
"file": { "@odata.type": "microsoft.graph.file" },
"fileSystemInfo": { "@odata.type": "microsoft.graph.fileSystemInfo" },
"folder": { "@odata.type": "microsoft.graph.folder" },
"image": { "@odata.type": "microsoft.graph.image" },
"location": { "@odata.type": "microsoft.graph.geoCoordinates" },
"malware": { "@odata.type": "microsoft.graph.malware" },
"package": { "@odata.type": "microsoft.graph.package" },
"pendingOperations": { "@odata.type": "microsoft.graph.pendingOperations" },
"photo": { "@odata.type": "microsoft.graph.photo" },
"publication": {"@odata.type": "microsoft.graph.publicationFacet"},
"remoteItem": { "@odata.type": "microsoft.graph.remoteItem" },
"root": { "@odata.type": "microsoft.graph.root" },
"searchResult": { "@odata.type": "microsoft.graph.searchResult" },
"shared": { "@odata.type": "microsoft.graph.shared" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"size": 1024,
"specialFolder": { "@odata.type": "microsoft.graph.specialFolder" },
"video": { "@odata.type": "microsoft.graph.video" },
"webDavUrl": "string",
/* relationships */
"activities": [{"@odata.type": "microsoft.graph.itemActivity"}],
"analytics": {"@odata.type": "microsoft.graph.itemAnalytics"},
"children": [{ "@odata.type": "microsoft.graph.driveItem" }],
"createdByUser": { "@odata.type": "microsoft.graph.user" },
"itemRetentionLabel": [{ "@odata.type": "microsoft.graph.itemRetentionLabel" }],
"lastModifiedByUser": { "@odata.type": "microsoft.graph.user" },
"permissions": [ {"@odata.type": "microsoft.graph.permission"} ],
"subscriptions": [ {"@odata.type": "microsoft.graph.subscription"} ],
"thumbnails": [ {"@odata.type": "microsoft.graph.thumbnailSet"}],
"versions": [ {"@odata.type": "microsoft.graph.driveItemVersion"}],
/* inherited from baseItem */
"createdBy": {"@odata.type": "microsoft.graph.identitySet"},
"createdDateTime": "String (timestamp)",
"eTag": "string",
"id": "string (identifier)",
"lastModifiedBy": {"@odata.type": "microsoft.graph.identitySet"},
"lastModifiedDateTime": "String (timestamp)",
"name": "string",
"parentReference": {"@odata.type": "microsoft.graph.itemReference"},
"webUrl": "string",
/* instance annotations */
"@microsoft.graph.conflictBehavior": "string",
"@microsoft.graph.downloadUrl": "url",
"@microsoft.graph.sourceUrl": "url"
}
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de