REST Resource: files

Zasób: Plik

Metadane pliku.

Niektóre metody zasobów (takie jak files.update) wymagają fileId. Użyj metody files.list, aby pobrać identyfikator pliku.

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
  },
  "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
}
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 komponent komponentu fullFileExtension. Ta funkcja jest dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.

copyRequiresWriterPermission

boolean

Opcje kopiowania, drukowania i pobierania pliku powinny być wyłączone dla czytelników i komentujących.

md5Checksum

string

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

contentHints

object

Dodatkowe informacje o zawartości pliku. Te pola nigdy nie są wypełniane w odpowiedziach.

contentHints.indexableText

string

Tekst do indeksowania w pliku w celu ulepszenia zapytań fullText. Jego długość 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 może wygenerować standardowej miniatury.

contentHints.thumbnail.image

string (bytes format)

Dane miniatury zakodowane przy użyciu bezpiecznego adresu URL w formacie Base64 (RFC 4648, sekcja 5).

Ciąg zakodowany w formacie base64.

contentHints.thumbnail.mimeType

string

Typ MIME miniatury.

writersCanShare

boolean

Określa, czy użytkownicy z uprawnieniami tylko do writer mogą zmieniać uprawnienia do pliku. Wartość nie jest wypełniona 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 podasz żadnej wartości, Dysk Google spróbuje automatycznie wykryć odpowiednią wartość na podstawie przesłanych treści. Nie można zmienić wartości, dopóki nie zostanie przesłana nowa wersja.

Jeśli plik został utworzony z typem MIME w Dokumentach Google, przesłana treść jest w miarę możliwości importowana. Obsługiwane formaty importu znajdziesz w sekcji Informacje.

parents[]

string

Identyfikator folderu nadrzędnego zawierającego plik.

Plik może mieć tylko 1 folder nadrzędny. nie można wskazać wielu elementów nadrzędnych.

Jeśli plik nie zostanie określony w prośbie o utworzenie, zostanie umieszczony bezpośrednio w folderze Mój dysk użytkownika. Jeśli nie podasz ich w żądaniu kopiowania, plik odziedziczy każdy możliwy do znalezienia element nadrzędny pliku źródłowego. Żądania files.update muszą używać parametrów addParents i removeParents do modyfikowania listy elementów nadrzędnych.

shared

boolean

Tylko dane wyjściowe. Określa, czy plik został udostępniony. Wartość nie jest wypełniona w przypadku elementów na dyskach współdzielonych.

lastModifyingUser

object (User)

Tylko dane wyjściowe. Użytkownik, który jako ostatni może 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ściciel tego pliku. Tylko niektóre starsze pliki mogą mieć więcej niż jednego właściciela. To pole nie jest wypełniane w przypadku elementów na dyskach współdzielonych.

headRevisionId

string

Tylko dane wyjściowe. Identyfikator wersji nagłówka pliku. Obecnie ta funkcja jest dostępna tylko w przypadku plików z treściami binarnymi na Dysku Google.

sharingUser

object (User)

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

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

Wycofane: użyj atrybutu copyRequiresWriterPermission.

permissions[]

object (Permission)

Tylko dane wyjściowe. Pełna lista uprawnień do pliku. Ta opcja jest dostępna tylko wtedy, gdy użytkownik wysyłający prośbę może udostępnić plik. Wartość nie jest wypełniona w przypadku elementów na dyskach współdzielonych.

hasThumbnail

boolean

Tylko dane wyjściowe. Określa, czy ten plik ma miniaturę. Nie wskazuje ona, czy aplikacja wysyłająca żądanie ma dostęp do miniatury. Aby sprawdzić dostęp, sprawdź, czy znajduje się pole do miniaturki Link.

spaces[]

string

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

folderColorRgb

string

Kolor folderu lub skrótu do folderu w postaci ciągu szesnastkowego RGB. Obsługiwane kolory są publikowane w polu folderColorPalette w zasobie Informacje.

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

id

string

Identyfikator pliku.

name

string

Nazwa pliku. Nie musi to być unikalne w obrębie folderu. Pamiętaj, że w przypadku elementów stałych, takich jak foldery najwyższego poziomu dysków współdzielonych, folder główny Mojego dysku i folder danych aplikacji, nazwa jest stała.

description

string

Krótki opis pliku.

starred

boolean

Określa, czy użytkownik oznaczył plik gwiazdką.

trashed

boolean

Określa, czy plik został przeniesiony do kosza – jawnie, czy z folderu nadrzędnego przeniesionego do kosza. Tylko właściciel może przenieść plik do kosza, a inni użytkownicy nie widzą jego plików w koszu.

explicitlyTrashed

boolean

Tylko dane wyjściowe. Określa, czy plik został jawnie usunięty do kosza, a nie rekurencyjnie z folderu nadrzędnego.

createdTime

string

Godzina utworzenia pliku (data i godzina w dokumencie RFC 3339).

modifiedTime

string

Czas ostatniej modyfikacji pliku przez dowolną osobę (data i godzina w dokumencie RFC 3339).

