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,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "ownerNames": [
    string
  ],
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "exportLinks": {
    string: string,
    ...
  },
  "driveId": string,
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "properties": [
    {
      object (Property)
    }
  ],
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "hasThumbnail": boolean,
  "spaces": [
    string
  ],
  "folderColorRgb": string,
  "id": string,
  "title": string,
  "description": string,
  "labels": {
    "viewed": boolean,
    "restricted": boolean,
    "starred": boolean,
    "hidden": boolean,
    "trashed": boolean,
    "modified": boolean
  },
  "explicitlyTrashed": boolean,
  "createdDate": string,
  "modifiedDate": string,
  "modifiedByMeDate": string,
  "lastViewedByMeDate": string,
  "markedViewedByMeDate": string,
  "sharedWithMeDate": string,
  "quotaBytesUsed": string,
  "version": string,
  "indexableText": {
    "text": string
  },
  "originalFilename": string,
  "ownedByMe": boolean,
  "canComment": boolean,
  "shareable": boolean,
  "fullFileExtension": string,
  "isAppAuthorized": boolean,
  "teamDriveId": string,
  "capabilities": {
    "canChangeRestrictedDownload": boolean,
    "canMoveChildrenOutOfDrive": boolean,
    "canReadDrive": boolean,
    "canEdit": boolean,
    "canCopy": boolean,
    "canComment": boolean,
    "canAddChildren": boolean,
    "canDelete": boolean,
    "canDownload": boolean,
    "canListChildren": boolean,
    "canRemoveChildren": boolean,
    "canRename": boolean,
    "canTrash": boolean,
    "canReadRevisions": boolean,
    "canReadTeamDrive": boolean,
    "canMoveTeamDriveItem": boolean,
    "canChangeCopyRequiresWriterPermission": boolean,
    "canMoveItemIntoTeamDrive": boolean,
    "canUntrash": boolean,
    "canModifyContent": boolean,
    "canMoveItemWithinTeamDrive": boolean,
    "canMoveItemOutOfTeamDrive": boolean,
    "canDeleteChildren": boolean,
    "canMoveChildrenOutOfTeamDrive": boolean,
    "canMoveChildrenWithinTeamDrive": boolean,
    "canTrashChildren": boolean,
    "canMoveItemOutOfDrive": boolean,
    "canAddMyDriveParent": boolean,
    "canRemoveMyDriveParent": boolean,
    "canMoveItemWithinDrive": boolean,
    "canShare": boolean,
    "canMoveChildrenWithinDrive": boolean,
    "canModifyContentRestriction": boolean,
    "canAddFolderFromAnotherDrive": boolean,
    "canChangeSecurityUpdateEnabled": boolean,
    "canAcceptOwnership": boolean,
    "canReadLabels": boolean,
    "canModifyLabels": boolean,
    "canModifyEditorContentRestriction": boolean,
    "canModifyOwnerContentRestriction": boolean,
    "canRemoveContentRestriction": boolean,
    "canDisableInheritedPermissions": boolean,
    "canEnableInheritedPermissions": boolean
  },
  "hasAugmentedPermissions": boolean,
  "trashingUser": {
    object (User)
  },
  "canReadRevisions": boolean,
  "thumbnailVersion": string,
  "trashedDate": string,
  "permissionIds": [
    string
  ],
  "thumbnail": {
    "image": string,
    "mimeType": 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,
    "date": string,
    "cameraMake": string,
    "cameraModel": string,
    "exposureTime": number,
    "aperture": number,
    "focalLength": number,
    "isoSpeed": integer,
    "exposureBias": number,
    "maxApertureValue": number,
    "subjectDistance": integer,
    "lens": string
  },
  "videoMediaMetadata": {
    "width": integer,
    "height": integer,
    "durationMillis": string
  },
  "shortcutDetails": {
    "targetId": string,
    "targetMimeType": string,
    "targetResourceKey": string
  },
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
Pola
kind

string

Tylko dane wyjściowe. Typ pliku. Jest ona zawsze drive#file.

