REST Resource: files

Zasób: Plik

Metadane pliku.

Niektóre metody zasobów (takie jak files.update) wymagają fileId. Użyj metody files.list, aby pobrać identyfikator pliku.

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. To zawsze drive#file.

userPermission

object (Permission)

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

fileExtension

string

Tylko dane wyjściowe. Usunięto ostatni komponent fullFileExtension z tekstem końcowym, który nie jest częścią rozszerzenia. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. nie jest wypełniona 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ściami przechowywanymi na Dysku Google. nie jest wypełniona w przypadku edytorów Dokumentów ani plików skrótów.

ownerNames[]

string

Tylko dane wyjściowe. Nazwy właścicieli tego pliku. Wartość nie jest wypełniona w przypadku elementów na dyskach współdzielonych.

lastModifyingUserName

string

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

editable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu capabilities/canEdit.

writersCanShare

boolean

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

downloadUrl

string

Tylko dane wyjściowe. Krótki adres URL pobierania pliku. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. Pole nie jest wypełniane w przypadku Dokumentów Google ani plików skrótów.

mimeType

string

Typ MIME pliku. Można ją zmienić tylko podczas aktualizacji podczas przesyłania nowych treści. To pole może pozostać 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)

Identyfikator folderu nadrzędnego zawierającego plik.

Plik może mieć tylko 1 folder nadrzędny. nie można wskazać wielu elementów nadrzędnych.

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, plik odziedziczy każdy możliwy do znalezienia element nadrzędny pliku źródłowego. Żądania files.update muszą 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 Dane aplikacji.

shared

boolean

Tylko dane wyjściowe. Określa, czy plik został udostępniony. Wartość nie jest wypełniona 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ściciel tego pliku. Tylko niektóre starsze pliki mogą mieć więcej niż jednego właściciela. To pole nie jest wypełniane w przypadku elementów na dyskach współdzielonych.

headRevisionId

string

Tylko dane wyjściowe. Identyfikator wersji nagłówka pliku. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. nie jest wypełniona 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: użyj atrybutu capabilities/canCopy.

etag

string

Tylko dane wyjściowe. ETag pliku.

sharingUser

object (User)

Tylko dane wyjściowe. Użytkownik, który udostępnił element obecnemu użytkownikowi (jeśli to możliwe).

fileSize

string (int64 format)

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

copyRequiresWriterPermission

boolean

Opcje kopiowania, drukowania i pobierania 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. Wartość nie jest wypełniona w przypadku elementów na dyskach współdzielonych.

hasThumbnail

boolean

Tylko dane wyjściowe. Określa, czy ten plik ma miniaturę. Nie wskazuje ona, czy aplikacja wysyłająca żądanie ma dostęp do miniatury. Aby sprawdzić dostęp, sprawdź, czy znajduje się pole do miniaturki Link.

spaces[]

string

Tylko dane wyjściowe. Lista pokoi zawierających 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 w zasobie Informacje. Jeśli określisz nieobsługiwany kolor, zostanie on zmieniony na najbliższy kolor w palecie.

id

string

Identyfikator pliku.

title

string

Nazwa tego pliku. Pamiętaj, że w przypadku elementów stałych, takich jak foldery najwyższego poziomu dysków współdzielonych, folder główny Mój dysk czy folder danych aplikacji, tytuł ma wartość stałą.

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: użyj atrybutu copyRequiresWriterPermission.

labels.starred

boolean

Określa, czy użytkownik oznaczył ten plik gwiazdką.

labels.hidden
(deprecated)

boolean

Tylko dane wyjściowe. Rola wycofana.

labels.trashed

boolean

Wskazuje, czy ten plik został przeniesiony do kosza. Ta etykieta dotyczy wszystkich użytkowników uzyskujących dostęp do pliku. jednak tylko właściciele mogą wyświetlać i przywracać pliki z kosza.

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 ten plik został bezpośrednio usunięty do kosza, a nie rekurencyjny.

createdDate

string

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

modifiedDate

string

Data ostatniej modyfikacji pliku przez dowolną osobę (sygnatura czasowa RFC 3339). Ta wartość można zmienić tylko podczas aktualizacji, gdy ustawiony jest parametr setModifyDate.

