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
  },
  "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
}
Pola
kind

string

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

userPermission

object (Permission)

Tylko dane wyjściowe. Uprawnienia uwierzytelnionego użytkownika do tego pliku.

fileExtension

string

Tylko dane wyjściowe. Ostatni komponent elementu fullFileExtension z tekstem na końcu, który prawdopodobnie nie jest częścią usuniętego rozszerzenia. To pole jest wypełniane tylko w przypadku plików z treścią przechowywanej na Dysku Google. Nie jest ono wypełniane w przypadku edytorów Dokumentów ani plików skrótów.

md5Checksum

string

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

ownerNames[]

string

Tylko dane wyjściowe. Nazwy właścicieli tego pliku. Brak wypełnienia w przypadku elementów na dyskach współdzielonych.

lastModifyingUserName

string

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

editable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu capabilities/canEdit.

writersCanShare

boolean

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

downloadUrl

string

Tylko dane wyjściowe. Krótkotrwały adres URL pobierania pliku. To pole jest wypełniane tylko w przypadku plików zawierających treści przechowywane na Dysku Google. Nie jest ono wypełniane w przypadku plików Dokumentów Google ani plików skrótów.

mimeType

string

Typ MIME pliku. Tę funkcję można zmienić tylko podczas aktualizacji podczas przesyłania nowych treści. To pole może być puste, a typ MIME będzie określany na podstawie typu MIME przesłanej 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)

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

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

appDataContents

boolean

Tylko dane wyjściowe. Wskazuje, czy ten plik znajduje się w folderze Application Data (Dane aplikacji).

shared

boolean

Tylko dane wyjściowe. Określa, czy plik został udostępniony. Brak wypełnienia w przypadku elementów na dyskach współdzielonych.

lastModifyingUser

object (User)

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

owners[]

object (User)

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

headRevisionId

string

Tylko dane wyjściowe. Identyfikator wersji nagłówka pliku. To pole jest wypełniane tylko w przypadku plików z treścią przechowywanej na Dysku Google. Nie jest ono wypełniane w przypadku edytorów Dokumentów ani plików skrótów.

properties[]

object (Property)

Lista właściwości.

copyable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu capabilities/canCopy.

etag

string

Tylko dane wyjściowe. ETag pliku.

sharingUser

object (User)

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

fileSize

string (int64 format)

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

copyRequiresWriterPermission

boolean

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

permissions[]

object (Permission)

Tylko dane wyjściowe. Lista uprawnień użytkowników, którzy mają dostęp do tego pliku. Brak wypełnienia w przypadku elementów na dyskach współdzielonych.

hasThumbnail

boolean

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

spaces[]

string

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

folderColorRgb

string

Kolor folderu jako ciąg szesnastkowy 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 określisz nieobsługiwany kolor, zostanie on zmieniony na najbliższy z palety.

id

string

Identyfikator pliku.

title

string

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

description

string

Krótki opis pliku.

labels

object

Grupa etykiet 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: zamiast tego użyj elementu copyRequiresWriterPermission.

labels.starred

boolean

Określa, czy plik został oznaczony gwiazdką przez użytkownika.

labels.hidden
(deprecated)

boolean

Tylko dane wyjściowe. Rola wycofana.

labels.trashed

boolean

Wskazuje, czy plik został przeniesiony do kosza. Ta etykieta ma zastosowanie do wszystkich użytkowników, którzy mają dostęp do pliku, jednak tylko właściciele mogą wyświetlać i przywracać pliki.

labels.modified

boolean

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

explicitlyTrashed

boolean

Tylko dane wyjściowe. Określa, czy plik został bezpośrednio przeniesiony do kosza, a nie rekurencyjnie przeniesiony do kosza.

createdDate

string

Tylko dane wyjściowe. Czas utworzenia tego pliku (sygnatura czasowa w formacie RFC 3339).

modifiedDate

string

Czas ostatniej modyfikacji tego pliku przez dowolną osobę (sygnatura czasowa w formacie RFC 3339). Tę funkcję można zmienić tylko podczas aktualizacji, gdy ustawiony jest parametr setModifiedDate.

modifiedByMeDate

string

Tylko dane wyjściowe. Czas ostatniej modyfikacji pliku przez użytkownika (sygnatura czasowa w formacie RFC 3339). Pamiętaj, że ustawienie restrictedDate powoduje też zaktualizowanie daty zmodyfikowanej dla użytkownika, który ustawił tę datę.

lastViewedByMeDate

string

Czas ostatniego 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 udostępnienia pliku użytkownikowi (sygnatura czasowa w formacie RFC 3339).

quotaBytesUsed

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów w ramach limitu używanych przez ten plik.

version

string (int64 format)

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

indexableText

object

Możliwe do zindeksowania atrybuty tekstowe pliku (można tylko zapisywać)

indexableText.text

string

Tekst do zindeksowania dla tego pliku.

originalFilename

