Listę metod dostępnych dla tego zasobu znajdziesz na końcu tej strony.
Reprezentacje zasobów
Metadane pliku.
{ "kind": "drive#file", "id": string, "name": string, "mimeType": string, "description": string, "starred": boolean, "trashed": boolean, "explicitlyTrashed": boolean, "trashingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "trashedTime": datetime, "parents": [ string ], "properties": { (key): string }, "appProperties": { (key): string }, "spaces": [ string ], "version": long, "webContentLink": string, "webViewLink": string, "iconLink": string, "hasThumbnail": boolean, "thumbnailLink": string, "thumbnailVersion": long, "viewedByMe": boolean, "viewedByMeTime": datetime, "createdTime": datetime, "modifiedTime": datetime, "modifiedByMeTime": datetime, "modifiedByMe": boolean, "sharedWithMeTime": datetime, "sharingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "owners": [ { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string } ], "teamDriveId": string, "driveId": string, "lastModifyingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "shared": boolean, "ownedByMe": boolean, "capabilities": { "canAcceptOwnership": boolean, "canAddChildren": boolean, "canAddFolderFromAnotherDrive": boolean, "canAddMyDriveParent": boolean, "canChangeCopyRequiresWriterPermission": boolean, "canChangeSecurityUpdateEnabled": boolean, "canChangeViewersCanCopyContent": boolean, "canComment": boolean, "canCopy": boolean, "canDelete": boolean, "canDeleteChildren": boolean, "canDownload": boolean, "canEdit": boolean, "canListChildren": boolean, "canModifyContent": boolean, "canModifyContentRestriction": boolean, "canModifyLabels": boolean, "canMoveChildrenOutOfTeamDrive": boolean, "canMoveChildrenOutOfDrive": boolean, "canMoveChildrenWithinTeamDrive": boolean, "canMoveChildrenWithinDrive": boolean, "canMoveItemIntoTeamDrive": boolean, "canMoveItemOutOfTeamDrive": boolean, "canMoveItemOutOfDrive": boolean, "canMoveItemWithinTeamDrive": boolean, "canMoveItemWithinDrive": boolean, "canMoveTeamDriveItem": boolean, "canReadLabels": boolean, "canReadRevisions": boolean, "canReadTeamDrive": boolean, "canReadDrive": boolean, "canRemoveChildren": boolean, "canRemoveMyDriveParent": boolean, "canRename": boolean, "canShare": boolean, "canTrash": boolean, "canTrashChildren": boolean, "canUntrash": boolean }, "viewersCanCopyContent": boolean, "copyRequiresWriterPermission": boolean, "writersCanShare": boolean, "permissions": [ permissions Resource ], "permissionIds": [ string ], "hasAugmentedPermissions": boolean, "folderColorRgb": string, "originalFilename": string, "fullFileExtension": string, "fileExtension": string, "md5Checksum": string, "sha1Checksum": string, "sha256Checksum": string, "size": long, "quotaBytesUsed": long, "headRevisionId": string, "contentHints": { "thumbnail": { "image": bytes, "mimeType": string }, "indexableText": string }, "imageMediaMetadata": { "width": integer, "height": integer, "rotation": integer, "location": { "latitude": double, "longitude": double, "altitude": double }, "time": string, "cameraMake": string, "cameraModel": string, "exposureTime": float, "aperture": float, "flashUsed": boolean, "focalLength": float, "isoSpeed": integer, "meteringMode": string, "sensor": string, "exposureMode": string, "colorSpace": string, "whiteBalance": string, "exposureBias": float, "maxApertureValue": float, "subjectDistance": integer, "lens": string }, "videoMediaMetadata": { "width": integer, "height": integer, "durationMillis": long }, "isAppAuthorized": boolean, "exportLinks": { (key): string }, "shortcutDetails": { "targetId": string, "targetMimeType": string, "targetResourceKey": string }, "contentRestrictions": [ { "readOnly": boolean, "reason": string, "restrictingUser": { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string }, "restrictionTime": datetime, "type": string } ], "labelInfo": { "labels": [ { "kind": "drive#label", "id": string, "revisionId": string, "fields": { (key): { "kind": "drive#labelField", "id": string, "valueType": string, "dateString": [ date ], "integer": [ long ], "selection": [ string ], "text": [ string ], "user": [ { "kind": "drive#user", "displayName": string, "photoLink": string, "me": boolean, "permissionId": string, "emailAddress": string } ] } } } ] }, "resourceKey": string, "linkShareMetadata": { "securityUpdateEligible": boolean, "securityUpdateEnabled": boolean } }
Nazwa usługi | Wartość | Opis | Uwagi |
---|---|---|---|
kind |
string |
Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#file" . |
|
id |
string |
Identyfikator pliku. | zapisywalny |
name |
string |
Nazwa pliku. Nie musi to być niepowtarzalne w obrębie folderu. W przypadku stałych elementów, takich jak foldery najwyższego poziomu na dyskach współdzielonych, folder główny Mojego dysku i folder Dane aplikacji, nazwa jest stała. | zapisywalny |
mimeType |
string |
Typ MIME pliku. Jeśli nie podasz żadnej wartości, Dysk Google spróbuje automatycznie wykryć odpowiednią wartość. Wartość nie może zostać zmieniona, dopóki nie prześlesz nowej wersji. Jeśli plik został utworzony z typem MIME pliku Dokumentów Google, przesłane treści zostaną zaimportowane w miarę możliwości. Obsługiwane formaty importu są opublikowane w sekcji Informacje. |
zapisywalny |
description |
string |
Krótki opis pliku. | zapisywalny |
starred |
boolean |
Określa, czy użytkownik oznaczył plik gwiazdką. | zapisywalny |
trashed |
boolean |
Czy plik został przeniesiony do kosza zarówno bezpośrednio, jak i z folderu nadrzędnego. Tylko właściciel może przenieść plik do kosza. Elementy umieszczone w koszu są wykluczone ze wszystkich odpowiedzi przesłanych przez użytkowników z pliku files.list. Wszyscy użytkownicy z dostępem do tego pliku zobaczą jednak w odpowiedzi interfejsu API metadane elementów, które znajdują się w koszu. Wszyscy użytkownicy z dostępem mogą kopiować, pobierać, eksportować i udostępniać pliki. | zapisywalny |
explicitlyTrashed |
boolean |
Określa, czy plik został świadomie przeniesiony do kosza – czy został świadomie usunięty z folderu nadrzędnego. | |
parents[] |
list |
Identyfikatory folderów nadrzędnych, które zawierają plik. Jeśli nie zostanie określony w żądaniu utworzenia, plik zostanie umieszczony bezpośrednio w folderze Mój dysk użytkownika. Jeśli nie określisz go w żądaniu kopiowania, plik odziedziczy wszystkie możliwe do znalezienia elementy nadrzędne pliku źródłowego. Do zmodyfikowania listy elementów nadrzędnych żądania aktualizacji muszą używać parametrów |
zapisywalny |
properties |
object |
Kolekcja dowolnych par klucz-wartość, które są widoczne dla wszystkich aplikacji. Wpisy z pustymi wartościami są aktualizowane w żądaniach aktualizacji i kopiowania. |
zapisywalny |
properties.(key) |
string |
||
appProperties |
object |
Kolekcja dowolnych par klucz-wartość, które są prywatne dla aplikacji żądającej. Wpisy z pustymi wartościami są aktualizowane w żądaniach aktualizacji i kopiowania. Te właściwości można pobrać tylko z użyciem uwierzytelnionego żądania. Uwierzytelnione żądanie używa tokena dostępu uzyskanego z identyfikatorem klienta OAuth 2. Do pobierania właściwości prywatnych nie można użyć klucza interfejsu API. |
zapisywalny |
appProperties.(key) |
string |
||
spaces[] |
list |
Lista pokoi zawierających plik. Obecnie obsługiwane wartości to „drive”, „appDataFolder” i „photos”. | |
version |
long |
Jednokolorowo rosnący numer wersji pliku. Obejmuje to wszystkie zmiany w pliku na serwerze, nawet te, które nie są widoczne dla użytkownika. | |
webContentLink |
string |
Link umożliwiający pobranie zawartości pliku w przeglądarce. Ta opcja jest dostępna tylko w przypadku plików z treścią binarną na Dysku Google. | |
webViewLink |
string |
Link umożliwiający otwarcie pliku w odpowiednim edytorze lub przeglądarce Google. | |
iconLink |
string |
Statyczny, nieuwierzytelniony link do ikony pliku. | |
thumbnailLink |
string |
Krótkotrwały link do miniatury pliku (jeśli jest dostępna). Zwykle zajmuje to określoną liczbę godzin. Pole wypełnione tylko wtedy, gdy aplikacja żądająca może uzyskać dostęp do zawartości pliku. Jeśli plik nie jest udostępniony publicznie, adres URL zwracany w polu Files.thumbnailLink musi zostać pobrany przy użyciu żądania z uprawnieniami do logowania. |
|
viewedByMe |
boolean |
Określa, czy plik został wyświetlony przez tego użytkownika. | |
viewedByMeTime |
datetime |
Czas ostatniego wyświetlenia pliku przez użytkownika (data i godzina RFC 3339). | zapisywalny |
createdTime |
datetime |
Godzina utworzenia pliku (RFC 3339 – data i godzina). | zapisywalny |
modifiedTime |
datetime |
Godzina ostatniej modyfikacji pliku przez dowolnego użytkownika (RFC 3339 – data i godzina). Pamiętaj, że ustawieniemodyfikacja zmodyfikuje również wartość modyfikacji ModByMeTime dla użytkownika. |
zapisywalny |
modifiedByMeTime |
datetime |
Data ostatniej modyfikacji pliku przez użytkownika (data i godzina RFC 3339). | |
sharedWithMeTime |
datetime |
Data i godzina udostępnienia pliku użytkownikowi (jeśli data i godzina została podana w RFC 3339). | |
sharingUser |
nested object |
Użytkownik, który w razie potrzeby udostępnił plik użytkownikowi wysyłającemu prośbę. | |
sharingUser.kind |
string |
Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#user" . |
|
sharingUser.displayName |
string |
Ten użytkownik może zobaczyć nazwę użytkownika w postaci zwykłego tekstu. | |
sharingUser.photoLink |
string |
Link do zdjęcia profilowego użytkownika (jeśli jest dostępne). | |
sharingUser.me |
boolean |
Określa, czy ten użytkownik jest użytkownikiem wysyłającym prośbę. | |
sharingUser.permissionId |
string |
Identyfikator użytkownika widoczny w zasobach uprawnień. | |
sharingUser.emailAddress |
string |
Adres e-mail użytkownika. Ta informacja może nie być widoczna w niektórych sytuacjach, jeśli użytkownik nie udostępnił swojego adresu e-mail osobie wysyłającej prośbę. | |
owners[] |
list |
Właściciel tego pliku. Tylko niektóre starsze pliki mogą mieć więcej niż jednego właściciela. Pole nie jest wypełniane w przypadku elementów na dyskach współdzielonych. | |
owners[].kind |
string |
Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#user" . |
|
owners[].displayName |
string |
Ten użytkownik może zobaczyć nazwę użytkownika w postaci zwykłego tekstu. | |
owners[].photoLink |
string |
Link do zdjęcia profilowego użytkownika (jeśli jest dostępne). | |
owners[].me |
boolean |
Określa, czy ten użytkownik jest użytkownikiem wysyłającym prośbę. | |
owners[].permissionId |
string |
Identyfikator użytkownika widoczny w zasobach uprawnień. | |
owners[].emailAddress |
string |
Adres e-mail użytkownika. Ta informacja może nie być widoczna w niektórych sytuacjach, jeśli użytkownik nie udostępnił swojego adresu e-mail osobie wysyłającej prośbę. | |
lastModifyingUser |
nested object |
Ostatni użytkownik, który zmodyfikował plik. | |
lastModifyingUser.kind |
string |
Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#user" . |
|
lastModifyingUser.displayName |
string |
Ten użytkownik może zobaczyć nazwę użytkownika w postaci zwykłego tekstu. | |
lastModifyingUser.photoLink |
string |
Link do zdjęcia profilowego użytkownika (jeśli jest dostępne). | |
lastModifyingUser.me |
boolean |
Określa, czy ten użytkownik jest użytkownikiem wysyłającym prośbę. | |
lastModifyingUser.permissionId |
string |
Identyfikator użytkownika widoczny w zasobach uprawnień. | |
lastModifyingUser.emailAddress |
string |
Adres e-mail użytkownika. Ta informacja może nie być widoczna w niektórych sytuacjach, jeśli użytkownik nie udostępnił swojego adresu e-mail osobie wysyłającej prośbę. | |
shared |
boolean |
Wskazuje, czy plik został udostępniony. Niewypełniane w przypadku elementów na dyskach współdzielonych. | |
ownedByMe |
boolean |
Określa, czy użytkownik jest właścicielem pliku. Niewypełniane w przypadku elementów na dyskach współdzielonych. | |
viewersCanCopyContent |
boolean |
Wycofany – użyj copyRequiresWriterPermission . |
|
writersCanShare |
boolean |
Określa, czy użytkownicy z uprawnieniami tylko writer mogą modyfikować uprawnienia pliku. Niewypełniane w przypadku elementów na dyskach współdzielonych. |
zapisywalny |
permissions[] |
list |
Pełna lista uprawnień do pliku. Ta funkcja jest dostępna tylko wtedy, gdy użytkownik, który wysłał prośbę, może udostępnić plik. Niewypełniane w przypadku elementów na dyskach współdzielonych. | |
folderColorRgb |
string |
Kolor folderu lub skrótu folderu w postaci ciągu szesnastkowego RGB. Obsługiwane kolory są publikowane w polu folderColorPalette zasobu. Jeśli określony kolor nie jest obsługiwany, zostanie użyty najbliższy kolor z palety. |
zapisywalny |
originalFilename |
string |
Oryginalna nazwa przesłanego pliku (jeśli jest dostępna) lub pierwotna wartość pola name . Ta opcja jest dostępna tylko w przypadku plików z treścią binarną na Dysku Google. |
zapisywalny |
fullFileExtension |
string |
Pełne rozszerzenie pliku wyodrębnione z pola name . Może zawierać wiele połączonych rozszerzeń, takich jak „tar.gz”. Ta opcja jest dostępna tylko w przypadku plików z treścią binarną na Dysku Google. Ta wartość jest aktualizowana automatycznie po zmianie pola |
|
fileExtension |
string |
Ostatni komponent elementu fullFileExtension . Ta opcja jest dostępna tylko w przypadku plików z treścią binarną na Dysku Google. |
|
md5Checksum |
string |
Suma kontrolna MD5 dla treści pliku. Dotyczy to tylko plików z treściami binarnymi na Dysku Google. | |
size |
long |
Rozmiar zawartości pliku w bajtach. To pole jest wypełniane w przypadku plików z treścią binarną zapisaną na Dysku Google oraz w edytorach Dokumentów. Nie ma wartości w przypadku skrótów i folderów. | |
quotaBytesUsed |
long |
Liczba bajtów miejsca na dane używanych przez plik. Obejmuje to wersję główną oraz poprzednie wersje z włączoną funkcją keepForever . |
|
headRevisionId |
string |
Identyfikator wersji przedpremierowej pliku. Obecnie ta funkcja jest dostępna tylko w przypadku plików z treścią binarną na Dysku Google. | |
contentHints |
object |
Dodatkowe informacje o zawartości pliku. Te pola nigdy nie są wypełniane w odpowiedziach. | |
contentHints.thumbnail |
object |
Miniatura pliku. Ta opcja będzie używana tylko wtedy, gdy Dysk Google nie może wygenerować standardowej miniatury. | |
contentHints.thumbnail.image |
bytes |
Dane miniatur zakodowane w formacie Base64 bezpiecznym pod adresem URL (RFC 4648, sekcja 5). | zapisywalny |
contentHints.thumbnail.mimeType |
string |
Typ MIME miniatury. | zapisywalny |
contentHints.indexableText |
string |
Tekst, który ma być indeksowany dla pliku, aby poprawić zapytania FullText. Jego długość nie może przekraczać 128 KB i może zawierać elementy HTML. Więcej informacji znajdziesz w artykule Zarządzanie metadanymi plików. | zapisywalny |
imageMediaMetadata |
object |
Dodatkowe metadane o multimediach (jeśli są dostępne). | |
imageMediaMetadata.width |
integer |
Szerokość obrazu w pikselach. | |
imageMediaMetadata.height |
integer |
Wysokość obrazu w pikselach. | |
imageMediaMetadata.rotation |
integer |
Liczba obrótów w prawo o 90 stopni zastosowanych z oryginalnej orientacji zdjęcia. | |
imageMediaMetadata.location |
object |
Informacje o lokalizacji geograficznej zapisane na zdjęciu. | |
imageMediaMetadata.location.latitude |
double |
Szerokość geograficzna zapisana w obrazie. | |
imageMediaMetadata.location.longitude |
double |
Długość geograficzna zapisana w obrazie. | |
imageMediaMetadata.location.altitude |
double |
Wysokość zapisana w obrazie. | |
imageMediaMetadata.time |
string |
Data i godzina zrobienia zdjęcia (EXIF DateTime). | |
imageMediaMetadata.cameraMake |
string |
Marka aparatu użytego do utworzenia zdjęcia. | |
imageMediaMetadata.cameraModel |
string |
Model aparatu użyty do utworzenia zdjęcia. | |
imageMediaMetadata.exposureTime |
float |
Długość ekspozycji w sekundach. | |
imageMediaMetadata.aperture |
float |
Przysłona, która służy do tworzenia zdjęcia (wartość F). | |
imageMediaMetadata.flashUsed |
boolean |
Określa, czy do utworzenia zdjęcia została użyta lampa błyskowa. | |
imageMediaMetadata.focalLength |
float |
Ogniskowa podana w milimetrach. | |
imageMediaMetadata.isoSpeed |
integer |
Wartość ISO, która została użyta do utworzenia zdjęcia. | |
imageMediaMetadata.meteringMode |
string |
Tryb pomiaru używany do utworzenia zdjęcia. | |
imageMediaMetadata.sensor |
string |
Typ czujnika użytego do utworzenia zdjęcia. | |
imageMediaMetadata.exposureMode |
string |
Tryb ekspozycji użyty do utworzenia zdjęcia. | |
imageMediaMetadata.colorSpace |
string |
Przestrzeń kolorów zdjęcia. | |
imageMediaMetadata.whiteBalance |
string |
Tryb balansu bieli używany do tworzenia zdjęcia. | |
imageMediaMetadata.exposureBias |
float |
Korekcja ekspozycji zdjęcia (wartość APK). | |
imageMediaMetadata.maxApertureValue |
float |
Najmniejsza liczba f obiektywu na ogniskowej użytej do utworzenia zdjęcia (wartość APK). | |
imageMediaMetadata.subjectDistance |
integer |
Odległość od obiektu na zdjęciu w metrach. | |
imageMediaMetadata.lens |
string |
Obiektyw, którego użyto do utworzenia zdjęcia. | |
videoMediaMetadata |
object |
Dodatkowe metadane dotyczące multimediów. Ta funkcja może nie być dostępna od razu po przesłaniu. | |
videoMediaMetadata.width |
integer |
Szerokość filmu w pikselach. | |
videoMediaMetadata.height |
integer |
Wysokość filmu w pikselach. | |
videoMediaMetadata.durationMillis |
long |
Czas trwania filmu w milisekundach. | |
capabilities |
object |
Uprawnienia, które obecny użytkownik ma w tym pliku. Każde działanie odpowiada szczegółowemu działaniu, które użytkownik może wykonać. | |
capabilities.canEdit |
boolean |
Określa, czy bieżący użytkownik może edytować ten plik. Inne czynniki mogą ograniczać rodzaj zmian, które użytkownik może wprowadzać w pliku. na przykład canChangeCopyRequiresWriterPermission lub canModifyContent . |
|
capabilities.canComment |
boolean |
Określa, czy obecny użytkownik może komentować ten plik. | |
capabilities.canShare |
boolean |
Określa, czy bieżący użytkownik może modyfikować ustawienia udostępniania tego pliku. | |
capabilities.canCopy |
boolean |
Określa, czy bieżący użytkownik może skopiować ten plik. Bieżący użytkownik może kopiować elementy potomne tego elementu lub sam element, jeśli nie jest to folder. Dotyczy to elementu na dysku współdzielonym. | |
capabilities.canReadRevisions |
boolean |
Określa, czy bieżący użytkownik może odczytywać zasoby wersji tego pliku. W przypadku elementów na dysku współdzielonym można odczytywać różne wersje elementów podrzędnych tego folderu albo sam element, jeśli nie jest to folder. | |
isAppAuthorized |
boolean |
Określa, czy plik został utworzony czy otwarty przez aplikację, która wysłała żądanie. | |
hasThumbnail |
boolean |
Określa, czy plik ma miniaturę. Nie wskazuje to, czy aplikacja, która wysłała prośbę, ma dostęp do miniatury. Aby sprawdzić dostęp, poszukaj pola thumbnailLink. | |
thumbnailVersion |
long |
Wersja miniatury do użycia w unieważnianiu pamięci podręcznej miniaturek. | |
modifiedByMe |
boolean |
Określa, czy plik został zmodyfikowany przez tego użytkownika. | |
trashingUser |
nested object |
Jeśli plik został wyraźnie przeniesiony do kosza, użytkownik, który przeniósł go do kosza. Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
trashingUser.kind |
string |
Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#user" . |
|
trashingUser.displayName |
string |
Ten użytkownik może zobaczyć nazwę użytkownika w postaci zwykłego tekstu. | |
trashingUser.photoLink |
string |
Link do zdjęcia profilowego użytkownika (jeśli jest dostępne). | |
trashingUser.me |
boolean |
Określa, czy ten użytkownik jest użytkownikiem wysyłającym prośbę. | |
trashingUser.permissionId |
string |
Identyfikator użytkownika widoczny w zasobach uprawnień. | |
trashingUser.emailAddress |
string |
Adres e-mail użytkownika. Ta informacja może nie być widoczna w niektórych sytuacjach, jeśli użytkownik nie udostępnił swojego adresu e-mail osobie wysyłającej prośbę. | |
trashedTime |
datetime |
Data i godzina przeniesienia elementu do kosza (data i godzina RFC 3339). Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
teamDriveId |
string |
Wycofany – użyj driveId . |
|
capabilities.canAddChildren |
boolean |
Określa, czy bieżący użytkownik może dodawać do tego folderu dzieci. To ustawienie ma zawsze wartość „false”, gdy element nie jest folderem. | |
capabilities.canDelete |
boolean |
Określa, czy bieżący użytkownik może usunąć ten plik. | |
capabilities.canDownload |
boolean |
Określa, czy obecny użytkownik może pobrać ten plik. | |
capabilities.canListChildren |
boolean |
Określa, czy bieżący użytkownik może wyświetlać elementy podrzędne tego folderu. To ustawienie ma zawsze wartość „false”, gdy element nie jest folderem. | |
capabilities.canMoveTeamDriveItem |
boolean |
Wycofany – użyj canMoveItemWithinDrive lub canMoveItemOutOfDrive . |
|
capabilities.canMoveItemIntoTeamDrive |
boolean |
Wycofany – użyj canMoveItemOutOfDrive . |
|
capabilities.canReadTeamDrive |
boolean |
Wycofany – użyj canReadDrive . |
|
capabilities.canRemoveChildren |
boolean |
Określa, czy bieżący użytkownik może usuwać z niego dzieci. To ustawienie ma zawsze wartość „false”, gdy element nie jest folderem. Zamiast folderu na dysku współdzielonym użyj canDeleteChildren lub canTrashChildren . |
|
capabilities.canRename |
boolean |
Określa, czy bieżący użytkownik może zmienić nazwę tego pliku. | |
capabilities.canTrash |
boolean |
Określa, czy bieżący użytkownik może przenieść ten plik do kosza. | |
capabilities.canUntrash |
boolean |
Określa, czy bieżący użytkownik może przywrócić ten plik z kosza. | |
hasAugmentedPermissions |
boolean |
Wskazuje, czy plik ma uprawnienia. To pole jest wypełnione tylko w przypadku elementów na dyskach współdzielonych. | |
capabilities.canChangeViewersCanCopyContent |
boolean |
Wycofany. | |
permissionIds[] |
list |
Lista identyfikatorów uprawnień użytkowników, którzy mają dostęp do tego pliku. | |
capabilities.canChangeCopyRequiresWriterPermission |
boolean |
Określa, czy bieżący użytkownik może zmienić ograniczenie dotyczące tego pliku (copyRequiresWriterPermission ). |
|
copyRequiresWriterPermission |
boolean |
Niezależnie od tego, czy opcje kopiowania, drukowania, pobierania tego pliku powinny być wyłączone dla czytelników i komentujących, | zapisywalny |
capabilities.canDeleteChildren |
boolean |
Określa, czy obecny użytkownik może usuwać elementy podrzędne tego folderu. Ta wartość nie działa, gdy element nie jest folderem. Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
capabilities.canMoveChildrenOutOfTeamDrive |
boolean |
Wycofany – użyj canMoveChildrenOutOfDrive . |
|
capabilities.canMoveChildrenWithinTeamDrive |
boolean |
Wycofany – użyj canMoveChildrenWithinDrive . |
|
capabilities.canMoveItemOutOfTeamDrive |
boolean |
Wycofany – użyj canMoveItemOutOfDrive . |
|
capabilities.canMoveItemWithinTeamDrive |
boolean |
Wycofany – użyj canMoveItemWithinDrive . |
|
capabilities.canTrashChildren |
boolean |
Określa, czy bieżący użytkownik może przenieść do kosza elementy podrzędne tego folderu. Ta wartość nie działa, gdy element nie jest folderem. Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
exportLinks |
object |
Linki umożliwiające eksportowanie plików edytorów Dokumentów do określonych formatów. | |
exportLinks.(key) |
string |
Mapowanie z formatu eksportu na adres URL | |
driveId |
string |
Identyfikator dysku współdzielonego, na którym znajduje się plik. Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
capabilities.canMoveChildrenOutOfDrive |
boolean |
Określa, czy bieżący użytkownik może przenosić elementy podrzędne tego folderu poza dysk współdzielony. Ta wartość nie działa, gdy element nie jest folderem. Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
capabilities.canMoveChildrenWithinDrive |
boolean |
Określa, czy bieżący użytkownik może przenosić elementy podrzędne tego folderu na tym dysku. Ta wartość nie działa, gdy element nie jest folderem. Pamiętaj, że żądanie przeniesienia dziecka może się nie powieść w zależności od dostępu bieżącego użytkownika do folderu podrzędnego i folderu docelowego. | |
capabilities.canMoveItemOutOfDrive |
boolean |
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 dodanego elementu nadrzędnego żądanie zmiany elementu nadrzędnego nadal może kończyć się niepowodzeniem. | |
capabilities.canMoveItemWithinDrive |
boolean |
Określa, czy bieżący użytkownik może przenieść ten element na ten dysk. Pamiętaj, że prośba o zmianę elementu nadrzędnego wciąż może nie zostać zrealizowana w zależności od nowo dodanego elementu nadrzędnego i usuniętego elementu nadrzędnego. | |
capabilities.canReadDrive |
boolean |
Określa, czy bieżący użytkownik może odczytywać dysk współdzielony, do którego należy ten plik. Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
capabilities.canModifyContent |
boolean |
Określa, czy bieżący użytkownik może modyfikować zawartość tego pliku. | |
capabilities.canAddMyDriveParent |
boolean |
Określa, czy bieżący użytkownik może dodać element nadrzędny dla elementu bez usuwania istniejącego elementu nadrzędnego w tym samym żądaniu. Niewypełniane w przypadku plików na dysku współdzielonym. | |
capabilities.canRemoveMyDriveParent |
boolean |
Określa, czy bieżący użytkownik może usunąć z tego elementu nadrzędnego bez dodawania kolejnego rodzica w tym samym żądaniu. Niewypełniane w przypadku plików na dysku współdzielonym. | |
shortcutDetails |
object |
Szczegóły pliku skrótu. Wartość wypełniana tylko w przypadku plików skrótów, które mają w polu MIME typ application/vnd.google-apps.shortcut . |
|
shortcutDetails.targetId |
string |
Identyfikator pliku, do którego wskazuje ten skrót. | zapisywalny |
shortcutDetails.targetMimeType |
string |
Typ MIME pliku, do którego wskazuje ten skrót. Wartość tego pola jest migawką typu MIME celu przechwytywanego podczas tworzenia skrótu. | |
capabilities.canAddFolderFromAnotherDrive |
boolean |
Określa, czy bieżący użytkownik może dodać do tego folderu inny dysk (inny dysk współdzielony lub Mój dysk). Ta wartość nie działa, gdy element nie jest folderem. Wartość podawana tylko w przypadku elementów na dyskach współdzielonych. | |
capabilities.canModifyContentRestriction |
boolean |
Określa, czy obecny użytkownik może modyfikować ograniczenia dotyczące treści tego pliku. | |
contentRestrictions[] |
list |
Ograniczenia dostępu do zawartości pliku. Wartość podawana tylko wtedy, gdy takie ograniczenie występuje. | |
contentRestrictions[].readOnly |
boolean |
Określa, czy zawartość pliku jest tylko do odczytu. Jeśli plik jest tylko do odczytu, nie można dodawać nowych wersji, komentarzy nie można dodawać ani modyfikować, a tytuł pliku nie może być modyfikowany. | zapisywalny |
contentRestrictions[].reason |
string |
Przyczyna ograniczenia treści pliku. Można to zmienić tylko w przypadku żądań, które mają też ustawioną wartość readOnly=true . |
zapisywalny |
contentRestrictions[].restrictingUser |
nested object |
Użytkownik, który ustawił ograniczenie treści. Wartość wypełniana tylko wtedy, gdy readOnly ma wartość Prawda. |
|
contentRestrictions[].restrictingUser.kind |
string |
Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#user" . |
|
contentRestrictions[].restrictingUser.displayName |
string |
Ten użytkownik może zobaczyć nazwę użytkownika w postaci zwykłego tekstu. | |
contentRestrictions[].restrictingUser.photoLink |
string |
Link do zdjęcia profilowego użytkownika (jeśli jest dostępne). | |
contentRestrictions[].restrictingUser.me |
boolean |
Określa, czy ten użytkownik jest użytkownikiem wysyłającym prośbę. | |
contentRestrictions[].restrictingUser.permissionId |
string |
Identyfikator użytkownika widoczny w zasobach uprawnień. | |
contentRestrictions[].restrictingUser.emailAddress |
string |
Adres e-mail użytkownika. Ta informacja może nie być widoczna w niektórych sytuacjach, jeśli użytkownik nie udostępnił swojego adresu e-mail osobie wysyłającej prośbę. | |
contentRestrictions[].restrictionTime |
datetime |
Czas ustawienia ograniczenia treści (w formacie RFC 3339). Wartość wypełniana tylko wtedy, gdy readOnly ma wartość Prawda. |
|
contentRestrictions[].type |
string |
Typ ograniczenia treści. Obecnie jedyną możliwą wartością jest globalContentRestriction . |
|
capabilities.canChangeSecurityUpdateEnabled |
boolean |
Określa, czy bieżący użytkownik może zmienić pole securityUpdateEnabled w metadanych udostępniania linków. | |
shortcutDetails.targetResourceKey |
string |
Wartość ResourceKey pliku docelowego. | |
resourceKey |
string |
Klucz potrzebny do uzyskania dostępu do elementu za pomocą udostępnionego linku. | |
linkShareMetadata |
object |
Zawiera szczegółowe informacje o adresach URL linków, których klienci używają w odniesieniu do tego elementu. | |
linkShareMetadata.securityUpdateEligible |
boolean |
Określa, czy plik kwalifikuje się do aktualizacji zabezpieczeń. | |
linkShareMetadata.securityUpdateEnabled |
boolean |
Określa, czy w przypadku tego pliku jest włączona aktualizacja zabezpieczeń. | |
capabilities.canAcceptOwnership |
boolean |
Określa, czy bieżący użytkownik jest oczekiwanym właścicielem pliku. Niewypełniane w przypadku plików na dysku współdzielonym. | |
capabilities.canModifyLabels |
boolean |
Określa, czy bieżący użytkownik może modyfikować etykiety w tym pliku. | |
capabilities.canReadLabels |
boolean |
Określa, czy bieżący użytkownik może odczytywać etykiety w tym pliku. | |
labelInfo |
object |
Przegląd etykiet w pliku. | |
labelInfo.labels[] |
list |
Zbiór etykiet w pliku zgodnie z wymaganiami identyfikatorów etykiet w parametrze includeLabels . Domyślnie nie są zwracane żadne etykiety. |
|
labelInfo.labels[].kind |
string |
To jest zawsze Drive#label | |
labelInfo.labels[].id |
string |
Identyfikator etykiety. | |
labelInfo.labels[].revisionId |
string |
Identyfikator wersji etykiety. | |
labelInfo.labels[].fields |
object |
Mapa pól etykiety według identyfikatora pola. | |
labelInfo.labels[].fields.(key) |
nested object |
||
labelInfo.labels[].fields.(key).kind |
string |
To jest zawsze „##FieldField”. | |
labelInfo.labels[].fields.(key).id |
string |
Identyfikator tego pola. | |
labelInfo.labels[].fields.(key).valueType |
string |
Typ pola. W przyszłości nowe wartości mogą być obsługiwane, jednak obecnie dozwolone są następujące opcje:
|
|
labelInfo.labels[].fields.(key).dateString[] |
list |
Widoczny tylko wtedy, gdy valueType ma wartość dateString . Data w formacie RFC 3339: RRRR-MM-DD. |
|
labelInfo.labels[].fields.(key).integer[] |
list |
Widoczny tylko wtedy, gdy valueType ma wartość integer . |
|
labelInfo.labels[].fields.(key).selection[] |
list |
Widoczny tylko wtedy, gdy valueType ma wartość selection . |
|
labelInfo.labels[].fields.(key).text[] |
list |
Widoczny tylko wtedy, gdy valueType ma wartość text . |
|
labelInfo.labels[].fields.(key).user[] |
list |
Widoczny tylko wtedy, gdy valueType ma wartość user . |
|
labelInfo.labels[].fields.(key).user[].kind |
string |
Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#user" . |
|
labelInfo.labels[].fields.(key).user[].displayName |
string |
Ten użytkownik może zobaczyć nazwę użytkownika w postaci zwykłego tekstu. | |
labelInfo.labels[].fields.(key).user[].photoLink |
string |
Link do zdjęcia profilowego użytkownika (jeśli jest dostępne). | |
labelInfo.labels[].fields.(key).user[].me |
boolean |
Określa, czy ten użytkownik jest użytkownikiem wysyłającym prośbę. | |
labelInfo.labels[].fields.(key).user[].permissionId |
string |
Identyfikator użytkownika widoczny w zasobach uprawnień. | |
labelInfo.labels[].fields.(key).user[].emailAddress |
string |
Adres e-mail użytkownika. Ta informacja może nie być widoczna w niektórych sytuacjach, jeśli użytkownik nie udostępnił swojego adresu e-mail osobie wysyłającej prośbę. | |
sha1Checksum |
string |
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ą zapisaną na Dysku Google. Nie jest wypełniane w przypadku edytorów Dokumentów i plików skrótów. | |
sha256Checksum |
string |
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ą zapisaną na Dysku Google. Nie jest wypełniane w przypadku edytorów Dokumentów i plików skrótów. |
Metody
- kopiuj
- Tworzy kopię pliku i stosuje wymagane aktualizacje za pomocą semantyki poprawki. Nie można skopiować folderów.
- utwórz
- Utworzy plik.
- usuń
- Trwale usuwa plik należący do użytkownika bez przenoszenia go do kosza. Jeśli plik należy do dysku współdzielonego, użytkownik musi być organizatorem na dysku nadrzędnym. Jeśli folder docelowy jest folderem, wszystkie jego elementy podrzędne, które należą do użytkownika, również zostaną usunięte.
- Opróżnij kosz
- Trwale usuwa wszystkie pliki użytkownika znajdujące się w koszu.
- eksport
- Eksportuje dokument Google Workspace do żądanego typu MIME i zwraca zawartość wyeksportowanych bajtów. Pamiętaj, że rozmiar wyeksportowanych treści nie może przekraczać 10 MB.
- generateIds
- Generuje zestaw identyfikatorów plików, które można podawać w żądaniach tworzenia lub kopiowania.
- pobierz
- Pobiera metadane lub treści pliku na podstawie identyfikatora.
- list
- Wyświetla listy lub pliki.
- zaktualizuj
- Aktualizuje metadane lub zawartość pliku. Wywołując tę metodę, wypełnij tylko pola w żądaniu, które chcesz zmodyfikować. Podczas aktualizowania niektórych pól niektóre pola mogą ulegać automatycznej zmianie, na przykład zmodyfikowana data. Ta metoda obsługuje semantykę poprawki.
- zegarek
- Subskrybuje zmiany w pliku. Możesz określić kanał dla zmian na pliku współdzielonym, ale zmiana w pliku na dysku współdzielonym nie spowoduje utworzenia powiadomienia.
- listLabel
- Wyświetla listę etykiet w pliku.
- modifyLabel
- Modyfikuje zestaw etykiet w pliku.