REST Resource: files

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 
{
  "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
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 prośby o kopię, plik dziedziczy wszystkie wykrywalne elementy nadrzędne pliku źródłowego. W przypadku próśb files.update do modyfikowania listy elementów nadrzędnych należy używać parametrów addParents i removeParents.
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 zawierających 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. 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 do odczytu. files.list of permission IDs for users with access to this file.
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. Maksymalna długość to 128 KB. Może zawierać elementy HTML.
contentHints.thumbnail

object

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

string (bytes format)

Dane miniatury zakodowane w formacie Base64 bezpiecznym dla adresów 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 sekcji Informacje o zasobie.
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ę (jeśli dotyczy);
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 własnych. 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

Wycofana: zamiast niej używaj zasady copyRequiresWriterPermission.
hasThumbnail

boolean

Tylko dane wyjściowe. Czy ten plik ma miniaturę. Nie oznacza to, że aplikacja wysyłająca żądanie 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 folderze. Pamiętaj, że w przypadku niezmiennych elementów, takich jak foldery najwyższego poziomu dysków 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 rekursywnie z 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

Kiedy użytkownik ostatnio wyświetlił plik (data i godzina w formacie RFC 3339).
sharedWithMeTime

string

Tylko dane wyjściowe. Czas, w którym plik został udostępniony użytkownikowi (w stosownych przypadkach) (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

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.
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ść „fałsz”, 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 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 sam 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, wartość tego pola to zawsze „fałsz”.
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, wartość tego pola to zawsze „fałsz”.
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, wartość tego pola to zawsze „fałsz”. 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. W przypadku elementu na dysku współdzielonym określa, czy można odczytać wersje elementów podrzędnych, które nie są folderami, lub sam 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ść „fałsz”, 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. 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 przenieść do kosza elementy podrzędne tego folderu. Wartość „fałsz”, 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 folder nadrzędny. Pamiętaj, że prośba o zmianę elementu nadrzędnego może się nie powieść w zależności od nowego elementu nadrzędnego, który jest dodawany.
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 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ść „fałsz”, jeśli 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ść „fałsz”, 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 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 usunąć bieżący użytkownik.
capabilities.canDisableInheritedPermissions

boolean

Czy użytkownik może wyłączyć uprawnienia dziedziczone.
capabilities.canEnableInheritedPermissions

boolean

Czy użytkownik może ponownie włączyć uprawnienia dziedziczone.
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. Godzina 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 względem 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. Klucz zasobu pliku docelowego.
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 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 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 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ń, które ustawiają 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 wtedy, gdy readOnly ma wartość true (prawda).
restrictionTime

string

Tylko dane wyjściowe. Czas, w którym ustawiono ograniczenie treści (sygnatura czasowa w formacie RFC 3339). Wypełniane tylko wtedy, gdy readOnly ma wartość true (prawda).
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ł zapobiegania utracie danych.
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
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 wartość to „true”, pobieranie jest też ograniczone dla czytelników.

Metody

copy

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

create

Tworzy nowy 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.

watch

 Subskrybuje zmiany w pliku.