Esta página foi traduzida pela API Cloud Translation.

REST Resource: files

Recurso: arquivo
- Representação JSON
  - Representação JSON
  - Representação JSON
- ContentRestriction
  - Representação JSON
Métodos

Recurso: arquivo

Os metadados de um arquivo.

Alguns métodos de recurso (como files.update) exigem um fileId. Use o método files.list para extrair o ID de um arquivo.

Representação JSON

Representação JSON
{ "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "exportLinks": { string: string, ... }, "parents": [ string ], "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "owners": [ { object (`User`) } ], "headRevisionId": string, "sharingUser": { object (`User`) }, "webViewLink": string, "webContentLink": string, "size": string, "viewersCanCopyContent": boolean, "permissions": [ { object (`Permission`) } ], "hasThumbnail": boolean, "spaces": [ string ], "folderColorRgb": string, "id": string, "name": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "createdTime": string, "modifiedTime": string, "modifiedByMeTime": string, "viewedByMeTime": string, "sharedWithMeTime": string, "quotaBytesUsed": string, "version": string, "originalFilename": string, "ownedByMe": boolean, "fullFileExtension": string, "properties": { string: value, ... }, "appProperties": { string: value, ... }, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeViewersCanCopyContent": boolean, "canMoveChildrenOutOfDrive": boolean, "canReadDrive": boolean, "canEdit": boolean, "canCopy": boolean, "canComment": boolean, "canAddChildren": boolean, "canDelete": boolean, "canDownload": boolean, "canListChildren": boolean, "canRemoveChildren": boolean, "canRename": boolean, "canTrash": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canMoveTeamDriveItem": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canMoveItemIntoTeamDrive": boolean, "canUntrash": boolean, "canModifyContent": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canDeleteChildren": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canTrashChildren": boolean, "canMoveItemOutOfDrive": boolean, "canAddMyDriveParent": boolean, "canRemoveMyDriveParent": boolean, "canMoveItemWithinDrive": boolean, "canShare": boolean, "canMoveChildrenWithinDrive": boolean, "canModifyContentRestriction": boolean, "canAddFolderFromAnotherDrive": boolean, "canChangeSecurityUpdateEnabled": boolean, "canAcceptOwnership": boolean, "canReadLabels": boolean, "canModifyLabels": boolean, "canModifyEditorContentRestriction": boolean, "canModifyOwnerContentRestriction": boolean, "canRemoveContentRestriction": boolean, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "thumbnailVersion": string, "trashedTime": string, "modifiedByMe": boolean, "permissionIds": [ string ], "imageMediaMetadata": { "flashUsed": boolean, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "width": integer, "height": integer, "location": { "latitude": number, "longitude": number, "altitude": number }, "rotation": integer, "time": string, "cameraMake": string, "cameraModel": string, "exposureTime": number, "aperture": number, "focalLength": number, "isoSpeed": integer, "exposureBias": number, "maxApertureValue": number, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "contentRestrictions": [ { object (`ContentRestriction`) } ], "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean }

{
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "permissionIds": [
    string
  ],
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}

