REST Resource: files

{
  "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
  },
  "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
}

string

Apenas saída. Identifica o tipo de recurso. Valor: a string fixa "drive#file".

string

Apenas saída. ID do drive compartilhado em que o arquivo está localizado Preenchido apenas para itens nos drives compartilhados.

string

Apenas saída. O componente final de fullFileExtension. Esse recurso só está disponível para arquivos com conteúdo binário no Google Drive.

boolean

Se as opções para copiar, imprimir ou fazer o download deste arquivo devem ser desativadas para leitores e comentadores.

string

Apenas saída. A soma de verificação MD5 para o conteúdo do arquivo. Isso só é aplicável a arquivos com conteúdo binário no Google Drive.

object

Informações adicionais sobre o conteúdo do arquivo. Esses campos nunca são preenchidos nas respostas.

string

Texto a ser indexado para o arquivo a fim de melhorar as consultas fullText. Ele está limitado a 128 KB de comprimento e pode conter elementos HTML.

object

Uma miniatura do arquivo. Essa opção será usada apenas se o Google Drive não puder gerar uma miniatura padrão.

string (bytes format)

Os dados de miniatura codificados com Base64 seguro para URL (seção 5 do RFC 4648).

Uma string codificada em base64.

string

O tipo MIME da miniatura.

boolean

Define se os usuários com apenas a permissão writer podem modificar as permissões do arquivo. Não preenchido para itens em drives compartilhados.

boolean

Apenas saída. Indica se o arquivo foi visualizado por este usuário.

string

O tipo MIME do arquivo.

O Google Drive tenta detectar automaticamente um valor apropriado no conteúdo enviado por upload, 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 por upload será importado, se possível. Os formatos de importação compatíveis são publicados no recurso Sobre.

map (key: string, value: string)

Apenas saída. Links para exportar arquivos dos Editores de arquivos Google em formatos específicos.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

string

O ID da pasta principal que contém o arquivo.

Um arquivo só pode ter uma pasta principal. 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 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 dos pais.

string

Apenas saída. Um link de curta duração para a miniatura do arquivo, se disponível. Normalmente dura cerca de horas. Não se destina ao uso direto em aplicativos da Web devido às políticas de Compartilhamento de recursos entre origens (CORS, na sigla em inglês). Considere usar um servidor proxy. Preenchido apenas 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 credenciada.

string

Apenas saída. Um link estático e não autenticado para o ícone do arquivo.

boolean

Apenas saída. Se o arquivo foi compartilhado. Não preenchido para itens em drives compartilhados.

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.

object (User)

Apenas saída. O proprietário deste arquivo. Apenas alguns arquivos legados podem ter mais de um proprietário. Este campo não é preenchido para itens em drives compartilhados.

string

Apenas saída. O ID da revisão principal do arquivo. No momento, esse recurso só está disponível para arquivos com conteúdo binário no Google Drive.

object (User)

Apenas saída. O usuário que compartilhou o arquivo com o usuário solicitante, se aplicável.

string

Apenas saída. Um link para abrir o arquivo em um editor ou visualizador relevante do Google em um navegador.

string

Apenas saída. Um link para fazer o download do conteúdo do arquivo em um navegador. Esse recurso só está disponível para arquivos com conteúdo binário no Google Drive.

string (int64 format)

Apenas saída. Tamanho em bytes de blobs e arquivos de editor próprios. Não são preenchidas para arquivos que não têm tamanho, como atalhos e pastas.

boolean

Obsoleto: use copyRequiresWriterPermission.

object (Permission)

Apenas saída. A lista completa de permissões do arquivo. Essa opção só estará disponível se o usuário solicitante puder compartilhar o arquivo. Não preenchido para itens em drives compartilhados.

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 o campothumbnailLink.

string

Apenas saída. A lista de espaços que contém o arquivo. Os valores compatíveis no momento são "drive" e "appDataFolder". e "photos".

string

A cor de uma pasta ou 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 não compatível for especificada, será usada a cor mais próxima na paleta.

string

O ID do arquivo.

string

