REST Resource: files

Recurso: File

Os metadados de um arquivo.

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

Representação JSON
{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "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,
  "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,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}
Campos
parents[]

string

O ID da pasta mãe que contém o arquivo.

Um arquivo só pode ter uma pasta mãe. Não é possível especificar várias pastas mãe.

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.

owners[]

object (User)

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

permissions[]

object (Permission)

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

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

properties

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

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

As entradas com valores nulos são limpas 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 particulares ao app solicitante.

As entradas com valores nulos são limpas 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 particulares.

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

permissionIds[]

string

Somente saída. "files.list" de IDs de permissão para usuários com acesso a esse arquivo.

contentRestrictions[]

object (ContentRestriction)

Restrições para acessar o conteúdo do arquivo. Preenchido apenas se houver uma restrição.

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á localizado. 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 copiar, imprimir ou fazer o 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ó se aplica 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 que o arquivo melhore as consultas fullText. O limite é de 128 KB de comprimento, e ele 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 (seção 5 da RFC 4648).

Uma string codificada em base64.

contentHints.thumbnail.mimeType

string

O tipo MIME da miniatura.

writersCanShare

boolean

Se os usuários com permissão apenas de 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 visualizado pelo usuário.

mimeType

string

O tipo MIME do arquivo.

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

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 foi feita por um usuário conectado.

headRevisionId

string

Apenas saída. O ID da revisão principal do arquivo. No momento, isso só está disponível 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 usuário solicitante, se aplicável.

size

string (int64 format)

Apenas saída. Tamanho em bytes de blobs e arquivos do editor próprios. Não será preenchido para arquivos sem tamanho, como atalhos e pastas.

viewersCanCopyContent
(deprecated)

boolean

Descontinuado: use copyRequiresWriterPermission.

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

folderColorRgb

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 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. Isso não precisa ser exclusivo em uma pasta. Para itens imutáveis, como as pastas de nível superior dos drives compartilhados, a pasta raiz do Meu Drive e a pasta "Dados de aplicativos", o nome é constante.

description

string

Uma breve descrição do arquivo.

starred

boolean

Se o usuário adicionou o arquivo aos favoritos.

trashed

boolean

Se o arquivo foi movido para a lixeira, explicitamente ou de uma pasta mãe movida para a lixeira. Somente o proprietário pode mover um arquivo para a lixeira, e outros usuários não podem ver os arquivos na lixeira do proprietário.

explicitlyTrashed

boolean

Apenas saída. Se o arquivo foi movido explicitamente para a lixeira, em vez de ter sido movido recursivamente de uma pasta mãe.

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).

Definir 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, bem como as revisões anteriores com o keepForever ativado.

version

string (int64 format)

Apenas saída. Um número de versão monotonicamente crescente para o arquivo. Isso reflete todas as mudanças feitas no arquivo no servidor, mesmo as que não estão visíveis para o usuário.

originalFilename

string

O nome 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. Indica se o usuário é proprietário do arquivo. Não é preenchido para itens em drives compartilhados.

fullFileExtension

string

Apenas saída. A extensão completa do arquivo 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 é limpo se o novo nome não tiver uma extensão válida.

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

Descontinuado: somente saída. Use driveId.

capabilities

object

Apenas saída. Capacidades que o usuário atual tem neste arquivo. Cada funcionalidade corresponde a uma ação refinada 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 filhos desta pasta para fora do drive compartilhado. É "false" 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 a que este arquivo pertence. Preenchido apenas para itens em drives compartilhados.

capabilities.canEdit

boolean

Apenas saída. 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. Se o usuário atual pode copiar este arquivo. Para um item em um drive compartilhado, se o usuário atual pode copiar descendentes que não são pastas 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. Se o usuário atual pode adicionar filhos a esta pasta. Isso é 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. Se o usuário atual pode baixar este arquivo.

capabilities.canListChildren

boolean

Apenas saída. Se o usuário atual pode listar os filhos desta pasta. Isso é sempre falso quando o item não é uma pasta.

capabilities.canRemoveChildren

boolean

Apenas saída. Se o usuário atual pode remover itens desta pasta. Isso é 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. Se o usuário atual pode renomear esse arquivo.

capabilities.canTrash

boolean

Apenas saída. Indica se o usuário atual pode mover o 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 do drive compartilhado, indica se é possível ler as revisões de descendentes que não são pastas desse item ou o próprio item, se ele não for uma pasta.

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 deste arquivo.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Descontinuado: somente saída. Use canMoveItemOutOfDrive.

capabilities.canUntrash

boolean

Apenas saída. Se o usuário atual pode restaurar este 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 filhos desta pasta. É "false" 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 os itens desta pasta. É "false" quando o item não é uma pasta. Preenchido apenas para itens em drives compartilhados.