Campos
`kind`	`string` Apenas saída. Identifica o tipo de recurso. Valor: a string fixa `"drive#file"`.
`driveId`	`string` Apenas saída. ID do drive compartilhado em que o arquivo está. Preenchido apenas para itens em drives compartilhados.
`fileExtension`	`string` Apenas saída. O componente final de `fullFileExtension`. Essa opção só está disponível para arquivos com conteúdo binário no Google Drive.
`copyRequiresWriterPermission`	`boolean` Se as opções de cópia, impressão ou download deste arquivo devem ser desativadas para leitores e comentaristas.
`md5Checksum`	`string` Apenas saída. A soma de verificação MD5 do conteúdo do arquivo. Isso só é aplicável a arquivos com conteúdo binário no Google Drive.
`contentHints`	`object` Informações adicionais sobre o conteúdo do arquivo. Esses campos nunca são preenchidos nas respostas.
`contentHints.indexableText`	`string` Texto a ser indexado para o arquivo melhorar as consultas de fullText. O tamanho é limitado a 128 KB e pode conter elementos HTML.
`contentHints.thumbnail`	`object` Uma miniatura do arquivo. Isso só será usado se o Google Drive não conseguir gerar uma miniatura padrão.
`contentHints.thumbnail.image`	`string (bytes format)` Os dados da miniatura codificados com Base64 seguro para URL (RFC 4648, seção 5). Uma string codificada em base64.
`contentHints.thumbnail.mimeType`	`string` O tipo MIME da miniatura.
`writersCanShare`	`boolean` Se os usuários com permissão `writer` podem modificar as permissões do arquivo. Não é preenchido para itens em drives compartilhados.
`viewedByMe`	`boolean` Apenas saída. Indica se o arquivo foi acessado por esse usuário.
`mimeType`	`string` O tipo MIME do arquivo. O Google Drive tenta detectar automaticamente um valor adequado do conteúdo enviado, se nenhum valor for fornecido. O valor não pode ser alterado a menos que uma nova revisão seja enviada. Se um arquivo for criado com um tipo MIME do Documentos Google, o conteúdo enviado será importado, se possível. Os formatos de importação compatíveis são publicados na seção "Sobre o recurso".
`exportLinks`	`map (key: string, value: string)` Apenas saída. Links para exportar arquivos do Docs Editors para formatos específicos. Um objeto com uma lista de pares `"key": value`. Exemplo: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` O ID da pasta pai que contém o arquivo. Um arquivo só pode ter uma pasta mãe. Não é possível especificar vários pais. Se não for especificado como parte de uma solicitação de criação, o arquivo será colocado diretamente na pasta "Meu Drive" do usuário. Se não for especificado como parte de uma solicitação de cópia, o arquivo vai herdar qualquer pai detectável do arquivo de origem. As solicitações files.update precisam usar os parâmetros `addParents` e `removeParents` para modificar a lista de pais.
`thumbnailLink`	`string` Apenas saída. Um link de curta duração para a miniatura do arquivo, se disponível. Geralmente dura algumas horas. Não é destinado ao uso direto em aplicativos da Web devido às políticas de compartilhamento de recursos entre origens (CORS). Considere usar um servidor proxy. Só é preenchido quando o app solicitante pode acessar o conteúdo do arquivo. Se o arquivo não for compartilhado publicamente, o URL retornado em `Files.thumbnailLink` precisará ser buscado usando uma solicitação com credenciais.
`iconLink`	`string` Apenas saída. Um link estático e não autenticado para o ícone do arquivo.
`shared`	`boolean` Apenas saída. Se o arquivo foi compartilhado. Não é preenchido para itens em drives compartilhados.
`lastModifyingUser`	`object (User)` Apenas saída. O último usuário a modificar o arquivo. Esse campo só é preenchido quando a última modificação é realizada por um usuário conectado.
`owners[]`	`object (User)` Apenas saída. O proprietário deste arquivo. Apenas alguns arquivos legados podem ter mais de um proprietário. Esse campo não é preenchido para itens em drives compartilhados.
`headRevisionId`	`string` Apenas saída. O ID da revisão principal do arquivo. No momento, esse recurso está disponível apenas para arquivos com conteúdo binário no Google Drive.
`sharingUser`	`object (User)` Apenas saída. O usuário que compartilhou o arquivo com o solicitante, se aplicável.
`webViewLink`	`string` Apenas saída. Um link para abrir o arquivo em um editor ou visualizador relevante do Google em um navegador.
`webContentLink`	`string` Apenas saída. Um link para fazer o download do conteúdo do arquivo em um navegador. Essa opção só está disponível para arquivos com conteúdo binário no Google Drive.
`size`	`string (int64 format)` Apenas saída. Tamanho em bytes de blobs e arquivos do editor próprio. Não será preenchido para arquivos sem tamanho, como atalhos e pastas.
`viewersCanCopyContent (deprecated)`	`boolean` Este item está obsoleto. Descontinuado: use `copyRequiresWriterPermission`.
`permissions[]`	`object (Permission)` Apenas saída. A lista completa de permissões do arquivo. Essa opção só está disponível se o usuário solicitante puder compartilhar o arquivo. Não é preenchido para itens em drives compartilhados.
`hasThumbnail`	`boolean` Apenas saída. Indica se o arquivo tem uma miniatura. Isso não indica se o app solicitante tem acesso à miniatura. Para verificar o acesso, procure a presença do campo thumbnailLink.
`spaces[]`	`string` Apenas saída. A lista de espaços que contém o arquivo. Os valores aceitos no momento são "drive", "appDataFolder" e "photos".
`folderColorRgb`	`string` A cor de uma pasta ou de um atalho para uma pasta como uma string hexadecimal RGB. As cores compatíveis são publicadas no campo `folderColorPalette` do recurso "Sobre". Se uma cor sem suporte for especificada, a cor mais próxima na paleta será usada.
`id`	`string` O ID do arquivo.
`name`	`string` O nome do arquivo. Ele não é necessariamente exclusivo em uma pasta. Para itens imutáveis, como as pastas de nível superior de drives compartilhados, a raiz do Meu Drive e a pasta "Dados do aplicativo", o nome é constante.
`description`	`string` Uma breve descrição do arquivo.
`starred`	`boolean` Indica se o usuário marcou o arquivo com estrela.
`trashed`	`boolean` Indica se o arquivo foi excluído explicitamente ou de uma pasta mãe. Somente o proprietário pode excluir um arquivo, e os outros usuários não podem acessar os arquivos na lixeira do proprietário.
`explicitlyTrashed`	`boolean` Apenas saída. Indica se o arquivo foi excluído explicitamente, em vez de ser excluído recursivamente de uma pasta pai.
`createdTime`	`string` O horário em que o arquivo foi criado (data e hora RFC 3339).
`modifiedTime`	`string` A última vez que o arquivo foi modificado por alguém (data e hora RFC 3339). A configuração `modifiedTime` também atualiza `modifiedByMeTime` para o usuário.
`modifiedByMeTime`	`string` Apenas saída. A última vez que o arquivo foi modificado pelo usuário (data e hora RFC 3339).
`viewedByMeTime`	`string` A última vez que o arquivo foi visualizado pelo usuário (data e hora RFC 3339).
`sharedWithMeTime`	`string` Apenas saída. O horário em que o arquivo foi compartilhado com o usuário, se aplicável (data e hora RFC 3339).
`quotaBytesUsed`	`string (int64 format)` Apenas saída. O número de bytes da cota de armazenamento usados pelo arquivo. Isso inclui a revisão do cabeçalho e as revisões anteriores com `keepForever` ativado.
`version`	`string (int64 format)` Apenas saída. Um número de versão monotonicamente crescente para o arquivo. Isso reflete todas as alterações feitas no arquivo no servidor, mesmo as que não estão visíveis para o usuário.
`originalFilename`	`string` O nome de arquivo original do conteúdo enviado, se disponível, ou o valor original do campo `name`. Essa opção só está disponível para arquivos com conteúdo binário no Google Drive.
`ownedByMe`	`boolean` Apenas saída. Se o usuário é proprietário do arquivo. Não é preenchido para itens em drives compartilhados.
`fullFileExtension`	`string` Apenas saída. A extensão de arquivo completa extraída do campo `name`. Pode conter várias extensões concatenadas, como "tar.gz". Essa opção só está disponível para arquivos com conteúdo binário no Google Drive. Ele é atualizado automaticamente quando o campo `name` muda, mas não é apagado se o novo nome não tiver uma extensão válida.
`properties`	`map (key: string, value: value (Value format))` Uma coleção de pares de chave-valor arbitrários que ficam visíveis para todos os apps. As entradas com valores nulos são apagadas em solicitações de atualização e cópia. Um objeto com uma lista de pares `"key": value`. Exemplo: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`appProperties`	`map (key: string, value: value (Value format))` Uma coleção de pares de chave-valor arbitrários que são privados para o app solicitante. As entradas com valores nulos são apagadas em solicitações de atualização e cópia. Essas propriedades só podem ser recuperadas usando uma solicitação autenticada. Uma solicitação autenticada usa um token de acesso recebido com um ID do cliente OAuth 2. Não é possível usar uma chave de API para recuperar propriedades privadas. Um objeto com uma lista de pares `"key": value`. Exemplo: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`isAppAuthorized`	`boolean` Apenas saída. Se o arquivo foi criado ou aberto pelo app solicitante.
`teamDriveId (deprecated)`	`string` Este item está obsoleto. Descontinuado: somente saída. Use `driveId`.
`capabilities`	`object` Apenas saída. Capacidades que o usuário atual tem neste arquivo. Cada capability corresponde a uma ação detalhada que um usuário pode realizar.
`capabilities.canChangeViewersCanCopyContent (deprecated)`	`boolean` Descontinuado: somente saída.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` Apenas saída. Se o usuário atual pode mover os itens filhos dessa pasta para fora do drive compartilhado. O valor é falso quando o item não é uma pasta. Preenchido apenas para itens em drives compartilhados.
`capabilities.canReadDrive`	`boolean` Apenas saída. Se o usuário atual pode ler o drive compartilhado ao qual o arquivo pertence. Preenchido apenas para itens em drives compartilhados.
`capabilities.canEdit`	`boolean` Apenas saída. Indica se o usuário atual pode editar este arquivo. Outros fatores podem limitar o tipo de mudanças que um usuário pode fazer em um arquivo. Por exemplo, consulte `canChangeCopyRequiresWriterPermission` ou `canModifyContent`.
`capabilities.canCopy`	`boolean` Apenas saída. Indica se o usuário atual pode copiar esse arquivo. Para um item em um drive compartilhado, se o usuário atual pode copiar os itens que não são pastas descendentes desse item ou o próprio item, se ele não for uma pasta.
`capabilities.canComment`	`boolean` Apenas saída. Se o usuário atual pode comentar neste arquivo.
`capabilities.canAddChildren`	`boolean` Apenas saída. Indica se o usuário atual pode adicionar subpastas a essa pasta. Esse valor é sempre falso quando o item não é uma pasta.
`capabilities.canDelete`	`boolean` Apenas saída. Indica se o usuário atual pode excluir o arquivo.
`capabilities.canDownload`	`boolean` Apenas saída. Indica se o usuário atual pode fazer o download do arquivo.
`capabilities.canListChildren`	`boolean` Apenas saída. Se o usuário atual pode listar as subpastas dessa pasta. Esse valor é sempre falso quando o item não é uma pasta.
`capabilities.canRemoveChildren`	`boolean` Apenas saída. Se o usuário atual pode remover crianças dessa pasta. Esse valor é sempre falso quando o item não é uma pasta. Para uma pasta em um drive compartilhado, use `canDeleteChildren` ou `canTrashChildren`.
`capabilities.canRename`	`boolean` Apenas saída. Indica se o usuário atual pode renomear esse arquivo.
`capabilities.canTrash`	`boolean` Apenas saída. Se o usuário atual pode mover esse arquivo para a lixeira.
`capabilities.canReadRevisions`	`boolean` Apenas saída. Se o usuário atual pode ler o recurso de revisões deste arquivo. Para um item de drive compartilhado, as revisões de descendentes não-pastas desse item ou o próprio item, se não for uma pasta, podem ser lidas.
`capabilities.canReadTeamDrive (deprecated)`	`boolean` Descontinuado: somente saída. Use `canReadDrive`.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` Descontinuado: somente saída. Use `canMoveItemWithinDrive` ou `canMoveItemOutOfDrive`.
`capabilities.canChangeCopyRequiresWriterPermission`	`boolean` Apenas saída. Se o usuário atual pode mudar a restrição `copyRequiresWriterPermission` desse arquivo.
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` Descontinuado: somente saída. Use `canMoveItemOutOfDrive`.
`capabilities.canUntrash`	`boolean` Apenas saída. Se o usuário atual pode restaurar o arquivo da lixeira.
`capabilities.canModifyContent`	`boolean` Apenas saída. Se o usuário atual pode modificar o conteúdo deste arquivo.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` Descontinuado: somente saída. Use `canMoveItemWithinDrive`.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` Descontinuado: somente saída. Use `canMoveItemOutOfDrive`.
`capabilities.canDeleteChildren`	`boolean` Apenas saída. Se o usuário atual pode excluir as subpastas dessa pasta. O valor é falso quando o item não é uma pasta. Preenchido apenas para itens em drives compartilhados.
`capabilities.canMoveChildrenOutOfTeamDrive (deprecated)`	`boolean` Descontinuado: somente saída. Use `canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` Descontinuado: somente saída. Use `canMoveChildrenWithinDrive`.
`capabilities.canTrashChildren`	`boolean` Apenas saída. Indica se o usuário atual pode excluir itens secundários dessa pasta. O valor é falso quando o item não é uma pasta. Preenchido apenas para itens em drives compartilhados.
`capabilities.canMoveItemOutOfDrive`	`boolean` Apenas saída. Indica se o usuário atual pode mover esse item para fora do drive mudando o item pai. Uma solicitação para mudar o item pai ainda pode falhar, dependendo do novo item pai que está sendo adicionado.
`capabilities.canAddMyDriveParent`	`boolean` Apenas saída. Indica se o usuário atual pode adicionar um item pai para o item sem remover um item pai existente na mesma solicitação. Não é preenchido para arquivos de drive compartilhado.
`capabilities.canRemoveMyDriveParent`	`boolean` Apenas saída. Se o usuário atual pode remover um familiar responsável do item sem adicionar outro na mesma solicitação. Não é preenchido para arquivos de drive compartilhado.
`capabilities.canMoveItemWithinDrive`	`boolean` Apenas saída. Se o usuário atual pode mover este item dentro deste drive. Uma solicitação para mudar o item principal ainda pode falhar, dependendo do novo item principal que está sendo adicionado e do que está sendo removido.
`capabilities.canShare`	`boolean` Apenas saída. Indica se o usuário atual pode modificar as configurações de compartilhamento desse arquivo.
`capabilities.canMoveChildrenWithinDrive`	`boolean` Apenas saída. Indica se o usuário atual pode mover as pastas filhas dessa pasta no Drive. O valor é falso quando o item não é uma pasta. Uma solicitação para mover a criança ainda pode falhar, dependendo do acesso do usuário atual à criança e à pasta de destino.
`capabilities.canModifyContentRestriction (deprecated)`	`boolean` Descontinuado: somente saída. Use `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` ou `canRemoveContentRestriction`.
`capabilities.canAddFolderFromAnotherDrive`	`boolean` Apenas saída. Indica se o usuário atual pode adicionar uma pasta de outro drive (drive compartilhado diferente ou Meu Drive) a essa pasta. O valor é falso quando o item não é uma pasta. Preenchido apenas para itens em drives compartilhados.
`capabilities.canChangeSecurityUpdateEnabled`	`boolean` Apenas saída. Indica se o usuário atual pode mudar o campo securityUpdateEnabled nos metadados de compartilhamento de link.
`capabilities.canAcceptOwnership`	`boolean` Apenas saída. Se o usuário atual é o proprietário pendente do arquivo. Não é preenchido para arquivos de drive compartilhado.
`capabilities.canReadLabels`	`boolean` Apenas saída. Se o usuário atual pode ler os rótulos no arquivo.
`capabilities.canModifyLabels`	`boolean` Apenas saída. Se o usuário atual pode modificar os rótulos no arquivo.
`capabilities.canModifyEditorContentRestriction`	`boolean` Apenas saída. Indica se o usuário atual pode adicionar ou modificar restrições de conteúdo no arquivo que são restritas ao editor.
`capabilities.canModifyOwnerContentRestriction`	`boolean` Apenas saída. Indica se o usuário atual pode adicionar ou modificar restrições de conteúdo que são restritas ao proprietário.
`capabilities.canRemoveContentRestriction`	`boolean` Apenas saída. Se há uma restrição de conteúdo no arquivo que pode ser removida pelo usuário atual.
`capabilities.canDisableInheritedPermissions`	`boolean` Se um usuário pode desativar as permissões herdadas.
`capabilities.canEnableInheritedPermissions`	`boolean` Se um usuário pode reativar as permissões herdadas.
`hasAugmentedPermissions`	`boolean` Apenas saída. Se há permissões diretamente neste arquivo. Esse campo só é preenchido para itens em drives compartilhados.
`trashingUser`	`object (User)` Apenas saída. Se o arquivo foi excluído explicitamente, o usuário que fez isso. Preenchido apenas para itens em drives compartilhados.
`thumbnailVersion`	`string (int64 format)` Apenas saída. A versão da miniatura para uso na invalidação do cache de miniaturas.
`trashedTime`	`string` Apenas saída. O horário em que o item foi excluído (data e hora RFC 3339). Preenchido apenas para itens em drives compartilhados.
`modifiedByMe`	`boolean` Apenas saída. Se o arquivo foi modificado por esse usuário.
`permissionIds[]`	`string` Somente saída. files.list de IDs de permissão para usuários com acesso a este arquivo.
`imageMediaMetadata`	`object` Apenas saída. Metadados adicionais sobre mídia de imagem, se disponíveis.
`imageMediaMetadata.flashUsed`	`boolean` Apenas saída. Se um flash foi usado para criar a foto.
`imageMediaMetadata.meteringMode`	`string` Apenas saída. O modo de medição usado para criar a foto.
`imageMediaMetadata.sensor`	`string` Apenas saída. O tipo de sensor usado para criar a foto.
`imageMediaMetadata.exposureMode`	`string` Apenas saída. O modo de exposição usado para criar a foto.
`imageMediaMetadata.colorSpace`	`string` Apenas saída. O espaço de cor da foto.
`imageMediaMetadata.whiteBalance`	`string` Apenas saída. O modo de equilíbrio de branco usado para criar a foto.
`imageMediaMetadata.width`	`integer` Apenas saída. A largura da imagem, em pixels.
`imageMediaMetadata.height`	`integer` Apenas saída. A altura da imagem, em pixels.
`imageMediaMetadata.location`	`object` Apenas saída. Informações de localização geográfica armazenadas na imagem.
`imageMediaMetadata.location.latitude`	`number` Apenas saída. A latitude armazenada na imagem.
`imageMediaMetadata.location.longitude`	`number` Apenas saída. A longitude armazenada na imagem.
`imageMediaMetadata.location.altitude`	`number` Apenas saída. A altitude armazenada na imagem.
`imageMediaMetadata.rotation`	`integer` Apenas saída. O número de rotações de 90 graus no sentido horário aplicadas a partir da orientação original da imagem.
`imageMediaMetadata.time`	`string` Apenas saída. A data e a hora em que a foto foi tirada (EXIF DateTime).
`imageMediaMetadata.cameraMake`	`string` Apenas saída. A marca da câmera usada para criar a foto.
`imageMediaMetadata.cameraModel`	`string` Apenas saída. O modelo da câmera usada para criar a foto.
`imageMediaMetadata.exposureTime`	`number` Apenas saída. A duração da exposição, em segundos.
`imageMediaMetadata.aperture`	`number` Apenas saída. A abertura usada para criar a foto (número f).
`imageMediaMetadata.focalLength`	`number` Apenas saída. A distância focal usada para criar a foto, em milímetros.
`imageMediaMetadata.isoSpeed`	`integer` Apenas saída. A velocidade ISO usada para criar a foto.
`imageMediaMetadata.exposureBias`	`number` Apenas saída. A compensação da exposição da foto (valor APEX).
`imageMediaMetadata.maxApertureValue`	`number` Apenas saída. O menor número f da lente na distância focal usada para criar a foto (valor APEX).
`imageMediaMetadata.subjectDistance`	`integer` Apenas saída. A distância até o objeto da foto, em metros.
`imageMediaMetadata.lens`	`string` Apenas saída. A lente usada para criar a foto.
`videoMediaMetadata`	`object` Apenas saída. Metadados adicionais sobre mídia de vídeo. Talvez ele não esteja disponível imediatamente após o upload.
`videoMediaMetadata.width`	`integer` Apenas saída. A largura do vídeo em pixels.
`videoMediaMetadata.height`	`integer` Apenas saída. A altura do vídeo em pixels.
`videoMediaMetadata.durationMillis`	`string (int64 format)` Apenas saída. A duração do vídeo em milissegundos.
`shortcutDetails`	`object` Detalhes do arquivo de atalho. Preenchido apenas para arquivos de atalho com o campo mimeType definido como `application/vnd.google-apps.shortcut`. Só pode ser definido em solicitações `files.create`.
`shortcutDetails.targetId`	`string` O ID do arquivo para o qual este atalho aponta. Só pode ser definido em solicitações `files.create`.
`shortcutDetails.targetMimeType`	`string` Apenas saída. O tipo MIME do arquivo para o qual este atalho aponta. O valor desse campo é um resumo do tipo MIME do destino, capturado quando o atalho é criado.
`shortcutDetails.targetResourceKey`	`string` Apenas saída. A ResourceKey do arquivo de destino.
`contentRestrictions[]`	`object (ContentRestriction)` Restrições para acessar o conteúdo do arquivo. Só é preenchido se essa restrição existir.
`resourceKey`	`string` Apenas saída. Uma chave necessária para acessar o item por um link compartilhado.
`linkShareMetadata`	`object` Apenas saída. Detalhes relacionados ao LinkShare. Contém detalhes sobre os URLs de link que os clientes estão usando para se referir a este item.
`linkShareMetadata.securityUpdateEligible`	`boolean` Apenas saída. Se o arquivo está qualificado para a atualização de segurança.
`linkShareMetadata.securityUpdateEnabled`	`boolean` Apenas saída. Indica se a atualização de segurança está ativada para este arquivo.
`labelInfo`	`object` Apenas saída. Uma visão geral dos rótulos no arquivo.
`labelInfo.labels[]`	`object (Label)` Apenas saída. O conjunto de rótulos no arquivo, conforme solicitado pelos IDs de rótulo no parâmetro `includeLabels`. Por padrão, nenhum marcador é retornado.
`sha1Checksum`	`string` Apenas saída. A soma de verificação SHA1 associada a este arquivo, se disponível. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive. Ele não é preenchido para editores de documentos ou arquivos de atalho.
`sha256Checksum`	`string` Apenas saída. A soma de verificação SHA256 associada a este arquivo, se disponível. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive. Ele não é preenchido para editores de documentos ou arquivos de atalho.
`inheritedPermissionsDisabled`	`boolean` Se as permissões herdadas estão desativadas neste arquivo. As permissões herdadas são ativadas por padrão.