userPermission

object (Permission)

Tylko dane wyjściowe. Uprawnienia uwierzytelnionego użytkownika dotyczące tego pliku.

fileExtension

string

Tylko dane wyjściowe. Ostatni element fullFileExtension z tekstem końcowym, który nie wydaje się być częścią rozszerzenia. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. Nie jest wypełniane w przypadku Edytorów Dokumentów ani plików skrótów.

md5Checksum

string

Tylko dane wyjściowe. Suma kontrolna MD5 zawartości tego pliku. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. Nie jest wypełniane w przypadku Edytorów Dokumentów ani plików skrótów.

ownerNames[]

string

Tylko dane wyjściowe. Imię i nazwisko właściciela tego pliku. Nie wypełniane w przypadku elementów na dyskach współdzielonych.

lastModifyingUserName

string

Tylko dane wyjściowe. Nazwa konta ostatniego użytkownika, który zmodyfikował ten plik.

editable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego capabilities/canEdit.

writersCanShare

boolean

Określa, czy autorzy mogą udostępniać dokument innym użytkownikom. Nie wypełnione w przypadku elementów na dyskach współdzielonych.

downloadUrl

string

Tylko dane wyjściowe. Tymczasowy adres URL do pobrania pliku. To pole jest wypełniane tylko w przypadku plików z zawartością przechowywaną na Dysku Google. Nie jest wypełniane w przypadku plików Dokumentów Google ani plików skrótów.

mimeType

string

Typ MIME pliku. Można je zmienić tylko podczas przesyłania nowych treści. To pole może być puste, a typ mimetype zostanie określony na podstawie typu MIME przesłanych treści.

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.

parents[]

object (ParentReference)

Identyfikator folderu nadrzędnego zawierającego plik.

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

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

appDataContents

boolean

Tylko dane wyjściowe. Czy plik znajduje się w folderze Application Data.

shared

boolean

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

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

Tylko dane wyjściowe. Identyfikator głównej wersji pliku. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. Nie jest wypełniane w przypadku Edytorów Dokumentów ani plików skrótów.

properties[]

object (Property)

Lista usług.

copyable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego capabilities/canCopy.

etag

string

Tylko dane wyjściowe. ETag pliku.

sharingUser

object (User)

Tylko dane wyjściowe. Użytkownik, który udostępnił element bieżącemu użytkownikowi (jeśli jest dostępny).

fileSize

string (int64 format)

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

copyRequiresWriterPermission

boolean

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

permissions[]

object (Permission)

Tylko dane wyjściowe. Lista uprawnień użytkowników z dostępem do tego pliku. Nie wypełnione w przypadku elementów na dyskach współdzielonych.

hasThumbnail

boolean

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

spaces[]

string

Tylko dane wyjściowe. Lista pokoi zawierających plik. Obsługiwane wartości to drive, appDataFolderphotos.

folderColorRgb

string

Kolor folderu jako ciąg znaków szesnastkowych RGB, jeśli plik jest folderem lub skrótem do folderu. Lista obsługiwanych kolorów jest dostępna w polu folderColorPalette zasobu Informacje. Jeśli zostanie podany nieobsługiwany kolor, zostanie on zmieniony na najbliższy kolor z palety.

id

string

Identyfikator pliku.

title

string

Tytuł tego pliku. Pamiętaj, że w przypadku elementów niezmiennych, takich jak foldery najwyższego poziomu na dyskach współdzielonych, folder główny Mojego dysku i folder Application Data, tytuł jest stały.

description

string

Krótki opis pliku.

labels

object

Grupa etykiet dla pliku.

labels.viewed

boolean

Określa, czy ten plik został wyświetlony przez tego użytkownika.

labels.restricted
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego copyRequiresWriterPermission.

labels.starred

boolean

Czy plik jest oznaczony gwiazdką przez użytkownika.

labels.hidden
(deprecated)

boolean

Tylko dane wyjściowe. Rola wycofana.

labels.trashed

boolean