Pamiętaj, że ustawienie modifiedTime powoduje też zaktualizowanie modifiedByMeTime dla użytkownika.

modifiedByMeTime

string

Tylko dane wyjściowe. Czas ostatniej modyfikacji pliku przez użytkownika (data i godzina w dokumencie RFC 3339).

viewedByMeTime

string

Czas ostatniego wyświetlenia pliku przez użytkownika (data i godzina w dokumencie RFC 3339).

sharedWithMeTime

string

Tylko dane wyjściowe. Godzina udostępnienia pliku użytkownikowi (w stosownych przypadkach – data i godzina w dokumencie RFC 3339).

quotaBytesUsed

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów limitu miejsca na dane używanych przez plik. Obejmuje to wersję główną oraz wcześniejsze wersje z włączoną opcją 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

Pierwotna nazwa pliku z przesłaną treścią, jeśli jest dostępna, lub pierwotna wartość z 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. Określa, czy użytkownik jest właścicielem pliku. Wartość nie jest wypełniona 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 połączonych rozszerzeń, np. „tar.gz”. Ta funkcja jest dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.

Ta wartość jest automatycznie aktualizowana po zmianie pola name, ale nie jest wyczyszczona, 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ą czyszczone 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 wysyłającej żądanie.

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

Te właściwości można pobrać tylko za pomocą uwierzytelnionego żądania. Uwierzytelnione żądanie używa tokena dostępu uzyskanego z identyfikatorem klienta OAuth 2. Nie można używać klucza interfejsu API do pobierania usług 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ę wysyłającą żądanie.

teamDriveId
(deprecated)

string

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady driveId.

capabilities

object

