REST Resource: files

Zasób: plik

Metadane pliku.

Niektóre metody zasobów (np. files.update) wymagają fileId. Aby pobrać identyfikator pliku, użyj metody files.list.

Zapis 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
}
Pola
kind

string

Tylko dane wyjściowe. Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#file".

driveId

string

Tylko dane wyjściowe. Identyfikator dysku współdzielonego, na którym znajduje się plik. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

fileExtension

string

Tylko dane wyjściowe. Ostatni element fullFileExtension. Ta funkcja jest dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.

copyRequiresWriterPermission

boolean

Określ, czy opcje kopiowania, drukowania i pobierania tego pliku powinny być wyłączone dla czytelników i komentujących.

md5Checksum

string

Tylko dane wyjściowe. Suma kontrolna MD5 zawartości pliku. Dotyczy to tylko plików z zawartością binarną na Dysku Google.

contentHints

object

dodatkowe informacje o zawartości pliku; W odpowiedziach te pola nigdy nie są wypełniane.

contentHints.indexableText

string

Tekst, który ma zostać zindeksowany w pliku, aby ulepszyć zapytania fullText. Długość pliku jest ograniczona do 128 KB i może zawierać elementy HTML.

contentHints.thumbnail

object

Miniatura pliku. Będzie ona używana tylko wtedy, gdy Dysk Google nie będzie mógł wygenerować standardowego miniatury.

contentHints.thumbnail.image

string (bytes format)

Dane miniatury zakodowane w formacie Base64 bezpiecznym dla adresów URL (RFC 4648 sekcja 5).

Ciąg znaków zakodowany w formacie Base64.

contentHints.thumbnail.mimeType

string

Typ MIME miniatury.

writersCanShare

boolean

Określa, czy użytkownicy z uprawnieniami tylko do wyświetlania mogą modyfikować uprawnienia pliku.writer Nie wypełniane w przypadku elementów na dyskach współdzielonych.

viewedByMe

boolean

Tylko dane wyjściowe. Określa, czy plik został wyświetlony przez tego użytkownika.

mimeType

string

Typ MIME pliku.

Jeśli nie zostanie podana żadna wartość, Dysk Google spróbuje automatycznie wykryć odpowiednią wartość z przesłanych treści. Wartości nie można zmienić, dopóki nie prześlesz nowej wersji.

Jeśli plik został utworzony za pomocą typu MIME Dokumentów Google, przesłane treści zostaną zaimportowane (jeśli to możliwe). Obsługiwane formaty importu są publikowane w sekcji Informacje o zasobie.

parents[]

string

Identyfikator folderu nadrzędnego zawierającego plik.

Plik może mieć tylko jeden folder nadrzędny. Podawanie większej liczby rodziców nie jest obsługiwane.

Jeśli nie zostanie określony w żądaniu utworzenia, plik zostanie umieszczony bezpośrednio w folderze Mojego dysku użytkownika. Jeśli nie zostanie określony w żądaniu kopiowania, plik odziedziczy dowolnego możliwego rodzica pliku źródłowego. Żądania aktualizacji plików muszą używać parametrów addParents i removeParents, aby zmodyfikować listę rodziców.

shared

boolean

Tylko dane wyjściowe. czy plik został udostępniony. Nie wypełniane w przypadku elementów na dyskach współdzielonych.

lastModifyingUser

object (User)

Tylko dane wyjściowe. Ostatni użytkownik, który zmodyfikował plik. To pole jest wypełniane tylko wtedy, gdy ostatnia modyfikacja została wprowadzona przez zalogowanego użytkownika.

owners[]

object (User)

Tylko dane wyjściowe. właściciela tego pliku, Tylko niektóre starsze pliki mogą mieć więcej niż 1 właściciela. W przypadku elementów na dyskach współdzielonych to pole nie jest wypełniane.

headRevisionId

string

Tylko dane wyjściowe. Identyfikator głównej wersji pliku. Ta funkcja jest obecnie dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.

sharingUser

object (User)

Tylko dane wyjściowe. Użytkownik, który udostępnił plik użytkownikowi przesyłającemu prośbę (w odpowiednich przypadkach).

size

string (int64 format)

