Ta strona została przetłumaczona przez Cloud Translation API.

REST Resource: files

Zasób: File
Metody

Zasób: File

Metadane pliku.

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

Zapis JSON

Zapis JSON
{ "exportLinks": { string: string, ... }, "parents": [ string ], "owners": [ { object (`User`) } ], "permissions": [ { object (`Permission`) } ], "spaces": [ string ], "properties": { string: value, ... }, "appProperties": { string: value, ... }, "permissionIds": [ string ], "contentRestrictions": [ { object (`ContentRestriction`) } ], "kind": string, "driveId": string, "fileExtension": string, "copyRequiresWriterPermission": boolean, "md5Checksum": string, "contentHints": { "indexableText": string, "thumbnail": { "image": string, "mimeType": string } }, "writersCanShare": boolean, "viewedByMe": boolean, "mimeType": string, "thumbnailLink": string, "iconLink": string, "shared": boolean, "lastModifyingUser": { object (`User`) }, "headRevisionId": string, "sharingUser": { object (`User`) }, "webViewLink": string, "webContentLink": string, "size": string, "viewersCanCopyContent": boolean, "hasThumbnail": boolean, "folderColorRgb": string, "id": string, "name": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "createdTime": string, "modifiedTime": string, "modifiedByMeTime": string, "viewedByMeTime": string, "sharedWithMeTime": string, "quotaBytesUsed": string, "version": string, "originalFilename": string, "ownedByMe": boolean, "fullFileExtension": string, "isAppAuthorized": boolean, "teamDriveId": string, "capabilities": { "canChangeViewersCanCopyContent": boolean, "canMoveChildrenOutOfDrive": boolean, "canReadDrive": boolean, "canEdit": boolean, "canCopy": boolean, "canComment": boolean, "canAddChildren": boolean, "canDelete": boolean, "canDownload": boolean, "canListChildren": boolean, "canRemoveChildren": boolean, "canRename": boolean, "canTrash": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canMoveTeamDriveItem": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canMoveItemIntoTeamDrive": boolean, "canUntrash": boolean, "canModifyContent": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canDeleteChildren": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canTrashChildren": boolean, "canMoveItemOutOfDrive": boolean, "canAddMyDriveParent": boolean, "canRemoveMyDriveParent": boolean, "canMoveItemWithinDrive": boolean, "canShare": boolean, "canMoveChildrenWithinDrive": boolean, "canModifyContentRestriction": boolean, "canAddFolderFromAnotherDrive": boolean, "canChangeSecurityUpdateEnabled": boolean, "canAcceptOwnership": boolean, "canReadLabels": boolean, "canModifyLabels": boolean, "canModifyEditorContentRestriction": boolean, "canModifyOwnerContentRestriction": boolean, "canRemoveContentRestriction": boolean, "canDisableInheritedPermissions": boolean, "canEnableInheritedPermissions": boolean, "canChangeItemDownloadRestriction": boolean }, "hasAugmentedPermissions": boolean, "trashingUser": { object (`User`) }, "thumbnailVersion": string, "trashedTime": string, "modifiedByMe": boolean, "imageMediaMetadata": { "flashUsed": boolean, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "width": integer, "height": integer, "location": { "latitude": number, "longitude": number, "altitude": number }, "rotation": integer, "time": string, "cameraMake": string, "cameraModel": string, "exposureTime": number, "aperture": number, "focalLength": number, "isoSpeed": integer, "exposureBias": number, "maxApertureValue": number, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean }, "labelInfo": { "labels": [ { object (`Label`) } ] }, "sha1Checksum": string, "sha256Checksum": string, "inheritedPermissionsDisabled": boolean, "downloadRestrictions": { object (`DownloadRestrictionsMetadata`) } }