string

Oryginalna nazwa pliku z przesłaną treścią (jeśli jest dostępna) lub pierwotna wartość pola title. Jest to możliwe tylko w przypadku plików z zawartością binarną na Dysku Google.

ownedByMe

boolean

Tylko dane wyjściowe. Określa, czy plik należy do bieżącego użytkownika. Brak wypełnienia w przypadku elementów na dyskach współdzielonych.

canComment
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu capabilities/canComment.

shareable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu capabilities/canShare.

fullFileExtension

string

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

isAppAuthorized

boolean

Tylko dane wyjściowe. Określa, czy plik został utworzony lub otwarty przez aplikację, która wysłała żądanie.

teamDriveId
(deprecated)

string

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu driveId.

capabilities

object

Tylko dane wyjściowe. Uprawnienia bieżącego użytkownika w tym pliku. Każda możliwość odpowiada szczegółowemu działaniu, które może wykonać użytkownik.

capabilities.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 przenieść elementy podrzędne tego folderu poza dysk współdzielony. Ta wartość ma wartość false, jeśli element nie jest folderem. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canReadDrive

boolean

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

capabilities.canEdit

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może edytować ten plik. Inne czynniki mogą ograniczać rodzaj zmian, jakie użytkownik może wprowadzać w pliku. np. canChangeCopyRequiresWriterPermission lub canModifyContent.

capabilities.canCopy

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może skopiować ten plik. Określa, czy bieżący użytkownik może skopiować elementy podrzędne tego elementu inne niż folder, czy sam element, jeśli nie jest folderem.

capabilities.canComment

boolean

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

capabilities.canAddChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać elementy podrzędne do tego folderu. Ta wartość ma zawsze wartość fałsz, gdy element nie jest folderem.

capabilities.canDelete

boolean

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

capabilities.canDownload

boolean

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

capabilities.canListChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może wyświetlać listę elementów podrzędnych tego folderu. Ta wartość ma zawsze wartość fałsz, gdy element nie jest folderem.

capabilities.canRemoveChildren

boolean

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

capabilities.canRename

boolean

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

capabilities.canTrash

boolean

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

capabilities.canReadRevisions

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może odczytywać zasób wersji tego pliku. W przypadku elementu na dysku współdzielonym można odczytywać zarówno wersje jego elementów podrzędnych innych niż folder, jak i sam element, jeśli nie jest to folder.

capabilities.canReadTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj w zamian zasady canMoveItemWithinDrive lub canMoveItemOutOfDrive.

capabilities.canChangeCopyRequiresWriterPermission

boolean

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

capabilities.canMoveItemIntoTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu 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: zamiast tego użyj elementu canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać elementy podrzędne z tego folderu. Ta wartość ma wartość false, jeśli element nie jest folderem. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canMoveChildrenOutOfTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu canMoveChildrenWithinDrive.

capabilities.canTrashChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenosić do kosza elementy podrzędne tego folderu. Ta wartość ma wartość false, jeśli element nie jest folderem. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

capabilities.canMoveItemOutOfDrive

boolean

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

capabilities.canAddMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodać element nadrzędny elementu bez usuwania istniejącego elementu nadrzędnego w tym samym żądaniu. Wartość nie jest wypełniona w przypadku plików na dysku współdzielonym.

capabilities.canRemoveMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usunąć element nadrzędny z elementu bez dodawania drugiego elementu nadrzędnego w tej samej prośbie. Wartość nie jest wypełniona w przypadku plików na dysku współdzielonym.

capabilities.canMoveItemWithinDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść ten element na tym dysku. Pamiętaj, że prośba o zmianę elementu nadrzędnego nadal może się nie powieść – zależy to od dodawanego nowego elementu nadrzędnego i usuwanego elementu nadrzędnego.

capabilities.canShare

boolean

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

capabilities.canMoveChildrenWithinDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść elementy podrzędne tego folderu na tym dysku. Ta wartość ma wartość false, jeśli element nie jest folderem. Pamiętaj, że prośba o przeniesienie konta podrzędnego może się nadal zakończyć niepowodzeniem, jeśli ma on dostęp do konta podrzędnego i do folderu docelowego.

capabilities.canModifyContentRestriction
(deprecated)

boolean

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

capabilities.canAddFolderFromAnotherDrive

boolean

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

capabilities.canChangeSecurityUpdateEnabled

boolean

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

capabilities.canAcceptOwnership

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik jest oczekiwanym właścicielem pliku. Wartość nie jest wypełniona w przypadku plików na dysku współdzielonym.

capabilities.canReadLabels

boolean

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

capabilities.canModifyLabels

boolean

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

capabilities.canModifyEditorContentRestriction

boolean

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

capabilities.canModifyOwnerContentRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać i modyfikować ograniczenia treści nałożone przez właściciela.

capabilities.canRemoveContentRestriction

boolean

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

