REST Resource: files

Zasób: Plik

Metadane pliku.

Niektóre metody zasobów (takie jak 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
  },
  "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 składnik funkcji fullFileExtension. Jest to możliwe tylko w przypadku plików z zawartością binarną na Dysku Google.

copyRequiresWriterPermission

boolean

Określa, czy opcje kopiowania, drukowania i pobierania pliku mają 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 zawartością binarną 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 zindeksowania w pliku w celu ulepszenia zapytań fullText. Rozmiar pliku nie może przekraczać 128 KB i może on 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 w formacie Base64 przeznaczonym do bezpiecznego przesyłania w adresie URL (sekcja 5 RFC 4648).

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. Brak wypełnienia w przypadku elementów na dyskach współdzielonych.

viewedByMe

boolean

Tylko dane wyjściowe. Wskazuje, 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. Tej wartości nie można zmienić, dopóki nie zostanie przesłana nowa wersja.

Jeśli plik został utworzony w formacie MIME dokumentu Google, przesłana treść jest importowana, o ile jest to możliwe. Obsługiwane formaty importu opisano w artykule „Informacje”.

parents[]

string

Identyfikatory folderów nadrzędnych, które zawierają plik.

Jeśli plik nie zostanie określony w żądaniu utworzenia, zostanie on umieszczony bezpośrednio w folderze Mój dysk użytkownika. Jeśli nie określono ich w żądaniu kopiowania, dziedziczy on wszystkie możliwe do znalezienia elementy nadrzędne 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. Brak wypełnienia w przypadku elementów na dyskach współdzielonych.

lastModifyingUser

object (User)

Tylko dane wyjściowe. Ostatni użytkownik, który zmodyfikował plik.

owners[]

object (User)

Tylko dane wyjściowe. Właściciel pliku. Tylko niektóre starsze pliki mogą mieć więcej niż jednego właściciela. W przypadku elementów na dyskach współdzielonych to pole jest puste.

headRevisionId

string

Tylko dane wyjściowe. Identyfikator wersji nagłówka 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 wysyłającemu prośbę (jeśli dotyczy).

size

string (int64 format)

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

viewersCanCopyContent
(deprecated)

boolean

Wycofane: zamiast tego użyj elementu copyRequiresWriterPermission.

permissions[]

object (Permission)

Tylko dane wyjściowe. Pełna lista uprawnień dotyczących pliku. Jest to możliwe tylko wtedy, gdy użytkownik wysyłający prośbę może udostępnić plik. Brak wypełnienia w przypadku elementów na dyskach współdzielonych.

hasThumbnail

boolean

Tylko dane wyjściowe. Określa, czy plik ma miniaturę. Nie wskazuje to, czy aplikacja, która wysłała żądanie, ma dostęp do miniatury. Aby sprawdzić dostęp, poszukaj pola miniaturyLink.

spaces[]

string

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

folderColorRgb

string

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

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

id

string

Identyfikator pliku.

name

string

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

description

string

Krótki opis pliku.

starred

boolean

Wskazuje, czy użytkownik oznaczył plik gwiazdką.

trashed

boolean

Określa, czy plik został przeniesiony do kosza – bezpośrednio lub z folderu nadrzędnego w koszu. Tylko właściciel może przenosić pliki do kosza, a inni użytkownicy nie widzą plików w koszu właściciela.

explicitlyTrashed

boolean

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

createdTime

string

Godzina utworzenia pliku (RFC 3339 data i godzina).

modifiedTime

string

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

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

modifiedByMeTime

string

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

viewedByMeTime

string

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

sharedWithMeTime

string

Tylko dane wyjściowe. Godzina udostępnienia pliku użytkownikowi (jeśli ma to zastosowanie) w formacie RFC 3339 (data i godzina).

quotaBytesUsed

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów limitu miejsca na dane używanych przez plik. Obejmuje to wersję nagłówka, a także poprzednie wersje z włączoną opcją keepForever.

version

string (int64 format)

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

originalFilename

string

Oryginalna nazwa pliku z przesłaną treścią (jeśli jest dostępna) lub pierwotna wartość pola name. Jest to możliwe 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. Brak wypełnienia 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”. Jest to możliwe 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 pobierać tylko za pomocą uwierzytelnionego żądania. Uwierzytelnione żądanie wykorzystuje token dostępu uzyskany za pomocą identyfikatora klienta OAuth 2. Nie można pobierać właściwości prywatnych za pomocą klucza interfejsu API.

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ę, która wysłała żą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 w tym 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. Ta wartość ma wartość false, jeśli 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ć rodzaj 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 skopiować elementy podrzędne tego elementu inne niż folder, czy 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ć elementy podrzędne 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świetlać 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ć elementy podrzędne z tego folderu. Ta wartość ma zawsze wartość 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 odczytywać zasób wersji tego pliku. W przypadku elementu na dysku współdzielonym można odczytywać zarówno wersje jego elementów podrzędnych innych niż folder, jak i 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 w zamian zasady canMoveItemWithinDrive lub canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie copyRequiresWriterPermission dotyczące 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 z tego folderu. Ta wartość ma wartość false, jeśli 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 przenosić do kosza elementy podrzędne tego folderu. Ta wartość ma wartość false, jeśli 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 prośba o zmianę elementu nadrzędnego nadal może się nie powieść w zależności od dodawanego nowego elementu nadrzędnego.