ContentRestriction

Uma restrição para acessar o conteúdo do arquivo.

Representação JSON
{ "readOnly": boolean, "reason": string, "type": string, "restrictingUser": { object (`User`) }, "restrictionTime": string, "ownerRestricted": boolean, "systemRestricted": boolean }

Campos
`readOnly`	`boolean` Se o conteúdo do arquivo é somente leitura. Se um arquivo for somente leitura, não será possível adicionar uma nova revisão, comentários ou modificar o título dele.
`reason`	`string` Motivo pelo qual o conteúdo do arquivo está restrito. Ele só pode ser modificado em solicitações que também definem `readOnly=true`.
`type`	`string` Apenas saída. O tipo de restrição de conteúdo. Atualmente, o único valor possível é `globalContentRestriction`.
`restrictingUser`	`object (User)` Apenas saída. O usuário que definiu a restrição de conteúdo. Só é preenchido se `readOnly` for verdadeiro.
`restrictionTime`	`string` Apenas saída. O horário em que a restrição de conteúdo foi definida (carimbo de data/hora RFC 3339 formatado). Só é preenchido se `readOnly` for verdadeiro.
`ownerRestricted`	`boolean` Se a restrição de conteúdo só pode ser modificada ou removida por um usuário que é proprietário do arquivo. Para arquivos em drives compartilhados, qualquer usuário com recursos `organizer` pode modificar ou remover essa restrição de conteúdo.
`systemRestricted`	`boolean` Apenas saída. Se a restrição de conteúdo foi aplicada pelo sistema, por exemplo, devido a uma assinatura eletrônica. Os usuários não podem modificar ou remover as restrições de conteúdo restrito do sistema.

Métodos
`copy`	Cria uma cópia de um arquivo e aplica todas as atualizações solicitadas com semântica de patch.
`create`	Cria um novo arquivo.
`delete`	Exclui permanentemente um arquivo do usuário sem movê-lo para a lixeira.
`download`	Faz o download do conteúdo de um arquivo.
`emptyTrash`	Exclui permanentemente todos os arquivos do usuário que estão na lixeira.
`export`	Exporta um documento do Google Workspace para o tipo MIME solicitado e retorna o conteúdo de bytes exportado.
`generateIds`	Gera um conjunto de IDs de arquivo que podem ser fornecidos em solicitações de criação ou cópia.
`get`	Recebe os metadados ou o conteúdo de um arquivo por ID.
`list`	Lista os arquivos do usuário.
`listLabels`	Lista os rótulos em um arquivo.
`modifyLabels`	Modifica o conjunto de marcadores aplicados a um arquivo.
`update`	Atualiza os metadados e/ou o conteúdo de um arquivo.
`watch`	Inscreve-se em mudanças em um arquivo.

REST Resource: files

Recurso: arquivo

ContentRestriction

Métodos

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`