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
{
  "ownerNames": [
    string
  ],
  "exportLinks": {
    string: string,
    ...
  },
  "parents": [
    {
      object (ParentReference)
    }
  ],
  "owners": [
    {
      object (User)
    }
  ],
  "openWithLinks": {
    string: string,
    ...
  },
  "properties": [
    {
      object (Property)
    }
  ],
  "permissions": [
    {
      object (Permission)
    }
  ],
  "spaces": [
    string
  ],
  "permissionIds": [
    string
  ],
  "contentRestrictions": [
    {
      object (ContentRestriction)
    }
  ],
  "kind": string,
  "userPermission": {
    object (Permission)
  },
  "fileExtension": string,
  "md5Checksum": string,
  "selfLink": string,
  "lastModifyingUserName": string,
  "editable": boolean,
  "writersCanShare": boolean,
  "downloadUrl": string,
  "mimeType": string,
  "driveId": string,
  "thumbnailLink": string,
  "appDataContents": boolean,
  "webViewLink": string,
  "iconLink": string,
  "shared": boolean,
  "lastModifyingUser": {
    object (User)
  },
  "defaultOpenWithLink": string,
  "headRevisionId": string,
  "copyable": boolean,
  "etag": string,
  "sharingUser": {
    object (User)
  },
  "alternateLink": string,
  "embedLink": string,
  "webContentLink": string,
  "fileSize": string,
  "copyRequiresWriterPermission": boolean,
  "hasThumbnail": boolean,
  "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,
  "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
  },
  "resourceKey": string,
  "linkShareMetadata": {
    "securityUpdateEligible": boolean,
    "securityUpdateEnabled": boolean
  },
  "labelInfo": {
    "labels": [
      {
        object (Label)
      }
    ]
  },
  "sha1Checksum": string,
  "sha256Checksum": string,
  "inheritedPermissionsDisabled": boolean
}
Pola
ownerNames[]

string

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

parents[]

object (ParentReference)

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 to określone w ramach żądania wstawienia, 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 addParentsremoveParents.

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.

properties[]

object (Property)

Lista usług.

permissions[]

object (Permission)

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

spaces[]

string

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

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. Typ pliku. Zawsze jest to drive#file.

userPermission

object (Permission)

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

fileExtension

string

Tylko dane wyjściowe. Ostatni komponent fullFileExtension z usuniętym tekstem na końcu, który nie wydaje się być częścią rozszerzenia. 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.

md5Checksum

string

Tylko dane wyjściowe. Suma kontrolna MD5 zawartości tego pliku. 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.

lastModifyingUserName

string

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

editable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady capabilities/canEdit.

writersCanShare

boolean

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

downloadUrl

string

Tylko dane wyjściowe. Krótki adres URL do pobrania pliku. To pole jest wypełniane tylko w przypadku plików, których zawartość jest przechowywana na Dysku Google. Nie jest wypełniane w przypadku Dokumentów Google ani plików skrótów.

mimeType

string

Typ MIME pliku. Można go zmienić tylko podczas przesyłania nowych treści. To pole można pozostawić puste. Typ MIME 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.

appDataContents

boolean

Tylko dane wyjściowe. Czy ten plik znajduje się w folderze danych aplikacji.

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ł ten 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. 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.

copyable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady 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 własnych. 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 tego pliku mają być wyłączone dla czytelników i komentujących.

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 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 About. Jeśli podasz nieobsługiwany kolor, zostanie on zmieniony na najbliższy kolor w palecie.

id

string

Identyfikator pliku.

title

string

Tytuł tego pliku. Pamiętaj, że w przypadku elementów niezmiennych, takich jak foldery najwyższego poziomu dysków współdzielonych, folder główny Mojego dysku i folder Dane 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 użytkownika.

labels.restricted
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady 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 ten 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ć i przywracać pliki.

labels.modified

boolean

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

explicitlyTrashed

boolean

Tylko dane wyjściowe. Czy ten plik został wyraźnie przeniesiony do kosza, a nie przeniesiony do kosza rekurencyjnie.

createdDate

string

Tylko dane wyjściowe. Czas utworzenia tego pliku (sformatowana sygnatura czasowa 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 tego pliku przez użytkownika (sygnatura czasowa w formacie RFC 3339). Pamiętaj, że ustawienie daty modifiedDate spowoduje też zaktualizowanie daty modifiedByMe dla użytkownika, który ją ustawił.

lastViewedByMeDate

string

Kiedy użytkownik ostatnio wyświetlił ten plik (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 ten plik został udostępniony użytkownikowi (sygnatura czasowa w formacie 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. Numer wersji pliku, który rośnie monotonicznie. Odzwierciedla wszystkie zmiany wprowadzone w pliku na serwerze, nawet te niewidoczne dla użytkownika wysyłającego żądanie.

indexableText

object

Atrybuty tekstowe pliku, które można indeksować (można tylko zapisywać).

indexableText.text

string

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

originalFilename

string

Oryginalna nazwa przesłanej treści, jeśli jest dostępna, lub oryginalna 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. Określa, czy plik należy do bieżącego użytkownika. Nie jest wypełniana w przypadku elementów na dyskach współdzielonych.

canComment
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady capabilities/canComment.

shareable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady 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 spowoduje wyczyszczenia tego pola, ale zmiana rozszerzenia w tytule spowoduje jego zaktualizowanie. 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.

isAppAuthorized

boolean

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

teamDriveId
(deprecated)

string

Tylko dane wyjściowe. Wycofana: 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.canChangeRestrictedDownload
(deprecated)

boolean

Tylko dane wyjściowe. Rola wycofana.

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

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Tylko dane wyjściowe. Wycofano: zamiast tego używaj 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

Tylko dane wyjściowe. Wycofana: 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

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: 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

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: 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

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

capabilities.canEnableInheritedPermissions

boolean

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

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.

canReadRevisions
(deprecated)

boolean

Tylko dane wyjściowe. Wycofana: zamiast niej używaj zasady capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

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

trashedDate

string

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

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 ze standardem RFC 4648 (sekcja 5).

Ciąg tekstowy zakodowany w formacie Base64.

thumbnail.mimeType

string

Typ MIME miniatury.

imageMediaMetadata

object

Tylko dane wyjściowe. Metadane dotyczące nośnika obrazu. Ten element będzie widoczny tylko w przypadku typów obrazów, a jego zawartość będzie zależeć od tego, co można wyodrębnić z treści obrazu.

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.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 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. Metadane dotyczące treści wideo. Będzie ona dostępna 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ść 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.insert.

shortcutDetails.targetId

string

Identyfikator pliku, do którego prowadzi ten skrót. Można go ustawić tylko w przypadku żądań files.insert.

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.

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

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).

restrictionDate

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.

Metody

copy

Tworzy kopię określonego pliku.

delete

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

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 wstawiania lub kopiowania.

get

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

insert

Wstawia nowy plik.

list

Wyświetla listę plików użytkownika.

listLabels

Wyświetla etykiety pliku.

modifyLabels

Zmienia zbiór etykiet zastosowanych do pliku.

patch

Aktualizuje metadane lub treść pliku.

touch

Ustaw datę aktualizacji pliku na bieżący czas serwera.

trash

Przenosi plik do kosza.

untrash

Przywraca plik z kosza.

update

Aktualizuje metadane lub treść pliku.

watch

Subskrybuje zmiany w pliku.