Tylko dane wyjściowe. Uprawnienia bieżącego użytkownika dotyczące tego pliku. Każda możliwość 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 przenieść elementy podrzędne tego folderu poza dysk współdzielony. Ma wartość false (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, jakie użytkownik może wprowadzać w pliku. np. canChangeCopyRequiresWriterPermission lub canModifyContent.

capabilities.canCopy

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może skopiować ten plik. Określa, czy bieżący użytkownik może kopiować elementy potomne tego elementu poza folderem lub sam element, jeśli nie jest to folder.

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ć dzieci do tego folderu. Ta wartość ma zawsze wartość 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ć listę elementów podrzędnych tego folderu. Ta wartość ma zawsze wartość fałsz, gdy element nie jest folderem.

capabilities.canRemoveChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać dzieci z tego folderu. Ta wartość ma zawsze wartość fałsz, gdy element nie jest folderem. W przypadku folderu na dysku współdzielonym użyj elementu 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 odczytywać zasób wersji tego pliku. W przypadku elementu na dysku współdzielonym można odczytać wersje elementów potomnych tego elementu, które nie są folderami, a także sam element, jeśli nie jest to folder.

capabilities.canReadTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj interfejsu 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. Użyj w zamian zasady 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. Użyj w zamian zasady canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać elementy podrzędne tego folderu. Ma wartość false (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. Użyj w zamian zasady canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj w zamian zasady canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść do kosza elementy podrzędne tego folderu. Ma wartość false (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 w zależności od nowo dodawanego elementu nadrzędnego prośba o zmianę elementu nadrzędnego może nadal się nie powieść.

capabilities.canAddMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodać element nadrzędny dla elementu bez usuwania istniejącego elementu nadrzędnego w tej samej prośbie. Pole nie jest 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ąć rodzica z elementu bez dodawania kolejnego elementu nadrzędnego w tej samej prośbie. Pole nie jest 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 w obrębie tego dysku. Pamiętaj, że prośba o zmianę elementu nadrzędnego dla elementu może nadal się nie powieść w zależności od dodawanego nowego elementu nadrzędnego i elementu nadrzędnego, który chcesz usunąć.

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść elementy podrzędne tego folderu w obrębie tego dysku. Ma wartość false (fałsz), gdy element nie jest folderem. Pamiętaj, że prośba o przeniesienie elementu podrzędnego może nadal się nie powieść w zależności od uprawnień bieżącego użytkownika do folderu podrzędnego i do folderu docelowego.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj jednej z tych: 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). Ma wartość false (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 udziału linków.

capabilities.canAcceptOwnership

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik jest oczekującym właścicielem pliku. Pole nie jest 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 odczytywać etykiety pliku.

capabilities.canModifyLabels

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może modyfikować etykiety w 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 edytora.

capabilities.canModifyOwnerContentRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać lub modyfikować ograniczenia treści objęte ograniczeniami przez właściciela.

capabilities.canRemoveContentRestriction

boolean

Tylko dane wyjściowe. Określa, czy plik jest objęty ograniczeniem treści, który może usunąć bieżący użytkownik.

hasAugmentedPermissions

boolean

Tylko dane wyjściowe. Wskazuje, czy są uprawnienia bezpośrednio do tego pliku. 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ł przeniesiony do kosza bezpośrednio, wskazuje nazwę użytkownika, który go trafił do kosza. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

thumbnailVersion

string (int64 format)

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

trashedTime

string

Tylko dane wyjściowe. Czas usunięcia elementu do kosza (data i godzina w dokumencie RFC 3339). Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

modifiedByMe

boolean

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

permissionIds[]

string

Tylko dane wyjściowe. files.list z identyfikatorami uprawnień użytkowników z dostępem do tego pliku.

imageMediaMetadata

object

Tylko dane wyjściowe. Dodatkowe metadane multimediów (jeśli są dostępne).

imageMediaMetadata.flashUsed

boolean

Tylko dane wyjściowe. Określa, czy do utworzenia zdjęcia użyto lampy błyskowej.

imageMediaMetadata.meteringMode

string

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

imageMediaMetadata.sensor

string

Tylko dane wyjściowe. Rodzaj 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ń kolorów 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 przechowywane w obrazie.

imageMediaMetadata.location.latitude

number

Tylko dane wyjściowe. Szerokość geograficzna zapisana na obrazie.

imageMediaMetadata.location.longitude

number

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

imageMediaMetadata.location.altitude

number

Tylko dane wyjściowe. Wysokość zapisana na zdjęciu.

imageMediaMetadata.rotation

integer

Tylko dane wyjściowe. Liczba obrotów w prawo o 90 stopni wynikających z oryginalnej 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 trwania ekspozycji w sekundach.

imageMediaMetadata.aperture

number

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

imageMediaMetadata.focalLength

number

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

imageMediaMetadata.isoSpeed

integer

Tylko dane wyjściowe. Czułość 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 wartość przysłony obiektywu na ogniskowej, która została użyta do utworzenia zdjęcia (wartość APEX).

imageMediaMetadata.subjectDistance

integer

Tylko dane wyjściowe. Odległość od 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 multimediów wideo. Ta karta może nie być 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ść podawana tylko w przypadku plików skrótów, które w polu mimeType mają wartość application/vnd.google-apps.shortcut. Można go ustawić tylko dla files.create żądań.

shortcutDetails.targetId

string

Identyfikator pliku, do którego prowadzi ten skrót. Można go ustawić tylko dla files.create żądań.

shortcutDetails.targetMimeType

string

Tylko dane wyjściowe. Typ MIME pliku, który wskazuje ten skrót. Wartością tego pola jest migawka typu MIME celu, przechwycona podczas tworzenia skrótu.

shortcutDetails.targetResourceKey

string

Tylko dane wyjściowe. Wartość ResourceKey pliku docelowego.

contentRestrictions[]

object (ContentRestriction)

Ograniczenia dostępu do zawartości pliku. Wartość jest wypełniona 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. Określa, czy dla tego pliku jest włączona aktualizacja zabezpieczeń.

labelInfo

object

Tylko dane wyjściowe. Przegląd etykiet w pliku.

labelInfo.labels[]

object (Label)

Tylko dane wyjściowe. Zestaw etykiet w pliku żądanych przez identyfikatory 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łniona 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łniona w przypadku edytorów Dokumentów ani plików skrótów.

ContentRestriction

Ograniczenie dostępu do zawartości pliku.

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

boolean

Określa, czy treść pliku jest tylko do odczytu. Jeśli plik jest tylko do odczytu, nie można dodać do niego nowej wersji ani dodawać i modyfikować komentarzy, nie można też modyfikować nazwy pliku.

reason

string

Przyczyna ograniczenia zawartości pliku. Można ją zmienić tylko w przypadku żądań, w których ustawiono także readOnly=true.

type

string

Tylko dane wyjściowe. Rodzaj 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. Wartość jest wypełniona tylko wtedy, gdy readOnly ma wartość true (prawda).

restrictionTime

string

Tylko dane wyjściowe. Godzina ustawienia ograniczenia treści (sygnatura czasowa RFC 3339). Wartość jest wypełniona tylko wtedy, gdy readOnly ma wartość true (prawda).

ownerRestricted

boolean

Określa, czy ograniczenie treści może zmienić lub usunąć tylko użytkownik, do którego należy plik. 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. Informacja, czy system wprowadził ograniczenie dotyczące treści, na przykład z powodu e-podpisu. Użytkownicy nie mogą modyfikować ani usuwać ograniczeń treści ograniczonych przez system.

Metody

copy

Tworzy kopię pliku i stosuje wszystkie żądane aktualizacje z semantyką poprawki.

create

Tworzy nowy plik.

delete

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

emptyTrash

Powoduje trwałe usunięcie wszystkich znajdujących się w koszu plików użytkownika.

export

Powoduje wyeksportowanie dokumentu Google Workspace do żądanego typu MIME i zwrócenie wyeksportowanej zawartości bajtów.

generateIds

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

get

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

list

Wyświetla listę plików użytkownika.

listLabels

Wyświetla listę etykiet pliku.

modifyLabels

Modyfikuje zestaw etykiet zastosowanych do pliku.

update

Aktualizuje metadane lub treść pliku.

watch

Subskrybuje zmiany w pliku.