capabilities.canAddMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodać element nadrzędny elementu bez usuwania istniejącego elementu nadrzędnego w tym samym żądaniu. Wartość nie jest wypełniona 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 drugiego elementu nadrzędnego w tej samej prośbie. Wartość nie jest wypełniona 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 nadal może się nie powieść – zależy to od dodawanego nowego elementu nadrzędnego i usuwanego 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 przenieść elementy podrzędne tego folderu na tym dysku. Ta wartość ma wartość false, jeśli element nie jest folderem. Pamiętaj, że prośba o przeniesienie konta podrzędnego może się nadal zakończyć niepowodzeniem, jeśli ma on dostęp do konta podrzędnego i do folderu docelowego.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj jednej z tych opcji: 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ść ma wartość false, jeśli 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 linków.

capabilities.canAcceptOwnership

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik jest oczekiwanym właścicielem pliku. Wartość nie jest wypełniona 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 w 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ć i 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ć i modyfikować ograniczenia treści nałożone przez właściciela.

capabilities.canRemoveContentRestriction

boolean

Tylko dane wyjściowe. Określa, czy obecny użytkownik może usunąć ograniczenie treści w pliku.

hasAugmentedPermissions

boolean

Tylko dane wyjściowe. Określa, czy istnieją uprawnienia bezpośrednio do tego pliku. Pole jest wypełniane tylko w przypadku elementów na dyskach współdzielonych.

trashingUser

object (User)

Tylko dane wyjściowe. jeśli plik został jawnie przeniesiony do kosza – nazwa użytkownika, 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żniania pamięci podręcznej miniatur.

trashedTime

string

Tylko dane wyjściowe. Godzina przeniesienia elementu do kosza (RFC 3339 data i godzina). 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 identyfikatorów uprawnień użytkowników mających dostęp do tego pliku.

imageMediaMetadata

object

Tylko dane wyjściowe. Dodatkowe metadane dotyczące nośnika obrazó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. 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 przechowywane w obrazie.

imageMediaMetadata.location.latitude

number

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

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 zdjęciu.

imageMediaMetadata.rotation

integer

Tylko dane wyjściowe. Liczba obrót o 90 stopni w prawo od pierwotnej orientacji obrazu.

imageMediaMetadata.time

string

Tylko dane wyjściowe. Data i godzina zrobienia 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. Wartość przysłony użyta do utworzenia zdjęcia (liczba f).

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 (wartość APEX).

imageMediaMetadata.maxApertureValue

number

Tylko dane wyjściowe. Najmniejsza liczba F-obiektyw na obiektywie o ogniskowej, która została użyta do utworzenia zdjęcia (wartość APEX).

imageMediaMetadata.subjectDistance

integer

Tylko dane wyjściowe. Odległość do obiektu na zdjęciu wyrażona 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. Ta funkcja 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 mają pole mimeType ustawione na application/vnd.google-apps.shortcut.

shortcutDetails.targetId

string

Identyfikator pliku, do którego wskazuje ten skrót.

shortcutDetails.targetMimeType

string

Tylko dane wyjściowe. Typ MIME pliku, do którego prowadzi ten skrót. Wartością tego pola jest zrzut typu MIME środowiska docelowego, przechwycony 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. Pole wypełnione tylko wtedy, gdy istnieje takie ograniczenie.

resourceKey

string

Tylko dane wyjściowe. Aby uzyskać dostęp do elementu za pomocą udostępnionego linku, musisz mieć klucz.

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. Omówienie etykiet w pliku.

labelInfo.labels[]

object (Label)

Tylko dane wyjściowe. Zbiór 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ścią przechowywanej na Dysku Google. Nie jest ono 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ścią przechowywanej na Dysku Google. Nie jest ono wypełniane 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

Wskazuje, czy zawartość pliku jest dostępna tylko do odczytu. Jeśli plik jest tylko do odczytu, nie można dodać jego nowej wersji, nie można dodawać ani modyfikować komentarzy, a tytułu nie można zmienić.

reason

string

Przyczyna ograniczenia treści pliku. Tę funkcję można zmienić tylko w przypadku żądań, które również mają ustawioną funkcję readOnly=true.

type

string

Tylko dane wyjściowe. Typ ograniczenia dotyczącego 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. Pole wypełnione tylko wtedy, gdy zasada readOnly ma wartość prawda.

restrictionTime

string

Tylko dane wyjściowe. Czas, w którym zostało ustawione ograniczenie treści (sygnatura czasowa w formacie RFC 3339). Pole wypełnione tylko wtedy, gdy zasada readOnly ma wartość prawda.

ownerRestricted

boolean

Określa, czy ograniczenie treści może zmienić lub usunąć tylko użytkownik, który jest właścicielem pliku. W przypadku plików na dyskach współdzielonych każdy użytkownik z uprawnieniami organizer może zmodyfikować lub usunąć to ograniczenie treści.

systemRestricted

boolean

Tylko dane wyjściowe. Czy ograniczenie dotyczące treści zostało zastosowane przez system, na przykład w wyniku e-podpisu. Użytkownicy nie mogą zmieniać ani usuwać ograniczeń dotyczących treści podlegających ograniczeniom.

Metody

copy

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

create

Tworzy nowy plik.

delete

Trwale usuwa plik należący do użytkownika bez przenoszenia go do kosza.

emptyTrash

Trwale usuwa wszystkie znajdujące się w koszu pliki użytkownika.

export

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

generateIds

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

get

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

list

Zawiera listę plików użytkownika.

listLabels

Wyświetla listę etykiet pliku.

modifyLabels

Modyfikuje zestaw etykiet zastosowanych do pliku.

update

Aktualizuje metadane lub zawartość pliku.

watch

Subskrybuje zmiany w pliku.