Czy plik został przeniesiony do kosza. Ta etykieta dotyczy wszystkich użytkowników, którzy mają dostęp do pliku, ale tylko właściciele mogą wyświetlać pliki i usuwać je z kosza.

labels.modified

boolean

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

explicitlyTrashed

boolean

Tylko dane wyjściowe. Określa, czy plik został usunięty w sposób jawny, a nie w drodze rekurencyjnej.

createdDate

string

Tylko dane wyjściowe. Utwórz czas dla tego pliku (sygnatura czasowa w formacie RFC 3339).

modifiedDate

string

Ostatnia modyfikacja tego pliku przez dowolną osobę (sygnatura czasowa w formacie RFC 3339). Można go zmienić tylko podczas aktualizacji, gdy ustawiony jest parametr setModifiedDate.

modifiedByMeDate

string

Tylko dane wyjściowe. Ostatnia modyfikacja pliku przez użytkownika (sygnatura czasowa w formacie RFC 3339). Pamiętaj, że ustawienie wartości modifiedDate spowoduje też zaktualizowanie wartości modifiedByMe dla użytkownika, który ustawił datę.

lastViewedByMeDate

string

Ostatni czas wyświetlenia tego pliku przez użytkownika (sygnatura czasowa w formacie RFC 3339).

markedViewedByMeDate
(deprecated)

string

Tylko dane wyjściowe. Rola wycofana.

sharedWithMeDate

string

Tylko dane wyjściowe. Czas, w którym plik został udostępniony użytkownikowi (sformatowany znacznik czasu według standardu RFC 3339).

quotaBytesUsed

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów limitu wykorzystanych przez ten plik.

version

string (int64 format)

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

indexableText

object

Atrybuty tekstowe możliwe do zindeksowania w pliku (można je tylko zapisywać)

indexableText.text

string

Tekst, który ma zostać zindeksowany w przypadku tego pliku.

originalFilename

string

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

ownedByMe

boolean

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

canComment
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego capabilities/canComment.

shareable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego capabilities/canShare.

fullFileExtension

string

Tylko dane wyjściowe. Pełne rozszerzenie pliku wyodrębnione z tytułu. Może zawierać wiele sprzężonych rozszerzeń, np. „tar.gz”. Usunięcie rozszerzenia z tytułu nie powoduje wyczyszczenia tego pola, ale zmiana rozszerzenia w tytułu powoduje zaktualizowanie tego pola. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. Nie jest wypełniane w przypadku Edytorów Dokumentów ani plików skrótów.

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego driveId.

capabilities

object

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

capabilities.canChangeRestrictedDownload
(deprecated)

boolean

Tylko dane wyjściowe. Rola wycofana.

capabilities.canMoveChildrenOutOfDrive

boolean

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

capabilities.canReadDrive

boolean

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

capabilities.canEdit

boolean

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

capabilities.canCopy

boolean

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

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

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

capabilities.canDelete

boolean

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

capabilities.canDownload

boolean

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

capabilities.canListChildren

boolean

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

capabilities.canRemoveChildren

boolean

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

capabilities.canRename

boolean

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

capabilities.canTrash

boolean

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

capabilities.canReadRevisions

boolean

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

capabilities.canReadTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj zamiast tego pola canMoveItemWithinDrive lub canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

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

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego 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

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

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

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

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

capabilities.canMoveItemOutOfDrive

boolean

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

capabilities.canAddMyDriveParent

boolean

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

capabilities.canRemoveMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usunąć rodzica z elementu bez dodawania kolejnego rodzica w tej samej prośbie. Nie wypełniane w przypadku plików na dysku współdzielonym.

capabilities.canMoveItemWithinDrive

boolean

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

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

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

capabilities.canModifyContentRestriction
(deprecated)

boolean

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

capabilities.canAddFolderFromAnotherDrive

boolean

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

capabilities.canChangeSecurityUpdateEnabled

boolean

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

capabilities.canAcceptOwnership

boolean

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

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

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

capabilities.canRemoveContentRestriction

boolean

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

capabilities.canDisableInheritedPermissions