O nome do arquivo. Ele não é necessariamente único dentro de uma pasta. No caso de itens imutáveis, como as pastas de nível superior dos drives compartilhados, a pasta raiz do Meu Drive e a pasta "Dados do aplicativo", o nome é constante.

string

Uma breve descrição do arquivo.

boolean

Se o usuário marcou o arquivo com estrela.

boolean

Se o arquivo foi enviado para a lixeira, explicitamente ou de uma pasta principal movida para a lixeira. Somente o proprietário pode enviar um arquivo para a lixeira, e os outros usuários não podem vê-lo.

boolean

Apenas saída. Se o arquivo foi enviado para a lixeira explicitamente, ou não de uma pasta mãe de maneira recorrente.

string

A hora em que o arquivo foi criado (data-hora RFC 3339).

string

A última vez que o arquivo foi modificado por alguém (data-hora RFC 3339).

A definição de modifiedTime também atualiza modifiedByMeTime para o usuário.

string

Apenas saída. A última vez que o arquivo foi modificado pelo usuário (data-hora RFC 3339).

string

A última vez que o arquivo foi visualizado pelo usuário (data-hora RFC 3339).

string

Apenas saída. A hora em que o arquivo foi compartilhado com o usuário, se aplicável (data-hora RFC 3339).

string (int64 format)

Apenas saída. O número de bytes da cota de armazenamento usados pelo arquivo. Isso inclui a revisão principal, bem como revisões anteriores com keepForever ativado.

string (int64 format)

Apenas saída. Um número de versão monotonicamente crescente do 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.

string

O nome do arquivo original do conteúdo enviado por upload, se disponível, ou o valor original do campo name. Esse recurso só está disponível para arquivos com conteúdo binário no Google Drive.

boolean

Apenas saída. Se o usuário é o proprietário do arquivo. Não preenchido para itens em drives compartilhados.

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". Esse recurso só está disponível para arquivos com conteúdo binário no Google Drive.

Isso é atualizado automaticamente quando o campo name é alterado, no entanto, não será apagado se o novo nome não tiver uma extensão válida.

map (key: string, value: value (Value format))

Uma coleção de pares de chave-valor arbitrários que são visíveis para todos os apps.

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" }.

map (key: string, value: value (Value format))

Uma coleção de pares de chave-valor arbitrários que são particulares do app solicitante.

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 obtido 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" }.

boolean

Apenas saída. Se o arquivo foi criado ou aberto pelo app solicitante.

string

Obsoleto: somente saída. Use driveId

object

Apenas saída. Recursos que o usuário atual tem nesse arquivo. Cada recurso corresponde a uma ação específica que um usuário pode realizar.

boolean

Obsoleto: somente saída.

boolean

Apenas saída. Define se o usuário atual pode mover os filhos desta pasta para fora do drive compartilhado. Isso é falso quando o item não é uma pasta. Preenchido apenas para itens nos drives compartilhados.

boolean

Apenas saída. Define se o usuário atual pode ler o drive compartilhado a que o arquivo pertence. Preenchido apenas para itens nos drives compartilhados.

boolean

Apenas saída. Se o usuário atual pode editar o arquivo. Outros fatores podem limitar os tipos de alterações que um usuário pode fazer em um arquivo. Por exemplo, consulte canChangeCopyRequiresWriterPermission ou canModifyContent.

boolean

Apenas saída. Se o usuário atual pode copiar o arquivo. Para um item em um drive compartilhado, se o usuário atual pode copiar os descendentes deste item que não são pastas ou o próprio item se ele não for uma pasta.

boolean

Apenas saída. Se o usuário atual pode comentar neste arquivo.

boolean

Apenas saída. Define se o usuário atual pode adicionar filhos à pasta. Esse atributo é sempre "false" quando o item não é uma pasta.

boolean

Apenas saída. Se o usuário atual pode excluir o arquivo.

boolean

Apenas saída. Se o usuário atual pode fazer o download desse arquivo.

boolean

Apenas saída. Define se o usuário atual pode listar os filhos desta pasta. Esse atributo é sempre "false" quando o item não é uma pasta.

boolean

Apenas saída. Define se o usuário atual pode remover filhos desta pasta. Esse atributo é sempre "false" quando o item não é uma pasta. Para uma pasta em um drive compartilhado, use canDeleteChildren ou canTrashChildren.

