Mover um DriveItem para uma nova pasta

Para mover um DriveItem para um novo item pai, o aplicativo solicita a atualização de parentReference do DriveItem a ser movido.

Este é um caso especial do método Update. O aplicativo pode combinar a movimentação de um item para um novo contêiner e a atualização de outras propriedades do item em uma única solicitação.

Não é possível mover itens entre Unidades usando esta solicitação.

Permissões

Uma das permissões a seguir é necessária para chamar essa API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Files.ReadWrite, Files.ReadWrite.All, Sites.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Files.ReadWrite, Files.ReadWrite.All
Aplicativo	Files.ReadWrite.All, Sites.ReadWrite.All

Solicitação HTTP

PATCH /drives/{drive-id}/items/{item-id}
PATCH /groups/{group-id}/drive/{item-id}
PATCH /me/drive/items/{item-id}
PATCH /sites/{site-id}/drive/items/{item-id}
PATCH /users/{user-id}/drive/items/{item-id}

Cabeçalhos de solicitação opcionais

Nome	Tipo	Descrição
if-match	String	Se este cabeçalho de solicitação estiver incluso e a eTag (ou cTag) fornecida corresponder à eTag atual da pasta, uma resposta 412 Precondition Failed será exibida.

Corpo da solicitação

No corpo da solicitação, forneça o novo valor para a propriedade parentReference. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para obter um melhor desempenho, não inclua valores existentes que não foram alterados.

Observação: Ao mover itens para a raiz de uma unidade, seu aplicativo não pode usar a sintaxe "id:" "root". Seu aplicativo precisa fornecer a ID real da pasta raiz para referência do pai.

Resposta

Se bem-sucedido, este método retorna um código de resposta 200 OK e o recurso DriveItem atualizado no corpo da resposta.

Exemplo

Este exemplo move um item especificado por {item-id} para uma pasta na unidade do usuário com a ID new-parent-folder-id.

PATCH /me/drive/items/{item-id}
Content-type: application/json

{
  "parentReference": {
    "id": "{new-parent-folder-id}"
  },
  "name": "new-item-name.txt"
}

Resposta

O exemplo a seguir mostra a resposta para este pedido de movimentação.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "0123456789abc",
  "name": "new-item-name.txt",
  "parentReference":
  {
    "driveId": "11231001",
    "path": "/drive/root:/Documents",
    "id": "1231203102!1011"
  }
}

Respostas de erros

Confira mais informações sobre como os erros são retornados em Respostas de Erros.