Tylko dane wyjściowe. Rozmiar w bajtach plików blob i plików edytorów firm zewnętrznych. Nie będzie wypełniany w przypadku plików, które nie mają określonego rozmiaru, takich jak skróty czy foldery.

viewersCanCopyContent
(deprecated)

boolean

Wycofane: użyj w zastępstwie tego copyRequiresWriterPermission.

permissions[]

object (Permission)

Tylko dane wyjściowe. Pełna lista uprawnień do pliku. Ta opcja jest dostępna tylko wtedy, gdy użytkownik, który wysłał prośbę, może udostępnić plik. Nie wypełniane w przypadku elementów na dyskach współdzielonych.

hasThumbnail

boolean

Tylko dane wyjściowe. Czy ten plik ma miniaturę. Nie wskazuje, czy aplikacja przesyłająca żądanie ma dostęp do miniatury. Aby sprawdzić dostęp, sprawdź, czy występuje pole thumbnailLink.

spaces[]

string

Tylko dane wyjściowe. Lista pokoi zawierających plik. Obecnie obsługiwane wartości to „drive”, „appDataFolder” i „photos”.

folderColorRgb

string

Kolor folderu lub skrótu do folderu jako ciąg znaków szesnastkowych RGB. Obsługiwane kolory są publikowane w polu folderColorPalette zasobu Informacje.

Jeśli zostanie określony nieobsługiwany kolor, zamiast niego zostanie użyty najbliższy kolor z palety.

id

string

Identyfikator pliku.

name

string

Nazwa pliku. Nie musi być unikalny w obrębie folderu. Pamiętaj, że w przypadku elementów niezmiennych, takich jak foldery najwyższego poziomu na dyskach współdzielonych, folder główny Mojego dysku i folder Application Data, nazwa jest stała.

description

string

Krótki opis pliku.

starred

boolean

Czy użytkownik oznaczył plik gwiazdką.

trashed

boolean

czy plik został przeniesiony do kosza bezpośrednio lub z folderu nadrzędnego, który został przeniesiony do kosza. Tylko właściciel może przenieść plik do kosza, a inni użytkownicy nie mogą zobaczyć plików w koszu właściciela.

explicitlyTrashed

boolean

Tylko dane wyjściowe. czy plik został usunięty bezpośrednio, a nie w wyniku rekurencyjnego usunięcia z folderu nadrzędnego.

createdTime

string

Czas utworzenia pliku (format daty i godziny RFC 3339).

modifiedTime

string

Data ostatniej modyfikacji pliku przez dowolną osobę (format daty i godziny RFC 3339).

Pamiętaj, że ustawienie modifiedTime aktualizuje też ustawienie modifiedByMeTime dla danego użytkownika.

modifiedByMeTime

string

Tylko dane wyjściowe. Ostatnia data modyfikacji pliku przez użytkownika (format daty i godziny RFC 3339).

viewedByMeTime

string

Czas ostatniego wyświetlenia pliku przez użytkownika (format daty i godziny RFC 3339).

sharedWithMeTime

string

Tylko dane wyjściowe. Czas, w którym plik został udostępniony użytkownikowi (format daty i godziny według RFC 3339).

quotaBytesUsed

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów limitu miejsca na dane wykorzystanych przez plik. Obejmuje to wersję główną oraz wcześniejsze wersje z włączoną zasadą keepForever.

version

string (int64 format)

Tylko dane wyjściowe. Monotonicznie rosnący numer wersji pliku. Odzwierciedla wszystkie zmiany wprowadzone w pliku na serwerze, nawet te niewidoczne dla użytkownika.

originalFilename

string

Oryginalna nazwa przesłanych treści (jeśli jest dostępna) lub pierwotna wartość pola name. Ta funkcja jest dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.

ownedByMe

boolean

Tylko dane wyjściowe. Czy plik należy do użytkownika. Nie wypełniane w przypadku elementów na dyskach współdzielonych.

fullFileExtension

string

Tylko dane wyjściowe. Pełne rozszerzenie pliku wyodrębnione z pola name. Może zawierać wiele sprzężonych rozszerzeń, np. „tar.gz”. Ta funkcja jest dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.

Jest ono automatycznie aktualizowane po zmianie pola name, ale nie jest usuwane, jeśli nowa nazwa nie zawiera prawidłowego rozszerzenia.