boolean

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

capabilities.canEnableInheritedPermissions

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

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

canReadRevisions
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zastępstwie tego capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

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

trashedDate

string

Tylko dane wyjściowe. Czas, w którym element został przeniesiony do kosza (sygnatura czasowa w formacie RFC 3339). Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

permissionIds[]

string

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

thumbnail

object

Miniatura pliku. Będzie ona używana tylko wtedy, gdy nie można wygenerować standardowej miniatury.

thumbnail.image

string (bytes format)

Bajty miniatury obrazu zakodowane w formacie Base64 przeznaczonym do bezpiecznego przesyłania w adresie URL. Powinien być zgodny z sekcją 5 standardu RFC 4648.

Ciąg znaków zakodowany w formacie Base64.

thumbnail.mimeType

string

Typ MIME miniatury.

imageMediaMetadata

object

Tylko dane wyjściowe. Metadane dotyczące multimediów z obrazem. Będzie ona obecna tylko w przypadku typów obrazów, a jej zawartość będzie zależeć od tego, co można przeanalizować na podstawie treści obrazu.

imageMediaMetadata.flashUsed

boolean

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

imageMediaMetadata.meteringMode

string

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

imageMediaMetadata.sensor

string

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

imageMediaMetadata.exposureMode

string

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

imageMediaMetadata.colorSpace

string

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

imageMediaMetadata.whiteBalance

string

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

imageMediaMetadata.width

integer

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

imageMediaMetadata.height

integer

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

imageMediaMetadata.location

object

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

imageMediaMetadata.location.latitude

number

Tylko dane wyjściowe. Szerokość geograficzna zapisana w zrobionym 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 obrazie.

imageMediaMetadata.rotation

integer

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

imageMediaMetadata.date

string

Tylko dane wyjściowe. Data i godzina zrobienia zdjęcia (sygnatura EXIF).

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. Długość ekspozycji w sekundach.

imageMediaMetadata.aperture

number

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

imageMediaMetadata.focalLength

number

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

imageMediaMetadata.isoSpeed

integer

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

imageMediaMetadata.exposureBias

number

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

imageMediaMetadata.maxApertureValue

number

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

imageMediaMetadata.subjectDistance

integer

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

imageMediaMetadata.lens

string

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

videoMediaMetadata

object

Tylko dane wyjściowe. Metadane dotyczące multimediów wideo. Ta opcja będzie dostępna tylko w przypadku typów filmów.

videoMediaMetadata.width

integer

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

videoMediaMetadata.height

integer

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

videoMediaMetadata.durationMillis

string (int64 format)

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

shortcutDetails

object

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

shortcutDetails.targetId

string

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

shortcutDetails.targetMimeType

string

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

shortcutDetails.targetResourceKey

string

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

contentRestrictions[]

object (ContentRestriction)

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

resourceKey

string

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

linkShareMetadata.securityUpdateEligible

boolean

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

linkShareMetadata.securityUpdateEnabled

boolean

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

labelInfo

object

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

labelInfo.labels[]

object (Label)

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

sha1Checksum

string

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

sha256Checksum

string

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

inheritedPermissionsDisabled

boolean

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

ContentRestriction

Ograniczenie dostępu do treści pliku.

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

boolean

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

reason

string

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

type

string

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

restrictingUser

object (User)

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

restrictionDate

string

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

ownerRestricted

boolean

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

systemRestricted

boolean

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

Metody

copy

Tworzy kopię wskazanego pliku.

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

insert

Wstawia nowy plik.

list

Wyświetla pliki użytkownika.

listLabels

Wyświetla etykiety pliku.

modifyLabels

Modyfikuje zbiór etykiet zastosowanych do pliku.

patch

Zaktualizuje metadane lub zawartość pliku.

touch

Ustaw czas zaktualizowania pliku na bieżący czas serwera.

trash

Przenosi plik do kosza.

untrash

Przywraca plik z kosza.

update

Zaktualizuje metadane lub zawartość pliku.

watch

Subskrybuje zmiany w pliku.