modifiedByMeDate

string

Tylko dane wyjściowe. Czas ostatniej modyfikacji pliku przez użytkownika (sygnatura czasowa RFC 3339). Należy pamiętać, że ustawienie changedDate spowoduje też zaktualizowanie datyModifyByMe dla użytkownika, który ustawił tę datę.

lastViewedByMeDate

string

Czas ostatniego wyświetlenia pliku przez użytkownika (sygnatura czasowa 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 RFC 3339).

quotaBytesUsed

string (int64 format)

Tylko dane wyjściowe. Liczba bajtów limitu używanych 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 wysyłającego żądanie.

indexableText

object

Możliwe do indeksowania atrybuty tekstowe pliku (można tylko zapisać)

indexableText.text

string

Tekst do zindeksowania w tym pliku.

originalFilename

string

Pierwotna nazwa pliku z przesłaną treścią, jeśli jest dostępna, lub pierwotna wartość z 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. Wartość nie jest wypełniona w przypadku elementów na dyskach współdzielonych.

canComment
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu capabilities/canComment.

shareable
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu 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. jednak zmiana rozszerzenia w tytule powoduje zaktualizowanie tego pola. To pole jest wypełniane tylko w przypadku plików z treściami przechowywanymi na Dysku Google. nie jest wypełniona 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. Wycofane: użyj atrybutu driveId.

capabilities

object