properties

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

Zbiór dowolnych par klucz-wartość, które są widoczne dla wszystkich aplikacji.

Wpisy z wartościami null są usuwane w żądaniach aktualizacji i kopiowania.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

appProperties

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

Zbiór dowolnych par klucz-wartość, które są prywatne dla aplikacji przesyłającej żądanie.

Wpisy z wartościami null są usuwane w żądaniach aktualizacji i kopiowania.

Te właściwości można pobrać tylko za pomocą uwierzytelnionego żądania. Żądanie uwierzytelnione używa tokena dostępu uzyskanego za pomocą identyfikatora klienta OAuth 2. Nie możesz używać klucza interfejsu API do pobierania właściwości prywatnych.

Obiekt zawierający listę par "key": value. Przykład: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

isAppAuthorized

boolean

Tylko dane wyjściowe. Określa, czy plik został utworzony lub otwarty przez aplikację przesyłającą żądanie.

teamDriveId
(deprecated)

string

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny driveId.

capabilities

object

Tylko dane wyjściowe. Możliwości, które ma bieżący użytkownik w przypadku tego pliku. Każda z nich odpowiada szczegółowemu działaniu, które może wykonać użytkownik.

capabilities.canChangeViewersCanCopyContent
(deprecated)

boolean

Wycofane: tylko dane wyjściowe.

capabilities.canMoveChildrenOutOfDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenosić podfoldery tego folderu poza dysk współdzielony. Ta wartość jest równa fałsz, gdy element nie jest folderem. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canReadDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może odczytywać dysk współdzielony, do którego należy ten plik. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canEdit

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może edytować ten plik. Inne czynniki mogą ograniczać typ zmian, które użytkownik może wprowadzić w pliku. Na przykład canChangeCopyRequiresWriterPermission lub canModifyContent.

capabilities.canCopy

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może skopiować ten plik. W przypadku elementu na dysku współdzielonym określa, czy bieżący użytkownik może kopiować elementy podrzędne tego elementu, które nie są folderami, lub sam element, jeśli nie jest folderem.

capabilities.canComment

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może komentować ten plik.

capabilities.canAddChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać do tego foldera foldery podrzędne. Jest zawsze równa fałsz, gdy element nie jest folderem.

capabilities.canDelete

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usunąć ten plik.

capabilities.canDownload

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może pobrać ten plik.

capabilities.canListChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może wyświetlić podfoldery tego folderu. Jest zawsze równe fałsz, gdy element nie jest folderem.

capabilities.canRemoveChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać podfoldery z tego folderu. Jest zawsze równa fałsz, gdy element nie jest folderem. W przypadku folderu na dysku współdzielonym użyj polecenia canDeleteChildren lub canTrashChildren.

capabilities.canRename

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić nazwę tego pliku.

capabilities.canTrash

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść ten plik do kosza.

capabilities.canReadRevisions

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może odczytać zasób rewizji tego pliku. W przypadku elementu na dysku współdzielonym: czy można odczytać wersje potomne tego elementu, które nie są folderami, czy sam element, jeśli nie jest folderem.

capabilities.canReadTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj w zamian pola canMoveItemWithinDrive lub canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie copyRequiresWriterPermission tego pliku.

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny canMoveItemOutOfDrive.

capabilities.canUntrash

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przywrócić ten plik z kosza.

capabilities.canModifyContent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może modyfikować zawartość tego pliku.

capabilities.canMoveItemWithinTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać podfoldery tego folderu. Ta wartość jest równa fałsz, gdy element nie jest folderem. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Zamiast tego użyj kolumny canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usunąć elementy podrzędne tego folderu. Ta wartość jest równa fałsz, gdy element nie jest folderem. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canMoveItemOutOfDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść ten element poza ten dysk, zmieniając jego element nadrzędny. Pamiętaj, że żądanie zmiany elementu nadrzędnego może się nie powieść w zależności od dodanego nowego elementu nadrzędnego.

capabilities.canAddMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodać element nadrzędny do elementu bez usuwania istniejącego elementu nadrzędnego w ramach tego samego żądania. Nie wypełniane w przypadku plików na dysku współdzielonym.

