REST Resource: files | Google Drive | Google for Developers (original) (raw)
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 |
|---|
| { "ownerNames": [ string ], "exportLinks": { string: string, ... }, "parents": [ { object (ParentReference) } ], "owners": [ { object (User) } ], "openWithLinks": { string: string, ... }, "properties": [ { object (Property) } ], "permissions": [ { object (Permission) } ], "spaces": [ string ], "permissionIds": [ string ], "contentRestrictions": [ { object (ContentRestriction) } ], "kind": string, "userPermission": { object (Permission) }, "fileExtension": string, "md5Checksum": string, "selfLink": string, "lastModifyingUserName": string, "editable": boolean, "writersCanShare": boolean, "downloadUrl": string, "mimeType": string, "driveId": string, "thumbnailLink": string, "appDataContents": boolean, "webViewLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (User) }, "defaultOpenWithLink": string, "headRevisionId": string, "copyable": boolean, "etag": string, "sharingUser": { object (User) }, "alternateLink": string, "embedLink": string, "webContentLink": string, "fileSize": string, "copyRequiresWriterPermission": boolean, "hasThumbnail": boolean, "folderColorRgb": string, "id": string, "title": string, "description": string, "labels": { "viewed": boolean, "restricted": boolean, "starred": boolean, "hidden": boolean, "trashed": boolean, "modified": boolean }, "explicitlyTrashed": boolean, "createdDate": string, "modifiedDate": string, "modifiedByMeDate": string, "lastViewedByMeDate": string, "markedViewedByMeDate": string, "sharedWithMeDate": string, "quotaBytesUsed": string, "version": string, "indexableText": { "text": string }, "originalFilename": string, "ownedByMe": boolean, "canComment": boolean, "shareable": boolean, "fullFileExtension": string, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeRestrictedDownload": 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) }, "canReadRevisions": boolean, "thumbnailVersion": string, "trashedDate": string, "thumbnail": { "image": string, "mimeType": 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, "date": 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 } |
| Campos | |
|---|---|
| ownerNames[] | string Apenas saída. Nome(s) do(s) proprietário(s) deste arquivo. Não é preenchido para itens em drives compartilhados. |
| exportLinks | map (key: string, value: string) Apenas saída. Links para exportar arquivos dos editores de documentos para formatos específicos.Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }. |
| parents[] | object (ParentReference) 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 inserçã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. |
| openWithLinks | map (key: string, value: string) Apenas saída. Um mapa do ID de cada um dos apps do usuário para um link que abre o arquivo com esse app. Só é preenchido quando o escopo drive.apps.readonly é usado.Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }. |
| properties[] | object (Property) A lista de propriedades. |
| permissions[] | object (Permission) Apenas saída. A lista de permissões para usuários com acesso a esse 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 são drive, appDataFolder e photos. |
| 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. O tipo de arquivo. Esse valor é sempre drive#file. |
| userPermission | object (Permission) Apenas saída. As permissões do usuário autenticado neste arquivo. |
| fileExtension | string Apenas saída. O componente final de fullFileExtension com o texto final que não parece fazer parte da extensão removido. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive, não para editores do Documentos ou arquivos de atalho. |
| md5Checksum | string Apenas saída. Uma soma de verificação MD5 para o conteúdo deste arquivo. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive, não para editores do Documentos ou arquivos de atalho. |
| selfLink | string Apenas saída. Um link de volta para este arquivo. |
| lastModifyingUserName | string Apenas saída. Nome do último usuário a modificar este arquivo. |
| editable**(deprecated)** | boolean Apenas saída. Descontinuado: use capabilities/canEdit. |
| downloadUrl | string Apenas saída. URL de download de curta duração para o arquivo. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive, não para documentos Google ou arquivos de atalho. |
| mimeType | string O tipo MIME do arquivo. Só é possível mudar isso na atualização ao enviar um novo conteúdo. Este campo pode ser deixado em branco, e o tipo MIME será determinado pelo tipo MIME do conteúdo enviado. |
| driveId | string Apenas saída. ID do drive compartilhado em que o arquivo está localizado. Preenchido apenas para itens em drives compartilhados. |
| 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 ao Compartilhamento de recursos entre origens (CORS). 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 autenticada. |
| appDataContents | boolean Apenas saída. Indica se o arquivo está na pasta "Dados de aplicativos". |
| webViewLink | string Apenas saída. Um link disponível apenas em pastas públicas para visualizar os recursos da Web estáticos (HTML, CSS, JS etc.) pela hospedagem de sites do Google Drive. |
| iconLink | string Apenas saída. Um link 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 este arquivo. Esse campo só é preenchido quando a última modificação foi feita por um usuário conectado. |
| defaultOpenWithLink | string Apenas saída. Um link para abrir o arquivo com o app padrão do usuário para esse tipo de arquivo. Preenchido apenas quando o escopo drive.apps.readonly é usado. |
| headRevisionId | string Apenas saída. O ID da revisão principal do arquivo. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive, não para editores do Documentos ou arquivos de atalho. |
| copyable**(deprecated)** | boolean Apenas saída. Descontinuado: use capabilities/canCopy. |
| etag | string Apenas saída. ETag do arquivo. |
| sharingUser | object (User) Apenas saída. O usuário que compartilhou o item com o usuário atual, se disponível. |
| alternateLink | string Apenas saída. Um link para abrir o arquivo em um editor ou visualizador relevante do Google. |
| embedLink | string Apenas saída. Um link para incorporar o arquivo. |
| webContentLink | string Apenas saída. Um link para fazer o download do conteúdo do arquivo em um navegador usando a autenticação baseada em cookies. Quando o conteúdo é compartilhado publicamente, ele pode ser baixado sem credenciais. |
| fileSize | 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. |
| copyRequiresWriterPermission | boolean Se as opções de copiar, imprimir ou fazer o download deste arquivo devem ser desativadas para leitores e comentaristas. |
| 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 Cor da pasta como uma string hexadecimal RGB se o arquivo for uma pasta ou um atalho para uma pasta. A lista de cores compatíveis está disponível no campo "folderColorPalette" do recurso "About". Se uma cor sem suporte for especificada, ela será alterada para a cor mais próxima na paleta. |
| id | string O ID do arquivo. |
| title | string O título deste arquivo. Para itens imutáveis, como as pastas de nível superior dos drives compartilhados, a pasta raiz do Meu Drive e a pasta de dados do aplicativo, o título é constante. |
| description | string Uma breve descrição do arquivo. |
| labels | object Um grupo de rótulos para o arquivo. |
| labels.viewed | boolean Indica se o arquivo foi visualizado pelo usuário. |
| labels.restricted**(deprecated)** | boolean Apenas saída. Descontinuado: use copyRequiresWriterPermission. |
| labels.starred | boolean Indica se o arquivo foi marcado com estrela pelo usuário. |
| labels.hidden**(deprecated)** | boolean Apenas saída. Obsoleto. |
| labels.trashed | boolean Indica se o arquivo foi movido para a lixeira. Esse marcador se aplica a todos os usuários que acessam o arquivo, mas apenas os proprietários podem ver e recuperar arquivos da lixeira. |
| labels.modified | boolean Apenas saída. Indica se o arquivo foi modificado por este usuário. |
| explicitlyTrashed | boolean Apenas saída. Indica se o arquivo foi movido para a lixeira explicitamente, em vez de recursivamente. |
| createdDate | string Apenas saída. Hora de criação do arquivo (carimbo de data/hora formatado RFC 3339). |
| modifiedDate | string A última vez que o arquivo foi modificado por alguém (carimbo de data/hora formatado RFC 3339). Só é mutável na atualização quando o parâmetro "setModifiedDate" está definido. |
| modifiedByMeDate | string Apenas saída. A última vez que o arquivo foi modificado pelo usuário (carimbo de data/hora formatado RFC 3339). Definir "modifiedDate" também atualiza a data "modifiedByMe" do usuário que definiu a data. |
| lastViewedByMeDate | string A última vez que o usuário acessou o arquivo (carimbo de data/hora formatado RFC 3339). |
| markedViewedByMeDate**(deprecated)** | string Apenas saída. Obsoleto. |
| sharedWithMeDate | string Apenas saída. Horário em que o arquivo foi compartilhado com o usuário (carimbo de data/hora formatado RFC 3339). |
| quotaBytesUsed | string (int64 format) Apenas saída. O número de bytes de cota usados por este arquivo. |
| 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 solicitante. |
| indexableText | object Atributos de texto indexáveis para o arquivo (só podem ser gravados) |
| indexableText.text | string O texto a ser indexado para este arquivo. |
| originalFilename | string O nome original do conteúdo enviado, se disponível, ou o valor original do campo title. 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 arquivo pertence ao usuário atual. Não é preenchido para itens em drives compartilhados. |
| canComment**(deprecated)** | boolean Apenas saída. Descontinuado: use capabilities/canComment. |
| shareable**(deprecated)** | boolean Apenas saída. Descontinuado: use capabilities/canShare. |
| fullFileExtension | string Apenas saída. A extensão completa do arquivo, extraída do título. Pode conter várias extensões concatenadas, como "tar.gz". Remover uma extensão do título não limpa esse campo, mas mudar a extensão no título atualiza o campo. Esse campo só é preenchido para arquivos com conteúdo armazenado no Google Drive, não para editores do Documentos ou arquivos de atalho. |
| isAppAuthorized | boolean Apenas saída. Se o arquivo foi criado ou aberto pelo app solicitante. |
| teamDriveId**(deprecated)** | string Apenas saída. Descontinuado: 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.canChangeRestrictedDownload**(deprecated)** | boolean Apenas saída. Obsoleto. |
| 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 Apenas saída. Descontinuado: use canReadDrive. |
| capabilities.canMoveTeamDriveItem**(deprecated)** | boolean Apenas saída. Descontinuado: 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 Apenas saída. Descontinuado: 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 Apenas saída. Descontinuado: use canMoveItemWithinDrive. |
| capabilities.canMoveItemOutOfTeamDrive**(deprecated)** | boolean Apenas saída. Descontinuado: 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 Apenas saída. Descontinuado: use canMoveChildrenOutOfDrive. |
| capabilities.canMoveChildrenWithinTeamDrive**(deprecated)** | boolean Apenas saída. Descontinuado: 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 Apenas saída. Se um usuário pode desativar as permissões herdadas. |
| capabilities.canEnableInheritedPermissions | boolean Apenas saída. 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 movido para a lixeira, o usuário que fez isso. Preenchido apenas para itens em drives compartilhados. |
| canReadRevisions**(deprecated)** | boolean Apenas saída. Descontinuado: use capabilities/canReadRevisions. |
| thumbnailVersion | string (int64 format) Apenas saída. A versão da miniatura para uso na invalidação do cache de miniaturas. |
| trashedDate | string Apenas saída. O horário em que o item foi movido para a lixeira (carimbo de data/hora RFC 3339 formatado). Preenchido apenas para itens em drives compartilhados. |
| thumbnail | object Uma miniatura do arquivo. Isso só será usado se não for possível gerar uma miniatura padrão. |
| thumbnail.image | string (bytes format) Os bytes codificados em Base64 seguros para URL da imagem em miniatura. Ele precisa estar em conformidade com a seção 5 da RFC 4648.Uma string codificada em base64. |
| thumbnail.mimeType | string O tipo MIME da miniatura. |
| imageMediaMetadata | object Apenas saída. Metadados sobre mídia de imagem. Isso só vai aparecer para tipos de imagem, e o conteúdo depende do que pode ser analisado no conteúdo da imagem. |
| 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.date | string Apenas saída. A data e a hora em que a foto foi tirada (carimbo de data/hora no formato 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 sobre mídia de vídeo. Isso só vai aparecer para tipos de vídeo. |
| 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.insert. |
| shortcutDetails.targetId | string O ID do arquivo a que o atalho aponta. Só pode ser definido em solicitações files.insert. |
| 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. |
ContentRestriction
Uma restrição para acessar o conteúdo do arquivo.
| Representação JSON |
|---|
| { "readOnly": boolean, "reason": string, "type": string, "restrictingUser": { object (User) }, "restrictionDate": 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. |
| restrictionDate | 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. |
| Métodos | |
|---|---|
| copy | Cria uma cópia do arquivo especificado. |
| delete | Exclui permanentemente um arquivo de propriedade do usuário sem movê-lo para a lixeira. |
| 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 inserção ou cópia. |
| get | Recebe os metadados ou o conteúdo de um arquivo por ID. |
| insert | Insere um novo arquivo. |
| 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. |
| patch | Atualiza os metadados e/ou o conteúdo de um arquivo. |
| touch | Defina o horário atual do servidor como o horário atualizado do arquivo. |
| trash | Move um arquivo para a lixeira. |
| untrash | Restaura um arquivo da lixeira. |
| 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. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.