boolean

Apenas saída. Se o usuário atual pode renomear o arquivo.

boolean

Apenas saída. Se o usuário atual pode mover o arquivo para a lixeira.

boolean

Apenas saída. Se o usuário atual pode ler o recurso de revisões deste arquivo. Para um item do drive compartilhado, é possível ler se revisões de descendentes deste item (ou do item em si, se não for uma pasta) podem ser lidas.

boolean

Obsoleto: somente saída. Use canReadDrive

boolean

Obsoleto: somente saída. Use canMoveItemWithinDrive ou canMoveItemOutOfDrive.

boolean

Apenas saída. Define se o usuário atual pode mudar a restrição copyRequiresWriterPermission deste arquivo.

boolean

Obsoleto: somente saída. Use canMoveItemOutOfDrive

boolean

Apenas saída. Indica se o usuário atual pode restaurar o arquivo da lixeira.

boolean

Apenas saída. Se o usuário atual pode modificar o conteúdo desse arquivo.

boolean

Obsoleto: somente saída. Use canMoveItemWithinDrive

boolean

Obsoleto: somente saída. Use canMoveItemOutOfDrive

boolean

Apenas saída. Define se o usuário atual pode excluir filhos desta pasta. Isso é falso quando o item não é uma pasta. Preenchido apenas para itens nos drives compartilhados.

boolean

Obsoleto: somente saída. Use canMoveChildrenOutOfDrive

boolean

Obsoleto: somente saída. Use canMoveChildrenWithinDrive

boolean

Apenas saída. Indica se o usuário atual pode enviar os filhos desta pasta para a lixeira. Isso é falso quando o item não é uma pasta. Preenchido apenas para itens nos drives compartilhados.

boolean

Apenas saída. Define se o usuário atual pode mover o item para fora deste drive alterando o elemento pai. Uma solicitação para alterar o pai do item ainda pode falhar, dependendo do novo pai que estiver sendo adicionado.

boolean

Apenas saída. Define se o usuário atual pode adicionar um pai ao item sem remover um pai existente na mesma solicitação. Não preenchido para arquivos de drives compartilhados.

boolean

Apenas saída. Define se o usuário atual pode remover um pai do item sem adicionar outro pai na mesma solicitação. Não preenchido para arquivos de drives compartilhados.

boolean

Apenas saída. Define se o usuário atual pode mover o item dentro deste drive. Uma solicitação para alterar o pai do item ainda pode falhar, dependendo do novo pai que está sendo adicionado e do pai que está sendo removido.

boolean

Apenas saída. Se o usuário atual pode modificar as configurações de compartilhamento deste arquivo.

boolean

Apenas saída. Define se o usuário atual pode mover filhos desta pasta neste drive. Isso é falso quando o item não é uma pasta. Observe que uma solicitação para mover o filho ainda poderá falhar, dependendo do acesso do usuário atual ao filho e à pasta de destino.

boolean

Obsoleto: somente saída. Use canModifyEditorContentRestriction, canModifyOwnerContentRestriction ou canRemoveContentRestriction.

boolean

Apenas saída. Indica se o usuário atual pode adicionar uma pasta de outro drive (outro drive compartilhado ou "Meu Drive") a essa pasta. Isso é falso quando o item não é uma pasta. Preenchido apenas para itens nos drives compartilhados.

boolean

Apenas saída. Define se o usuário atual pode alterar o campo securityUpdateEnabled nos metadados do compartilhamento de link.

boolean

Apenas saída. Se o usuário atual é o proprietário pendente do arquivo. Não preenchido para arquivos de drives compartilhados.

boolean

Apenas saída. Se o usuário atual pode ler os rótulos no arquivo.

boolean

Apenas saída. Se o usuário atual pode modificar os rótulos no arquivo.

boolean

Apenas saída. Define se o usuário atual pode adicionar ou modificar restrições de conteúdo no arquivo que têm restrição para editores.

boolean

Apenas saída. Se o usuário atual pode adicionar ou modificar restrições de conteúdo restritas ao proprietário.

boolean