hasAugmentedPermissions

boolean

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

trashingUser

object (User)

Tylko dane wyjściowe. jeśli plik został jawnie przeniesiony do kosza – nazwa użytkownika, który go usunął; Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

canReadRevisions
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: zamiast tego użyj elementu capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

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

trashedDate

string

Tylko dane wyjściowe. Godzina przeniesienia elementu 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. files.list identyfikatorów uprawnień użytkowników mających dostęp do tego pliku.

thumbnail

object

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

thumbnail.image

string (bytes format)

Bajty obrazu miniatury zakodowane w formacie Base64 przeznaczone do bezpiecznego przesyłania w adresie URL. Powinien być zgodny ze standardem RFC 4648 (sekcja 5)

Ciąg zakodowany w formacie base64.

thumbnail.mimeType

string

Typ MIME miniatury.

imageMediaMetadata

object

Tylko dane wyjściowe. Metadane dotyczące mediów graficznych. Jest ona widoczna tylko w przypadku obrazów, a jej zawartość zależy od tego, co można odczytać z treści obrazu.

imageMediaMetadata.flashUsed

boolean

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

imageMediaMetadata.meteringMode

string

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

imageMediaMetadata.sensor

string

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

imageMediaMetadata.exposureMode

string

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

imageMediaMetadata.colorSpace

string

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

imageMediaMetadata.whiteBalance

string

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

imageMediaMetadata.width

integer

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

imageMediaMetadata.height

integer

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

imageMediaMetadata.location

object

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

imageMediaMetadata.location.latitude

number

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

imageMediaMetadata.location.longitude

number

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

imageMediaMetadata.location.altitude

number

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

imageMediaMetadata.rotation

integer

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

imageMediaMetadata.date

string

Tylko dane wyjściowe. Data i godzina zrobienia zdjęcia (sygnatura czasowa w formacie 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. Czas ekspozycji (w sekundach).

imageMediaMetadata.aperture

number

Tylko dane wyjściowe. Wartość przysłony użyta do utworzenia zdjęcia (liczba f).

imageMediaMetadata.focalLength

number

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

imageMediaMetadata.isoSpeed

integer

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

imageMediaMetadata.exposureBias

number

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

imageMediaMetadata.maxApertureValue

number

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

imageMediaMetadata.subjectDistance

integer

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

imageMediaMetadata.lens

string

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

videoMediaMetadata

object

Tylko dane wyjściowe. Metadane dotyczące mediów wideo. Jest ona widoczna tylko w przypadku typów wideo.

videoMediaMetadata.width

integer

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

videoMediaMetadata.height

integer

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

videoMediaMetadata.durationMillis

string (int64 format)

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

shortcutDetails

object

Szczegóły pliku skrótu. Wartość podawana tylko w przypadku plików skrótów, które mają pole mimeType ustawione na application/vnd.google-apps.shortcut.

shortcutDetails.targetId

string

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

shortcutDetails.targetMimeType

string

Tylko dane wyjściowe. Typ MIME pliku, do którego prowadzi ten skrót. Wartością tego pola jest zrzut typu MIME środowiska docelowego, przechwycony podczas tworzenia skrótu.

shortcutDetails.targetResourceKey

string

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

contentRestrictions[]

object (ContentRestriction)

Ograniczenia dostępu do zawartości pliku. Pole wypełnione tylko wtedy, gdy istnieje takie ograniczenie.

resourceKey

string

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

linkShareMetadata.securityUpdateEligible

boolean

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

linkShareMetadata.securityUpdateEnabled

boolean

Tylko dane wyjściowe. Określa, czy dla tego pliku jest włączona aktualizacja zabezpieczeń.

labelInfo

object

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

labelInfo.labels[]

object (Label)

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

sha1Checksum

string

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

sha256Checksum

string

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

ContentRestriction

Ograniczenie dostępu do zawartości pliku.

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

boolean

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

reason

string

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

type

string

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

restrictingUser

object (User)

Tylko dane wyjściowe. Użytkownik, który ustawił ograniczenie treści. Pole wypełnione tylko wtedy, gdy zasada readOnly ma wartość prawda.

restrictionDate

string

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

ownerRestricted

boolean

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

systemRestricted

boolean

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

Metody

copy

Tworzy kopię wybranego pliku.

delete

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

emptyTrash

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

export

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

generateIds

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

get

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

insert

Wstawia nowy plik.

list

Zawiera listę plików użytkownika.

listLabels

Wyświetla listę etykiet pliku.

modifyLabels

Modyfikuje zestaw etykiet zastosowanych do pliku.

patch

Aktualizuje metadane lub zawartość pliku.

touch

Ustaw aktualny czas aktualizacji pliku na bieżący czas serwera.

trash

Przenosi plik do kosza.

untrash

Przywraca plik z kosza.

update

Aktualizuje metadane lub zawartość pliku.

watch

Subskrybuje zmiany w pliku.