capabilities.canRemoveMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usunąć element nadrzędny z elementu bez dodawania innego elementu nadrzędnego w ramach tej samej prośby. Nie wypełniane w przypadku plików na dysku współdzielonym.

capabilities.canMoveItemWithinDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść ten element na tym dysku. Pamiętaj, że prośba o zmianę elementu nadrzędnego może się nie powieść, w zależności od dodanego nowego elementu nadrzędnego i usuniętego elementu nadrzędnego.

capabilities.canShare

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może modyfikować ustawienia udostępniania tego pliku.

capabilities.canMoveChildrenWithinDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenosić podfoldery tego folderu na tym dysku. Ta wartość jest równa fałsz, gdy element nie jest folderem. Pamiętaj, że prośba o przeniesienie podfolderu może się nie powieść, ponieważ zależy od dostępu bieżącego użytkownika do podfolderu i folderu docelowego.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj jednej z tych wartości: canModifyEditorContentRestriction, canModifyOwnerContentRestriction lub canRemoveContentRestriction.

capabilities.canAddFolderFromAnotherDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodać do tego folderu folder z innego dysku (innego dysku współdzielonego lub Mojego dysku). Ta wartość jest równa fałsz, gdy element nie jest folderem. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canChangeSecurityUpdateEnabled

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić pole securityUpdateEnabled w metadanych udostępniania linku.

capabilities.canAcceptOwnership

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik jest właścicielem pliku oczekującym na zatwierdzenie. Nie wypełniane w przypadku plików na dysku współdzielonym.

capabilities.canReadLabels

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może odczytać etykiety pliku.

capabilities.canModifyLabels

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może modyfikować etykiety pliku.

capabilities.canModifyEditorContentRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać lub modyfikować ograniczenia treści w pliku, które są ograniczone do poziomu edytującego.

capabilities.canModifyOwnerContentRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać lub modyfikować ograniczenia treści, które są ograniczone przez właściciela.

capabilities.canRemoveContentRestriction

boolean

Tylko dane wyjściowe. Czy plik ma ograniczenie treści, które może zostać usunięte przez bieżącego użytkownika.

capabilities.canDisableInheritedPermissions

boolean

Określa, czy użytkownik może wyłączyć uprawnienia dziedziczone.

capabilities.canEnableInheritedPermissions

boolean

Określ, czy użytkownik może ponownie włączyć dziedziczone uprawnienia.

hasAugmentedPermissions

boolean

Tylko dane wyjściowe. Określa, czy plik ma uprawnienia bezpośrednio. To pole jest wypełniane tylko w przypadku elementów na dyskach współdzielonych.

trashingUser

object (User)

Tylko dane wyjściowe. Jeśli plik został usunięty, użytkownik, który go usunął. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

thumbnailVersion

string (int64 format)

Tylko dane wyjściowe. Wersja miniatury używana do unieważnienia pamięci podręcznej miniatur.

trashedTime

string

Tylko dane wyjściowe. Godzina, o której element został przeniesiony do kosza (format daty i godziny RFC 3339). Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

modifiedByMe

boolean

Tylko dane wyjściowe. Informacja, czy plik został zmodyfikowany przez tego użytkownika.

permissionIds[]

string

Tylko dane wyjściowe. Lista identyfikatorów uprawnień dla użytkowników z dostępem do tego pliku.

imageMediaMetadata

object

Tylko dane wyjściowe. dodatkowe metadane dotyczące multimediów z obrazem (jeśli są dostępne).

imageMediaMetadata.flashUsed

boolean

Tylko dane wyjściowe. Informacja o tym, czy do wykonania zdjęcia użyto lampy błyskowej.

imageMediaMetadata.meteringMode

string

Tylko dane wyjściowe. Tryb pomiaru ekspozycji użyty do utworzenia zdjęcia.

imageMediaMetadata.sensor

string

Tylko dane wyjściowe. Typ czujnika użytego do utworzenia zdjęcia.

imageMediaMetadata.exposureMode

string

Tylko dane wyjściowe. Tryb ekspozycji użyty do utworzenia zdjęcia.

imageMediaMetadata.colorSpace

string

Tylko dane wyjściowe. Przestrzeń barw zdjęcia.

imageMediaMetadata.whiteBalance