Apenas saída. Se há uma restrição de conteúdo no arquivo que pode ser removida pelo usuário atual.

boolean

Apenas saída. Indica se há permissões diretamente neste arquivo. Esse campo só é preenchido para itens nos drives compartilhados.

object (User)

Apenas saída. Se o arquivo foi explicitamente enviado para a lixeira, o usuário que o moveu para a lixeira. Preenchido apenas para itens nos drives compartilhados.

string (int64 format)

Apenas saída. A versão em miniatura para uso na invalidação do cache de miniaturas.

string

Apenas saída. O horário em que o item foi enviado para a lixeira (data-hora RFC 3339). Preenchido apenas para itens nos drives compartilhados.

boolean

Apenas saída. Indica se o arquivo foi modificado por esse usuário.

string

Apenas saída. files.list de IDs de permissão dos usuários com acesso ao arquivo.

object

Apenas saída. Metadados adicionais sobre mídia de imagem, se disponíveis.

boolean

Apenas saída. Indica se o flash foi usado para criar a foto.

string

Apenas saída. O modo de medição usado para criar a foto.

string

Apenas saída. O tipo de sensor usado para criar a foto.

string

Apenas saída. O modo de exposição usado para criar a foto.

string

Apenas saída. O espaço de cor da foto.

string

Apenas saída. O modo de balanço de branco usado para criar a foto.

integer

Apenas saída. A largura da imagem, em pixels.

integer

Apenas saída. A altura da imagem, em pixels.

object

Apenas saída. Informações de localização geográfica armazenadas na imagem.

number

Apenas saída. A latitude armazenada na imagem.

number

Apenas saída. A longitude armazenada na imagem.

number

Apenas saída. A altitude armazenada na imagem.

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.

string

Apenas saída. A data e a hora em que a foto foi tirada (EXIF DateTime).

string

Apenas saída. A marca da câmera usada para criar a foto.

string

Apenas saída. O modelo da câmera usada para criar a foto.

number

Apenas saída. É a duração da exposição em segundos.

number

Apenas saída. A abertura usada para criar a foto (número f).

number

Apenas saída. É o comprimento focal usado para criar a foto, em milímetros.

integer

Apenas saída. A velocidade ISO usada para criar a foto.

number

Apenas saída. O viés de exposição da foto (valor APEX).

number

Apenas saída. O menor número f da lente na distância focal usada para criar a foto (valor APEX).

integer

Apenas saída. A distância até o objeto da foto, em metros.

string

Apenas saída. A lente usada para criar a foto.

object

Apenas saída. Metadados adicionais sobre mídia de vídeo. Talvez ele não apareça imediatamente após o upload.

integer

Apenas saída. A largura do vídeo em pixels.

integer

Apenas saída. A altura do vídeo em pixels.

string (int64 format)

Apenas saída. A duração do vídeo em milissegundos.

object

Detalhes do arquivo de atalho. Preenchido apenas para arquivos de atalho, que têm o campo mimeType definido como application/vnd.google-apps.shortcut. Só pode ser definido em solicitações files.create.

string

O ID do arquivo para o qual esse atalho aponta. Só pode ser definido em solicitações files.create.

string

Apenas saída. O tipo MIME do arquivo para o qual esse atalho aponta. O valor desse campo é um resumo do tipo MIME do destino, capturado quando o atalho é criado.

string

Apenas saída. A ResourceKey do arquivo de destino.

object (ContentRestriction)

Restrições de acesso ao conteúdo do arquivo. Preenchido apenas se essa restrição existir.

string

Apenas saída. Uma chave necessária para acessar o item por meio de um link compartilhado.

object

Apenas saída. Detalhes relacionados ao LinkShare. Contém detalhes sobre os URLs de links que os clientes estão usando para se referir ao item.

boolean

Apenas saída. Se o arquivo está qualificado para atualização de segurança.

boolean

Apenas saída. Indica se a atualização de segurança está ativada para o arquivo.

object

Apenas saída. Uma visão geral dos marcadores no arquivo.

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 rótulo é retornado.

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 arquivos Google ou arquivos de atalho.

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 arquivos Google ou arquivos de atalho.