Files

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 addParents i removeParents.

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.
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.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[].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.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 name, ale nie jest usuwane, jeśli nowa nazwa nie zawiera prawidłowego rozszerzenia.

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.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.(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.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:
  • ciąg znaków daty
  • liczba całkowita
  • zaznaczenia
  • plik tekstowy,
  • użytkownik
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[].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.