string

Tylko dane wyjściowe. Tryb balansu bieli użyty do utworzenia zdjęcia.

imageMediaMetadata.width

integer

Tylko dane wyjściowe. Szerokość obrazu w pikselach.

imageMediaMetadata.height

integer

Tylko dane wyjściowe. Wysokość obrazu w pikselach.

imageMediaMetadata.location

object

Tylko dane wyjściowe. Informacje o lokalizacji geograficznej zapisane w obrazie.

imageMediaMetadata.location.latitude

number

Tylko dane wyjściowe. Szerokość geograficzna zapisana w zrzucie ekranu.

imageMediaMetadata.location.longitude

number

Tylko dane wyjściowe. Długość geograficzna zapisana w obrazie.

imageMediaMetadata.location.altitude

number

Tylko dane wyjściowe. Wysokość zapisana w obrazie.

imageMediaMetadata.rotation

integer

Tylko dane wyjściowe. Liczba obrotów o 90 stopni w prawo zastosowanych do pierwotnej orientacji obrazu.

imageMediaMetadata.time

string

Tylko dane wyjściowe. Data i godzina wykonania zdjęcia (EXIF DateTime).

imageMediaMetadata.cameraMake

string

Tylko dane wyjściowe. Marka aparatu użytego do utworzenia zdjęcia.

imageMediaMetadata.cameraModel

string

Tylko dane wyjściowe. Model aparatu użytego do utworzenia zdjęcia.

imageMediaMetadata.exposureTime

number

Tylko dane wyjściowe. Czas ekspozycji w sekundach.

imageMediaMetadata.aperture

number

Tylko dane wyjściowe. Przysłona użyta do utworzenia zdjęcia (liczba przysłony).

imageMediaMetadata.focalLength

number

Tylko dane wyjściowe. Ogniskowa użyta do utworzenia zdjęcia w milimetrach.

imageMediaMetadata.isoSpeed

integer

Tylko dane wyjściowe. szybkość ISO użyta do utworzenia zdjęcia,

imageMediaMetadata.exposureBias

number

Tylko dane wyjściowe. Korekta ekspozycji zdjęcia (wartość APEX).

imageMediaMetadata.maxApertureValue

number

Tylko dane wyjściowe. Najmniejsza przysłona obiektywu przy ogniskowej użytej do utworzenia zdjęcia (wartość APEX).

imageMediaMetadata.subjectDistance

integer

Tylko dane wyjściowe. Odległość do obiektu na zdjęciu w metrach.

imageMediaMetadata.lens

string

Tylko dane wyjściowe. Obiektyw użyty do utworzenia zdjęcia.

videoMediaMetadata

object

Tylko dane wyjściowe. dodatkowe metadane dotyczące multimediów wideo; Może nie być ona dostępna od razu po przesłaniu.

videoMediaMetadata.width

integer

Tylko dane wyjściowe. Szerokość filmu w pikselach.

videoMediaMetadata.height

integer

Tylko dane wyjściowe. Wysokość filmu w pikselach.

videoMediaMetadata.durationMillis

string (int64 format)

Tylko dane wyjściowe. Czas trwania filmu w milisekundach.

shortcutDetails

object

Szczegóły pliku skrótu. Wartość jest podawana tylko w przypadku plików skrótów, w których polu mimeType ustawiono wartość application/vnd.google-apps.shortcut. Można je ustawić tylko w przypadku files.create.

shortcutDetails.targetId

string

Identyfikator pliku, do którego prowadzi skrót. Można je ustawić tylko w przypadku files.create.

shortcutDetails.targetMimeType

string

Tylko dane wyjściowe. Typ MIME pliku, do którego prowadzi skrót. Wartość tego pola to migawka typu MIME docelowego obiektu, który został utworzony podczas tworzenia skrótu.

shortcutDetails.targetResourceKey

string

Tylko dane wyjściowe. Klucz zasobu dla pliku docelowego.

contentRestrictions[]

object (ContentRestriction)

ograniczenia dostępu do treści pliku. Jest wypełnione tylko wtedy, gdy takie ograniczenie istnieje.

resourceKey

string

Tylko dane wyjściowe. Klucz potrzebny do uzyskania dostępu do elementu za pomocą udostępnionego linku.