capabilities.canMoveItemOutOfDrive

boolean

Apenas saída. Se o usuário atual pode mover o item para fora do drive mudando o pai dele. Uma solicitação para mudar o pai do item ainda pode falhar, dependendo do novo pai que está sendo adicionado.

capabilities.canAddMyDriveParent

boolean

Apenas saída. 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.

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 drives compartilhados.

capabilities.canMoveItemWithinDrive

boolean

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

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

Apenas saída. Se o usuário atual pode mover os filhos desta pasta dentro desta unidade. É "false" 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 um dos seguintes: canModifyEditorContentRestriction, canModifyOwnerContentRestriction ou canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

Apenas saída. Se o usuário atual pode adicionar uma pasta de outro drive (drive compartilhado diferente ou Meu Drive) a esta pasta. É "false" quando o item não é uma pasta. Preenchido apenas para itens em drives compartilhados.

capabilities.canChangeSecurityUpdateEnabled

boolean

Apenas saída. Se o usuário atual pode mudar o campo "securityUpdateEnabled" nos metadados de compartilhamento de link.

capabilities.canAcceptOwnership

boolean

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

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 marcadores no arquivo.

capabilities.canModifyEditorContentRestriction

boolean

Apenas saída. 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.

capabilities.canChangeItemDownloadRestriction

boolean

Apenas saída. Se o usuário atual pode mudar o proprietário ou as restrições de download aplicadas pelo organizador do arquivo.

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 movido para a lixeira, 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 movido para a lixeira (data e hora RFC 3339). Preenchido apenas para itens em drives compartilhados.

modifiedByMe

boolean

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

imageMediaMetadata

object

Apenas saída. Outros metadados 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 da orientação original da imagem.

imageMediaMetadata.time

string

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

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 sensibilidade 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. Essa opção pode não estar disponível imediatamente após o envio.

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, que têm 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 a que o atalho aponta. Só pode ser definido em solicitações files.create.

shortcutDetails.targetMimeType

string

Apenas saída. O tipo MIME do arquivo a que este atalho aponta. O valor desse campo é um snapshot do tipo MIME do destino, capturado quando o atalho é criado.

shortcutDetails.targetResourceKey

string

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

resourceKey

string

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

linkShareMetadata.securityUpdateEligible

boolean

Apenas saída. Se o arquivo está qualificado para 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 esse arquivo, se disponível. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive, não para editores do 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, não para editores do Documentos ou arquivos de atalho.

inheritedPermissionsDisabled

boolean

Se este arquivo tem permissões herdadas desativadas. As permissões herdadas são ativadas por padrão.

downloadRestrictions

object (DownloadRestrictionsMetadata)

Restrições de download aplicadas ao arquivo.

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, nem adicionar ou modificar comentários, nem mudar o título.

reason

string

Motivo da restrição do conteúdo do arquivo. Isso só pode ser alterado em solicitações que também definem readOnly=true.

type

string

Apenas saída. O tipo de restrição de conteúdo. No momento, o único valor possível é globalContentRestriction.

restrictingUser

object (User)

Apenas saída. O usuário que definiu a restrição de conteúdo. Preenchido apenas 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). Preenchido apenas se readOnly for verdadeiro.

ownerRestricted

boolean

Se a restrição de conteúdo só pode ser modificada ou removida por um usuário proprietário do arquivo. Para arquivos em drives compartilhados, qualquer usuário com recursos de 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 restrições de conteúdo restrito pelo sistema.

DownloadRestrictionsMetadata

Restrições de download aplicadas ao arquivo.

Representação JSON
{
  "itemDownloadRestriction": {
    object (DownloadRestriction)
  },
  "effectiveDownloadRestrictionWithContext": {
    object (DownloadRestriction)
  }
}
Campos
itemDownloadRestriction

object (DownloadRestriction)

A restrição de download do arquivo aplicada diretamente pelo proprietário ou organizador. Isso não considera as configurações do drive compartilhado nem as regras de DLP.

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

Apenas saída. A restrição de download efetiva aplicada a este arquivo. Isso considera todas as configurações de restrição e regras da DLP.

DownloadRestriction

Uma restrição para cópia e download do arquivo.

Representação JSON
{
  "restrictedForReaders": boolean,
  "restrictedForWriters": boolean
}
Campos
restrictedForReaders

boolean

Se o download e a cópia estão restritos para leitores.

restrictedForWriters

boolean

Se o download e a cópia são restritos para gravadores. Se for verdadeiro, o download também será restrito para os leitores.

Métodos

copy

Cria uma cópia de um arquivo e aplica as atualizações solicitadas com semântica de patch.

create

Cria um novo arquivo.

delete

Exclui permanentemente um arquivo de propriedade 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 movidos para a lixeira do usuário.

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 para receber notificações sobre mudanças em um arquivo.