Tylko dane wyjściowe. Uprawnienia bieżącego użytkownika dotyczące tego 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. Ma wartość false (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, 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 kopiować elementy potomne tego elementu poza folderem lub sam element, jeśli nie jest to folder.

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ć dzieci 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świetlić 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ć dzieci z tego folderu. Ta wartość ma zawsze wartość fałsz, gdy element nie jest folderem. W przypadku folderu na dysku współdzielonym użyj elementu 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 odczytać wersje elementów potomnych tego elementu, które nie są folderami, a także sam element, jeśli nie jest to folder.

capabilities.canReadTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu canReadDrive.

capabilities.canMoveTeamDriveItem
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj właściwości 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 atrybutu 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 atrybutu canMoveItemWithinDrive.

capabilities.canMoveItemOutOfTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu canMoveItemOutOfDrive.

capabilities.canDeleteChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać elementy podrzędne tego folderu. Ma wartość false (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 atrybutu canMoveChildrenOutOfDrive.

capabilities.canMoveChildrenWithinTeamDrive
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu 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. Ma wartość false (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 w zależności od nowo dodawanego elementu nadrzędnego prośba o zmianę elementu nadrzędnego może nadal się nie powieść.

capabilities.canAddMyDriveParent

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodać element nadrzędny dla elementu bez usuwania istniejącego elementu nadrzędnego w tej samej prośbie. Pole nie jest 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 elementu nadrzędnego w tej samej prośbie. Pole nie jest 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 w obrębie tego dysku. Pamiętaj, że prośba o zmianę elementu nadrzędnego dla elementu może nadal się nie powieść w zależności od dodawanego nowego elementu nadrzędnego i elementu nadrzędnego, który chcesz usunąć.

capabilities.canShare

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmieniać 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 w obrębie tego dysku. Ma wartość false (fałsz), gdy element nie jest folderem. Pamiętaj, że prośba o przeniesienie elementu podrzędnego może nadal się nie powieść w zależności od uprawnień bieżącego użytkownika do folderu podrzędnego i do folderu docelowego.

capabilities.canModifyContentRestriction
(deprecated)

boolean

Wycofane: tylko dane wyjściowe. Użyj jednej z tych: 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). Ma wartość false (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 udziału linków.

capabilities.canAcceptOwnership

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik jest oczekującym właścicielem pliku. Pole nie jest 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 odczytywać etykiety 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 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ć lub modyfikować ograniczenia treści objęte ograniczeniami przez właściciela.

capabilities.canRemoveContentRestriction

boolean

Tylko dane wyjściowe. Określa, czy plik jest objęty ograniczeniem treści, który może usunąć bieżący użytkownik.

hasAugmentedPermissions

boolean

Tylko dane wyjściowe. Wskazuje, czy są uprawnienia bezpośrednio do tego pliku. 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ł przeniesiony do kosza bezpośrednio, wskazuje nazwę użytkownika, który go trafił do kosza. Wartość jest podawana tylko w przypadku elementów na dyskach współdzielonych.

canReadRevisions
(deprecated)

boolean

Tylko dane wyjściowe. Wycofane: użyj atrybutu capabilities/canReadRevisions.

thumbnailVersion

string (int64 format)

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

trashedDate

string

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

permissionIds[]

string

Tylko dane wyjściowe. files.list z identyfikatorami uprawnień 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 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 multimediów graficznych. Będzie widoczny tylko w przypadku typów obrazów, a jej zawartość zależy od tego, co można przeanalizować.

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. Rodzaj 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 przechowywane 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ść zapisana na zdjęciu.

imageMediaMetadata.rotation

integer

Tylko dane wyjściowe. Liczba obrotów w prawo o 90 stopni wynikających z oryginalnej 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 trwania ekspozycji w sekundach.

imageMediaMetadata.aperture

number

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

imageMediaMetadata.focalLength

number

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

imageMediaMetadata.isoSpeed

integer

Tylko dane wyjściowe. Czułość 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 wartość przysłony obiektywu na ogniskowej, która została użyta 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 utworzenia zdjęcia.

videoMediaMetadata

object

Tylko dane wyjściowe. Metadane dotyczące multimediów wideo. Ta wartość będzie 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ść podawana tylko w przypadku plików skrótów, które w polu mimeType mają wartość application/vnd.google-apps.shortcut. Można go ustawić tylko dla files.insert żądań.

shortcutDetails.targetId

string

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

shortcutDetails.targetMimeType

string

Tylko dane wyjściowe. Typ MIME pliku, który wskazuje ten skrót. Wartością tego pola jest migawka typu MIME celu, przechwycona 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. Wartość jest wypełniona 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. Określa, czy dla tego pliku jest włączona aktualizacja zabezpieczeń.

labelInfo

object

Tylko dane wyjściowe. Przegląd etykiet w pliku.

labelInfo.labels[]

object (Label)

Tylko dane wyjściowe. Zestaw etykiet w pliku żądanych przez identyfikatory 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łniona 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łniona 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

Określa, czy treść pliku jest tylko do odczytu. Jeśli plik jest tylko do odczytu, nie można dodać do niego nowej wersji ani dodawać i modyfikować komentarzy, nie można też modyfikować nazwy pliku.

reason

string

Przyczyna ograniczenia zawartości pliku. Można ją zmienić tylko w przypadku żądań, w których ustawiono także 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. Wartość jest wypełniona tylko wtedy, gdy readOnly ma wartość true (prawda).

restrictionDate

string

Tylko dane wyjściowe. Godzina ustawienia ograniczenia treści (sygnatura czasowa RFC 3339). Wartość jest wypełniona tylko wtedy, gdy readOnly ma wartość true (prawda).

ownerRestricted

boolean

Określa, czy ograniczenie treści może zmienić lub usunąć tylko użytkownik, do którego należy plik. 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. Informacja, czy system wprowadził ograniczenie dotyczące treści, na przykład z powodu e-podpisu. Użytkownicy nie mogą modyfikować ani usuwać ograniczeń treści ograniczonych przez system.

Metody

copy

Tworzy kopię określonego pliku.

delete

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

emptyTrash

Powoduje trwałe usunięcie wszystkich znajdujących się w koszu plików użytkownika.

export

Powoduje wyeksportowanie dokumentu Google Workspace do żądanego typu MIME i zwrócenie wyeksportowanej zawartości bajtów.

generateIds

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

get

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

insert

Wstawia nowy plik.

list

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

listLabels

Wyświetla listę etykiet pliku.

modifyLabels

Modyfikuje zestaw etykiet zastosowanych do pliku.

patch

Aktualizuje metadane lub treść pliku.

touch

Ustaw czas aktualizacji pliku na aktualny czas serwera.

trash

Przenosi plik do kosza.

untrash

Przywraca plik z kosza.

update

Aktualizuje metadane lub treść pliku.

watch

Subskrybuje zmiany w pliku.