linkShareMetadata.securityUpdateEligible

boolean

Tylko dane wyjściowe. Określa, czy plik kwalifikuje się do aktualizacji zabezpieczeń.

linkShareMetadata.securityUpdateEnabled

boolean

Tylko dane wyjściowe. Czy aktualizacja zabezpieczeń jest włączona dla tego pliku.

labelInfo

object

Tylko dane wyjściowe. Omówienie etykiet w pliku.

labelInfo.labels[]

object (Label)

Tylko dane wyjściowe. Zestaw etykiet w pliku zgodnie z identyfikatorami etykiet w parametrze includeLabels. Domyślnie nie są zwracane żadne etykiety.

sha1Checksum

string

Tylko dane wyjściowe. Suma kontrolna SHA1 powiązana z tym plikiem (jeśli jest dostępna). To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. Nie jest wypełniane w przypadku Edytorów Dokumentów ani plików skrótów.

sha256Checksum

string

Tylko dane wyjściowe. Suma kontrolna SHA256 powiązana z tym plikiem (jeśli jest dostępna). To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. Nie jest wypełniane w przypadku Edytorów Dokumentów ani plików skrótów.

inheritedPermissionsDisabled

boolean

Określa, czy w przypadku tego pliku wyłączono dziedziczone uprawnienia. Dziedziczone uprawnienia są domyślnie włączone.

ContentRestriction

Ograniczenie dostępu do treści pliku.

Zapis JSON
{
  "readOnly": boolean,
  "reason": string,
  "type": string,
  "restrictingUser": {
    object (User)
  },
  "restrictionTime": string,
  "ownerRestricted": boolean,
  "systemRestricted": boolean
}
Pola
readOnly

boolean

czy zawartość pliku jest tylko do odczytu. Jeśli plik jest tylko do odczytu, nie można dodać nowej wersji pliku, dodać ani zmodyfikować komentarzy ani zmienić tytułu pliku.

reason

string

Powód, dla którego treść pliku jest objęta ograniczeniami. Można go zmienić tylko w przypadku żądań, które mają też ustawioną wartość readOnly=true.

type

string

Tylko dane wyjściowe. Typ ograniczenia treści. Obecnie jedyną możliwą wartością jest globalContentRestriction.

restrictingUser

object (User)

Tylko dane wyjściowe. Użytkownik, który ustawił ograniczenie treści. Wypełniane tylko wtedy, gdy readOnly ma wartość Prawda.

restrictionTime

string

Tylko dane wyjściowe. Czas ustawienia ograniczenia treści (sygnatura czasowa w formacie RFC 3339). Wypełniane tylko wtedy, gdy readOnly ma wartość Prawda.

ownerRestricted

boolean

Określa, czy ograniczenie treści może być zmieniane lub usuwane tylko przez właściciela pliku. W przypadku plików na dyskach współdzielonych każdy użytkownik z uprawnieniami organizer może zmienić lub usunąć to ograniczenie treści.

systemRestricted

boolean

Tylko dane wyjściowe. Czy ograniczenie treści zostało zastosowane przez system, na przykład ze względu na podpis elektroniczny. Użytkownicy nie mogą modyfikować ani usuwać ograniczeń dotyczących treści objętych ograniczeniami systemowymi.

Metody

copy

Tworzy kopię pliku i wprowadza żądane zmiany z użyciem semantyki poprawki.

create

Tworzy nowy plik.

delete

Trwałe usunięcie pliku należącego do użytkownika bez przenoszenia go do kosza.

download

Pobiera zawartość pliku.

emptyTrash

Trwałe usunięcie wszystkich plików z kosza użytkownika.

export

Eksportuje dokument Google Workspace do żądanego typu MIME i zwraca wyeksportowane dane w bajtach.

generateIds

Generuje zestaw identyfikatorów plików, które można podać w żądaniach tworzenia lub kopiowania.

get

Pobiera metadane lub zawartość pliku według identyfikatora.

list

Wyświetla pliki użytkownika.

listLabels

Wyświetla etykiety pliku.

modifyLabels

Modyfikuje zbiór etykiet zastosowanych do pliku.

update

Zaktualizuje metadane lub zawartość pliku.

watch

Subskrybuje zmiany w pliku.