{
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    string
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "properties": {
    string: value,
    ...
  },
  "appProperties": {
    string: value,
    ...
  },
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "driveId": string,
  "fileExtension": string,
  "copyRequiresWriterPermission": boolean,
  "md5Checksum": string,
  "contentHints": {
    "indexableText": string,
    "thumbnail": {
      "image": string,
      "mimeType": string
    }
  },
  "writersCanShare": boolean,
  "viewedByMe": boolean,
  "mimeType": string,
  "thumbnailLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "headRevisionId": string,
  "sharingUser": {
    object (User)
  },
  "webViewLink": string,
  "webContentLink": string,
  "size": string,
  "viewersCanCopyContent": boolean,
  "hasThumbnail": boolean,
  "folderColorRgb": string,
  "id": string,
  "name": string,
  "description": string,
  "starred": boolean,
  "trashed": boolean,
  "explicitlyTrashed": boolean,
  "createdTime": string,
  "modifiedTime": string,
  "modifiedByMeTime": string,
  "viewedByMeTime": string,
  "sharedWithMeTime": string,
  "quotaBytesUsed": string,
  "version": string,
  "originalFilename": string,
  "ownedByMe": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeViewersCanCopyContent": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean,
    "canChangeItemDownloadRestriction": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "thumbnailVersion": string,
  "trashedTime": string,
  "modifiedByMe": boolean,
  "imageMediaMetadata": {
    "flashUsed": boolean,
    "meteringMode": string,
    "sensor": string,
    "exposureMode": string,
    "colorSpace": string,
    "whiteBalance": string,
    "width": integer,
    "height": integer,
    "location": {
      "latitude": number,
      "longitude": number,
      "altitude": number
    },
    "rotation": integer,
    "time": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean,
  "downloadRestrictions": {
    object (DownloadRestrictionsMetadata)
  }
}

Pola
`exportLinks`	`map (key: string, value: string)` Tylko dane wyjściowe. Linki do eksportowania plików Edytorów Dokumentów w określonych formatach. Obiekt zawierający listę par `"key": value`. Przykład: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`.
`parents[]`	`string` Identyfikator folderu nadrzędnego zawierającego plik. Plik może mieć tylko 1 folder nadrzędny. Określanie wielu folderów nadrzędnych nie jest obsługiwane. Jeśli nie zostanie określony w ramach prośby o utworzenie, plik zostanie umieszczony bezpośrednio w folderze Mój dysk użytkownika. Jeśli nie zostanie określony w ramach żądania kopiowania, plik dziedziczy dowolny wykrywalny element nadrzędny pliku źródłowego. Żądania aktualizacji muszą używać parametrów `addParents` i `removeParents` do modyfikowania listy elementów nadrzędnych.
`owners[]`	`object (User)` Tylko dane wyjściowe. właściciela 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 nie jest wypełniane.
`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. Nie jest wypełniana w przypadku elementów na dyskach współdzielonych.
`spaces[]`	`string` Tylko dane wyjściowe. Lista pokoi, w których znajduje się plik. Obecnie obsługiwane wartości to `drive`, `appDataFolder` i `photos`.
`properties`	`map (key: string, value: value (Value format))` Zbiór dowolnych par klucz-wartość widocznych dla wszystkich aplikacji. Wpisy z wartościami null są usuwane w przypadku żądań 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ą usuwane w przypadku żądań aktualizacji i kopiowania. Te usługi można pobrać tylko za pomocą uwierzytelnionego żądania. Uwierzytelnione żądanie używa tokena dostępu uzyskanego za pomocą identyfikatora klienta OAuth 2.0. Nie możesz 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" }`.
`permissionIds[]`	`string` Tylko dane wyjściowe. Lista identyfikatorów uprawnień użytkowników, którzy mają dostęp do tego pliku.
`contentRestrictions[]`	`object (ContentRestriction)` Ograniczenia dostępu do zawartości pliku. Wartość jest podawana tylko wtedy, gdy takie ograniczenie istnieje.
`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 `fullFileExtension`. Ta funkcja jest dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.
`copyRequiresWriterPermission`	`boolean` Określa, czy opcje kopiowania, drukowania i pobierania tego pliku mają 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. Te pola nigdy nie są wypełniane w odpowiedziach.
`contentHints.indexableText`	`string` Tekst do zindeksowania w pliku, aby ulepszyć zapytania fullText. Długość tego pola jest ograniczona do 128 KB i może ono zawierać elementy HTML.
`contentHints.thumbnail`	`object` Miniatura pliku. Będzie ona używana tylko wtedy, gdy Dysk Google nie będzie mógł wygenerować standardowej miniatury.
`contentHints.thumbnail.image`	`string (bytes format)` Dane miniatury zakodowane w formacie Base64 przeznaczonym do bezpiecznego przesyłania w adresie URL (RFC 4648, sekcja 5). Ciąg tekstowy zakodowany w formacie Base64.
`contentHints.thumbnail.mimeType`	`string` Typ MIME miniatury.
`writersCanShare`	`boolean` Czy użytkownicy z uprawnieniami `writer` mogą modyfikować uprawnienia do pliku. Nie jest wypełniana 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ć tej wartości, chyba że prześlesz nową wersję. Jeśli plik zostanie utworzony z użyciem typu MIME Dokumentu Google, przesłana treść zostanie zaimportowana, jeśli to możliwe. Obsługiwane formaty importu są publikowane w zasobie `about`.
`thumbnailLink`	`string` Tylko dane wyjściowe. krótkotrwały link do miniatury pliku (jeśli jest dostępny); Zwykle trwa kilka godzin. Nie jest przeznaczony do bezpośredniego użycia w aplikacjach internetowych ze względu na zasady Cross-Origin Resource Sharing (CORS). Rozważ użycie serwera proxy. Wypełniane tylko wtedy, gdy aplikacja wysyłająca żądanie ma dostęp do zawartości pliku. Jeśli plik nie jest udostępniony publicznie, adres URL zwrócony w elemencie `files.thumbnailLink` musi zostać pobrany za pomocą żądania z użyciem danych logowania.
`iconLink`	`string` Tylko dane wyjściowe. Statyczny, nieuwierzytelniony link do ikony pliku.
`shared`	`boolean` Tylko dane wyjściowe. czy plik został udostępniony; Nie jest wypełniana 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 przeprowadzona przez zalogowanego użytkownika.
`headRevisionId`	`string` Tylko dane wyjściowe. Identyfikator najnowszej 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 wysyłającemu prośbę (w odpowiednich przypadkach);
`webViewLink`	`string` Tylko dane wyjściowe. Link do otwarcia pliku w odpowiednim edytorze lub przeglądarce Google w przeglądarce.
`webContentLink`	`string` Tylko dane wyjściowe. Link do pobrania zawartości pliku w przeglądarce. Ta funkcja jest dostępna tylko w przypadku plików z zawartością binarną na Dysku Google.
`size`	`string (int64 format)` Tylko dane wyjściowe. Rozmiar w bajtach plików blob i plików edytorów Google Workspace. Nie jest wypełniana w przypadku plików, które nie mają określonego rozmiaru, takich jak skróty czy foldery.
`viewersCanCopyContent (deprecated)`	`boolean` Ten element został wycofany. Wycofana: zamiast niej używaj zasady `copyRequiresWriterPermission`.
`hasThumbnail`	`boolean` Tylko dane wyjściowe. Czy ten plik ma miniaturę. Nie oznacza to, że aplikacja zgłaszająca prośbę ma dostęp do miniatury. Aby sprawdzić dostęp, poszukaj pola thumbnailLink.
`folderColorRgb`	`string` Kolor folderu lub skrótu do folderu jako ciąg szesnastkowy RGB. Obsługiwane kolory są publikowane w polu `folderColorPalette` zasobu `about`. Jeśli podasz 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 niezmiennych elementów, takich jak foldery najwyższego poziomu na dyskach współdzielonych, folder główny Mojego dysku i folder Dane aplikacji, nazwa jest stała.
`description`	`string` Krótki opis pliku.
`starred`	`boolean` Informacja, 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 widzą plików w koszu właściciela.
`explicitlyTrashed`	`boolean` Tylko dane wyjściowe. czy plik został usunięty do kosza bezpośrednio, a nie w wyniku usunięcia do kosza folderu nadrzędnego.
`createdTime`	`string` Czas utworzenia pliku (data i godzina w formacie RFC 3339).
`modifiedTime`	`string` Ostatnia modyfikacja pliku przez dowolną osobę (data i godzina w formacie RFC 3339). Pamiętaj, że ustawienie `modifiedTime` aktualizuje też ustawienie `modifiedByMeTime` dla użytkownika.
`modifiedByMeTime`	`string` Tylko dane wyjściowe. Ostatnia modyfikacja pliku przez użytkownika (data i godzina w formacie RFC 3339).
`viewedByMeTime`	`string` Ostatni raz, kiedy plik był wyświetlany przez użytkownika (data i godzina w formacie RFC 3339).
`sharedWithMeTime`	`string` Tylko dane wyjściowe. Czas, w którym plik został udostępniony użytkownikowi, jeśli ma to zastosowanie (data i godzina w formacie 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. Numer wersji pliku, który rośnie monotonicznie. Odzwierciedla wszystkie zmiany wprowadzone w pliku na serwerze, nawet te niewidoczne dla użytkownika.
`originalFilename`	`string` Oryginalna nazwa przesłanej treści, jeśli jest dostępna, lub oryginalna 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 użytkownik jest właścicielem pliku. Nie jest wypełniana 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. Jest on automatycznie aktualizowany, gdy zmienia się pole `name`, ale nie jest czyszczony, jeśli nowa nazwa nie zawiera prawidłowego rozszerzenia.
`isAppAuthorized`	`boolean` Tylko dane wyjściowe. Określa, czy plik został utworzony lub otwarty przez aplikację wysyłającą żądanie.
`teamDriveId (deprecated)`	`string` Ten element został wycofany. Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady `driveId`.
`capabilities`	`object` Tylko dane wyjściowe. Uprawnienia bieżącego użytkownika do tego pliku. Każda funkcja odpowiada szczegółowemu działaniu, które może wykonać użytkownik. Więcej informacji znajdziesz w artykule Omówienie możliwości plików.
`capabilities.canChangeViewersCanCopyContent (deprecated)`	`boolean` Wycofane: tylko dane wyjściowe.
`capabilities.canMoveChildrenOutOfDrive`	`boolean` Tylko dane wyjściowe. Określa, czy obecny użytkownik może przenosić elementy podrzędne tego folderu poza dysk współdzielony. Wartość `false`, 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 obecny 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 obecny użytkownik może edytować ten plik. Inne czynniki mogą ograniczać typ zmian, jakie użytkownik może wprowadzać 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 ten element, jeśli nie jest folderem.
`capabilities.canComment`	`boolean` Tylko dane wyjściowe. Określa, czy obecny użytkownik może komentować ten plik.
`capabilities.canAddChildren`	`boolean` Tylko dane wyjściowe. Określa, czy obecny użytkownik może dodawać dzieci do tego folderu. Jeśli element nie jest folderem, zawsze ma wartość `false`.
`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. Jeśli element nie jest folderem, zawsze ma wartość `false`.
`capabilities.canRemoveChildren`	`boolean` Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać dzieci z tego folderu. Jeśli element nie jest folderem, zawsze ma wartość `false`. W przypadku folderu na dysku współdzielonym użyj zamiast tego `canDeleteChildren` lub `canTrashChildren`.
`capabilities.canRename`	`boolean` Tylko dane wyjściowe. Określa, czy obecny użytkownik może zmienić nazwę tego pliku.
`capabilities.canTrash`	`boolean` Tylko dane wyjściowe. Określa, czy obecny 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 wersji tego pliku. Określa, czy można odczytywać wersje elementów niebędących folderami, które są potomkami tego elementu, lub ten element, jeśli nie jest folderem.
`capabilities.canReadTeamDrive (deprecated)`	`boolean` Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady `canReadDrive`.
`capabilities.canMoveTeamDriveItem (deprecated)`	`boolean` Wycofane: tylko dane wyjściowe. Zamiast tego użyj zdarzenia `canMoveItemWithinDrive` lub `canMoveItemOutOfDrive`.
`capabilities.canChangeCopyRequiresWriterPermission`	`boolean` Tylko dane wyjściowe. Określa, czy obecny użytkownik może zmienić ograniczenie `copyRequiresWriterPermission` tego pliku.
`capabilities.canMoveItemIntoTeamDrive (deprecated)`	`boolean` Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady `canMoveItemOutOfDrive`.
`capabilities.canUntrash`	`boolean` Tylko dane wyjściowe. Czy bieżący użytkownik może przywrócić ten plik z kosza.
`capabilities.canModifyContent`	`boolean` Tylko dane wyjściowe. Określa, czy obecny użytkownik może modyfikować zawartość tego pliku.
`capabilities.canMoveItemWithinTeamDrive (deprecated)`	`boolean` Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady `canMoveItemWithinDrive`.
`capabilities.canMoveItemOutOfTeamDrive (deprecated)`	`boolean` Wycofane: tylko dane wyjściowe. Zamiast niej używaj zasady `canMoveItemOutOfDrive`.
`capabilities.canDeleteChildren`	`boolean` Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać elementy podrzędne tego folderu. Wartość `false`, 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 niej używaj zasady `canMoveChildrenOutOfDrive`.
`capabilities.canMoveChildrenWithinTeamDrive (deprecated)`	`boolean` Wycofane: tylko dane wyjściowe. Zamiast niej używaj 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. Wartość `false`, 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 folder nadrzędny. Pamiętaj, że prośba o zmianę elementu nadrzędnego 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 do elementu bez usuwania istniejącego elementu nadrzędnego w tej samej prośbie. Nie jest wypełniana 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 innego rodzica w tej samej prośbie. Nie jest wypełniana w przypadku plików na dysku współdzielonym.
`capabilities.canMoveItemWithinDrive`	`boolean` Tylko dane wyjściowe. Określa, czy obecny użytkownik może przenieść ten element w obrębie tego dysku. Pamiętaj, że prośba o zmianę elementu nadrzędnego może nadal się nie powieść w zależności od nowego elementu nadrzędnego, który jest dodawany, i elementu nadrzędnego, który jest usuwany.
`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 obecny użytkownik może przenosić elementy podrzędne tego folderu w ramach tego dysku. Wartość `false`, gdy element nie jest folderem. Pamiętaj, że prośba o przeniesienie dziecka może się nie powieść w zależności od dostępu bieżącego użytkownika do dziecka 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). Wartość `false`, 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 obecny użytkownik jest oczekującym właścicielem pliku. Nie jest wypełniana 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ć lub modyfikować ograniczenia dotyczące treści w pliku, które są ograniczone dla edytujących.
`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 do właściciela.
`capabilities.canRemoveContentRestriction`	`boolean` Tylko dane wyjściowe. Czy na pliku obowiązuje ograniczenie treści, które może zostać usunięte przez bieżącego użytkownika.
`capabilities.canDisableInheritedPermissions`	`boolean` Czy użytkownik może wyłączyć uprawnienia dziedziczone.
`capabilities.canEnableInheritedPermissions`	`boolean` Czy użytkownik może ponownie włączyć dziedziczone uprawnienia.
`capabilities.canChangeItemDownloadRestriction`	`boolean` Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenia pobierania pliku zastosowane przez właściciela lub organizatora.
`hasAugmentedPermissions`	`boolean` Tylko dane wyjściowe. Określa, czy ten plik ma bezpośrednie uprawnienia. 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ł wyraźnie przeniesiony do kosza, użytkownik, który to zrobił. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.
`thumbnailVersion`	`string (int64 format)` Tylko dane wyjściowe. Wersja miniatury do użycia w procesie unieważniania pamięci podręcznej miniatur.
`trashedTime`	`string` Tylko dane wyjściowe. Czas przeniesienia elementu do kosza (data i godzina w formacie 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.
`imageMediaMetadata`	`object` Tylko dane wyjściowe. Dodatkowe metadane dotyczące nośnika obrazu, jeśli są dostępne.
`imageMediaMetadata.flashUsed`	`boolean` Tylko dane wyjściowe. Informacja, czy do zrobienia zdjęcia użyto lampy błyskowej.
`imageMediaMetadata.meteringMode`	`string` Tylko dane wyjściowe. Tryb pomiaru światła 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ń 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 zapisane 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ść przechowywana w obrazie.
`imageMediaMetadata.rotation`	`integer` Tylko dane wyjściowe. Liczba obrotów o 90 stopni w prawo zastosowanych 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 zrobienia 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 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 zdjęcia (wartość APEX).
`imageMediaMetadata.maxApertureValue`	`number` Tylko dane wyjściowe. Najmniejsza liczba f obiektywu przy ogniskowej użytej 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 zrobienia zdjęcia.
`videoMediaMetadata`	`object` Tylko dane wyjściowe. Dodatkowe metadane dotyczące multimediów wideo. 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ść jest podawana tylko w przypadku plików skrótów, w których pole mimeType ma wartość `application/vnd.google-apps.shortcut`. Można go ustawić tylko w przypadku żądań `files.create`.
`shortcutDetails.targetId`	`string` Identyfikator pliku, do którego prowadzi ten skrót. Można go ustawić tylko w przypadku żądań `files.create`.
`shortcutDetails.targetMimeType`	`string` Tylko dane wyjściowe. Typ MIME pliku, do którego prowadzi ten skrót. Wartość tego pola to migawka typu MIME elementu docelowego, która została zrobiona podczas tworzenia skrótu.
`shortcutDetails.targetResourceKey`	`string` Tylko dane wyjściowe. `resourceKey` pliku docelowego.
`resourceKey`	`string` Tylko dane wyjściowe. Klucz potrzebny do uzyskania dostępu do elementu za pomocą udostępnionego linku.
`linkShareMetadata`	`object` Tylko dane wyjściowe. Szczegóły dotyczące LinkShare. Zawiera szczegółowe informacje o adresach URL linków, których klienci używają do odsyłania do tego produktu.
`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 aktualizacja zabezpieczeń jest włączona w tym pliku.
`labelInfo`	`object` Tylko dane wyjściowe. Przegląd 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, których zawartość jest przechowywana na Dysku Google. Nie jest wypełniane w przypadku plików 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, których zawartość jest przechowywana na Dysku Google. Nie jest wypełniane w przypadku plików edytorów Dokumentów ani plików skrótów.
`inheritedPermissionsDisabled`	`boolean` Określa, czy ten plik ma wyłączone dziedziczenie uprawnień. Dziedziczone uprawnienia są domyślnie włączone.
`downloadRestrictions`	`object (DownloadRestrictionsMetadata)` Plik jest objęty ograniczeniami pobierania.

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` Informacja, czy zawartość pliku jest tylko do odczytu. Jeśli plik jest tylko do odczytu, nie można dodać nowej wersji pliku, dodawać ani modyfikować komentarzy ani zmieniać tytułu pliku.
`reason`	`string` Powód, dla którego zawartość pliku podlega ograniczeniom. Można go zmieniać tylko w przypadku żądań, w których ustawiono też parametr `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. Wypełniane tylko w przypadku parametru `readOnly=true`.
`restrictionTime`	`string` Tylko dane wyjściowe. Czas, w którym nałożono ograniczenie treści (w formacie daty i godziny RFC 3339). Wypełniane tylko w przypadku parametru `readOnly=true`.
`ownerRestricted`	`boolean` Czy ograniczenie treści może być modyfikowane lub usuwane tylko przez użytkownika, 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 treści zostało zastosowane przez system, np. ze względu na podpis elektroniczny. Użytkownicy nie mogą modyfikować ani usuwać ograniczeń dotyczących treści objętych ograniczeniami systemowymi.

DownloadRestrictionsMetadata

Plik jest objęty ograniczeniami pobierania.

Zapis JSON
{ "itemDownloadRestriction": { object (`DownloadRestriction`) }, "effectiveDownloadRestrictionWithContext": { object (`DownloadRestriction`) } }

Pola

itemDownloadRestriction

object (DownloadRestriction)

Ograniczenie pobierania pliku zastosowane bezpośrednio przez właściciela lub organizatora. Nie uwzględnia to ustawień dysku współdzielonego ani reguł DLP.

effectiveDownloadRestrictionWithContext

object (DownloadRestriction)

Tylko dane wyjściowe. Obowiązujące ograniczenie pobierania zastosowane do tego pliku. Uwzględnia wszystkie ustawienia ograniczeń i reguły DLP.

DownloadRestriction

Ograniczenie dotyczące kopiowania i pobierania pliku.

Zapis JSON
{ "restrictedForReaders": boolean, "restrictedForWriters": boolean }

Pola

Pola
`restrictedForReaders`	`boolean` Określa, czy pobieranie i kopiowanie jest ograniczone dla czytelników.
`restrictedForWriters`	`boolean` Określa, czy pobieranie i kopiowanie jest ograniczone dla autorów. Jeśli `true`, pobieranie jest też ograniczone dla czytelników.

restrictedForReaders

boolean

Określa, czy pobieranie i kopiowanie jest ograniczone dla czytelników.

restrictedForWriters

boolean

Określa, czy pobieranie i kopiowanie jest ograniczone dla autorów. Jeśli true, pobieranie jest też ograniczone dla czytelników.

Metody
`copy`	Tworzy kopię pliku i stosuje wszystkie żądane aktualizacje z semantyką poprawki.
`create`	Tworzy plik.
`delete`	Trwale usuwa plik należący do użytkownika bez przenoszenia go do kosza.
`download`	Pobiera zawartość pliku.
`emptyTrash`	Trwale usuwa wszystkie pliki użytkownika z kosza.
`export`	Eksportuje dokument Google Workspace do żądanego typu MIME i zwraca wyeksportowaną zawartość w bajtach.
`generateIds`	Generuje zestaw identyfikatorów plików, które można podać w żądaniach utworzenia lub skopiowania.
`get`	Pobiera metadane lub zawartość pliku według identyfikatora.
`list`	Wyświetla listę plików użytkownika.
`listLabels`	Wyświetla etykiety pliku.
`modifyLabels`	Zmienia zbiór etykiet zastosowanych do pliku.
`update`	Aktualizuje metadane lub treść pliku albo jedno i drugie.
`watch`	Subskrybuje zmiany w pliku.

REST Resource: files

Zasób: File

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

Metody

`copy`

`create`

`delete`

`download`

`emptyTrash`

`export`

`generateIds`

`get`

`list`

`listLabels`

`modifyLabels`

`update`

`watch`

REST Resource: files Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Zasób: File

ContentRestriction

DownloadRestrictionsMetadata

DownloadRestriction

Metody

REST Resource: files