Drives

Listę metod dostępnych dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Prezentacja dysku współdzielonego.

{
  "kind": "drive#drive",
  "id": string,
  "name": string,
  "themeId": string,
  "colorRgb": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": float,
    "yCoordinate": float,
    "width": float
  },
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveBackground": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteChildren": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canResetDriveRestrictions": boolean,
    "canShare": boolean,
    "canTrashChildren": boolean
  },
  "createdTime": datetime,
  "orgUnitId": string,
  "hidden": boolean,
  "restrictions": {
    "adminManagedRestrictions": boolean,
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  }
}
Nazwa usługi Wartość Opis Uwagi
kind string Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#drive".
id string Identyfikator tego dysku współdzielonego, który jest też identyfikatorem folderu najwyższego poziomu na tym dysku.
name string Nazwa tego dysku współdzielonego. zapisywalny
themeId string Identyfikator motywu, z którego został ustawiony obraz i kolor tła. Zbiór możliwych driveThemes można pobrać z odpowiedzi drive.about.get. Jeśli nie określisz tego ustawienia w żądaniu drive.drives.create, zostanie wybrany losowy motyw, na którym zostanie ustawiony obraz i kolor tła. To jest pole tylko do zapisu; można je ustawić tylko w przypadku żądań, które nie mają właściwości colorRgb ani backgroundImageFile. zapisywalny
colorRgb string Kolor tego dysku współdzielonego jako ciąg szesnastkowy RGB. Możesz go ustawić tylko w przypadku drive.drives.update żądań, które nie mają ustawionego themeId. zapisywalny
backgroundImageFile object Plik graficzny z parametrami przycinania, na podstawie których ustawiono obraz tła tego dysku współdzielonego. To jest pole tylko do zapisu; można je ustawić tylko dla żądań drive.drives.update, które nie ustawiają themeId. Jeśli jest określona, należy ustawić wszystkie pola obiektu backgroundImageFile. zapisywalny
backgroundImageFile.id string Identyfikator pliku obrazu na Dysku Google, który ma być używany jako obraz tła.
backgroundImageFile.xCoordinate float Współrzędna X w lewym górnym rogu obszaru przycinania na obrazie tła. To wartość w zakresie zamkniętym od 0 do 1. Ta wartość to odległość w poziomie od lewej strony całego zdjęcia do lewej strony obszaru przycinania podzielona przez szerokość całego obrazu.
backgroundImageFile.yCoordinate float Współrzędna Y lewego górnego rogu obszaru przycinania na obrazie tła. To wartość w zakresie zamkniętym od 0 do 1. Ta wartość przedstawia odległość pionową od górnej krawędzi całego obrazu do górnej krawędzi obszaru przycinania podzielona przez wysokość całego obrazu.
backgroundImageFile.width float Szerokość przyciętego obrazu w zamkniętym zakresie od 0 do 1. Ta szerokość to szerokość przyciętego obrazu podzielona przez szerokość całego obrazu. Wysokość jest obliczana przez zastosowanie współczynnika proporcji wysokości do 80–9. Obraz końcowy musi mieć co najmniej 1280 pikseli szerokości i 144 pikseli wysokości.
capabilities object Uprawnienia obecnego użytkownika na tym dysku współdzielonym.
capabilities.canAddChildren boolean Określa, czy bieżący użytkownik może dodawać dzieci do folderów na tym dysku współdzielonym.
capabilities.canChangeCopyRequiresWriterPermissionRestriction boolean Określa, czy bieżący użytkownik może zmienić ograniczenie dotyczące tego dysku współdzielonego (copyRequiresWriterPermission).
capabilities.canChangeDomainUsersOnlyRestriction boolean Określa, czy bieżący użytkownik może zmienić ograniczenie dotyczące tego dysku współdzielonego (domainUsersOnly).
capabilities.canChangeDriveBackground boolean Określa, czy bieżący użytkownik może zmienić tło tego dysku współdzielonego.
capabilities.canChangeDriveMembersOnlyRestriction boolean Określa, czy bieżący użytkownik może zmienić ograniczenie dotyczące tego dysku współdzielonego (driveMembersOnly).
capabilities.canComment boolean Określa, czy bieżący użytkownik może komentować pliki na tym dysku współdzielonym.
capabilities.canCopy boolean Określa, czy bieżący użytkownik może kopiować pliki z tego dysku współdzielonego.
capabilities.canDeleteChildren boolean Określa, czy bieżący użytkownik może usuwać dzieci z folderów na tym dysku współdzielonym.
capabilities.canDeleteDrive boolean Określa, czy bieżący użytkownik może usunąć ten dysk współdzielony. Próba usunięcia dysku współdzielonego może zakończyć się niepowodzeniem, jeśli zawiera on elementy, których nie udało się przywrócić.
capabilities.canDownload boolean Określa, czy bieżący użytkownik może pobierać pliki z tego dysku współdzielonego.
capabilities.canEdit boolean Określa, czy bieżący użytkownik może edytować pliki na tym dysku współdzielonym
capabilities.canListChildren boolean Określa, czy bieżący użytkownik może wyświetlać elementy podrzędne folderów na tym dysku współdzielonym.
capabilities.canManageMembers boolean Określa, czy bieżący użytkownik może dodawać użytkowników do tego dysku współdzielonego, usuwać ich lub zmieniać ich role.
capabilities.canReadRevisions boolean Określa, czy bieżący użytkownik może odczytywać zasoby wersji na tym dysku współdzielonym.
capabilities.canRename boolean Określa, czy bieżący użytkownik może zmieniać nazwy plików i folderów na tym dysku współdzielonym.
capabilities.canRenameDrive boolean Określa, czy bieżący użytkownik może zmienić nazwę tego dysku współdzielonego.
capabilities.canShare boolean Określa, czy bieżący użytkownik może udostępniać pliki lub foldery na tym dysku współdzielonym.
capabilities.canTrashChildren boolean Określa, czy bieżący użytkownik może przenieść do kosza pliki z folderów na tym dysku współdzielonym.
createdTime datetime Godzina utworzenia dysku współdzielonego (RFC 3339 – data i godzina).
hidden boolean Określa, czy dysk współdzielony jest ukryty w widoku domyślnym. zapisywalny
restrictions object Zestaw ograniczeń, które dotyczą tego dysku współdzielonego lub znajdujących się na nim elementów. zapisywalny
restrictions.adminManagedRestrictions boolean Określa, czy do modyfikowania ograniczeń są wymagane uprawnienia administratora tego dysku współdzielonego.
restrictions.copyRequiresWriterPermission boolean Niezależnie od tego, czy opcje kopiowania, drukowania i pobierania plików z tego dysku współdzielonego są wyłączone dla czytelników i komentujących, należy wyłączyć to ustawienie. Gdy to ograniczenie jest ustawione na true, w przypadku każdego pliku na tym dysku współdzielonym nazwa pola o podobnej nazwie zostanie zastąpiona wartością true.
restrictions.domainUsersOnly boolean To, czy dostęp do tego dysku współdzielonego i znajdujących się na nim elementów jest ograniczony do użytkowników domeny, do której on należy. To ograniczenie może zostać zastąpione przez inne zasady udostępniania kontrolowane poza tym dyskiem współdzielonym.
restrictions.driveMembersOnly boolean Określa, czy dostęp do elementów na tym dysku współdzielonym jest ograniczony do użytkowników.
orgUnitId string Jednostka organizacyjna tego dysku współdzielonego. To pole jest zapełniane wyłącznie w przypadku odpowiedzi drives.list, jeśli parametr useDomainAdminAccess jest ustawiony na true.
capabilities.canResetDriveRestrictions boolean Określa, czy bieżący użytkownik może zresetować ograniczenia dysku współdzielonego do wartości domyślnych.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction boolean Określa, czy bieżący użytkownik może zmienić ograniczenie dotyczące tego dysku współdzielonego (sharingFoldersRequiresOrganizerPermission).
restrictions.sharingFoldersRequiresOrganizerPermission boolean Jeśli ma wartość true (prawda), tylko użytkownicy z rolą organizatora mogą udostępniać foldery. Jeśli ma wartość false (fałsz), użytkownicy z rolą organizatora lub organizatora plików mogą udostępniać foldery.

Metody

utwórz
Tworzy dysk współdzielony.
usuń
Trwale usuwa dysk współdzielony, na którym użytkownik jest organizatorem. Dysk współdzielony nie może zawierać żadnych elementów, których nie można przywrócić.
pobierz
Pobiera metadane dysku współdzielonego według identyfikatora.
ukryj
Ukryj dysk współdzielony w widoku domyślnym.
list
Wyświetla listę dysków współdzielonych użytkownika.
Odkryj
Przywróć dysk współdzielony do widoku domyślnego.
zaktualizuj
Aktualizuje metadane dysku współdzielonego.