REST Resource: drives

Zasób: Dysk

Reprezentacja dysku współdzielonego.

Niektóre metody zasobów (takie jak drives.update) wymagają driveId. Użyj metody drives.list, aby pobrać identyfikator dysku współdzielonego.

Zapis JSON
{
  "id": string,
  "name": string,
  "colorRgb": string,
  "kind": string,
  "backgroundImageLink": string,
  "capabilities": {
    "canAddChildren": boolean,
    "canComment": boolean,
    "canCopy": boolean,
    "canDeleteDrive": boolean,
    "canDownload": boolean,
    "canEdit": boolean,
    "canListChildren": boolean,
    "canManageMembers": boolean,
    "canReadRevisions": boolean,
    "canRename": boolean,
    "canRenameDrive": boolean,
    "canChangeDriveBackground": boolean,
    "canShare": boolean,
    "canChangeCopyRequiresWriterPermissionRestriction": boolean,
    "canChangeDomainUsersOnlyRestriction": boolean,
    "canChangeDriveMembersOnlyRestriction": boolean,
    "canChangeSharingFoldersRequiresOrganizerPermissionRestriction": boolean,
    "canResetDriveRestrictions": boolean,
    "canDeleteChildren": boolean,
    "canTrashChildren": boolean
  },
  "themeId": string,
  "backgroundImageFile": {
    "id": string,
    "xCoordinate": number,
    "yCoordinate": number,
    "width": number
  },
  "createdTime": string,
  "hidden": boolean,
  "restrictions": {
    "copyRequiresWriterPermission": boolean,
    "domainUsersOnly": boolean,
    "driveMembersOnly": boolean,
    "adminManagedRestrictions": boolean,
    "sharingFoldersRequiresOrganizerPermission": boolean
  },
  "orgUnitId": string
}
Pola
id

string

Tylko dane wyjściowe. Identyfikator tego dysku współdzielonego, który jest też identyfikatorem folderu najwyższego poziomu na tym dysku współdzielonym.

name

string

Nazwa tego dysku współdzielonego.

colorRgb

string

Kolor tego dysku współdzielonego w postaci ciągu szesnastkowego RGB. Można go ustawić tylko dla żądania drive.drives.update, które nie ma ustawionej themeId.

kind

string

Tylko dane wyjściowe. Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#drive".

capabilities

object

Tylko dane wyjściowe. Uprawnienia bieżącego użytkownika na tym dysku współdzielonym.

capabilities.canAddChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać dzieci do folderów na tym dysku współdzielonym.

capabilities.canComment

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać komentarze do plików na tym dysku współdzielonym.

capabilities.canCopy

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może kopiować pliki z tego dysku współdzielonego.

capabilities.canDeleteDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usunąć ten dysk współdzielony. Próba usunięcia dysku współdzielonego może nadal się nie udać, jeśli znajdują się na nim nieużywane elementy.

capabilities.canDownload

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może pobierać pliki z tego dysku współdzielonego.

capabilities.canEdit

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może edytować pliki na tym dysku współdzielonym

capabilities.canListChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może wyświetlać elementy podrzędne folderów na tym dysku współdzielonym.

capabilities.canManageMembers

boolean

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

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może odczytywać zasób wersji plików na tym dysku współdzielonym.

capabilities.canRename

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmieniać nazwy plików lub folderów na tym dysku współdzielonym.

capabilities.canRenameDrive

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić nazwę tego dysku współdzielonego.

capabilities.canChangeDriveBackground

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmieniać tło tego dysku współdzielonego.

capabilities.canShare

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może udostępniać pliki i foldery na tym dysku współdzielonym.

capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie copyRequiresWriterPermission tego dysku współdzielonego.

capabilities.canChangeDomainUsersOnlyRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie domainUsersOnly tego dysku współdzielonego.

capabilities.canChangeDriveMembersOnlyRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie driveMembersOnly tego dysku współdzielonego.

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie sharingFoldersRequiresOrganizerPermission tego dysku współdzielonego.

capabilities.canResetDriveRestrictions

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zresetować ograniczenia dysku współdzielonego do wartości domyślnych.

capabilities.canDeleteChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać dzieci z folderów na tym dysku współdzielonym.

capabilities.canTrashChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przenieść do kosza elementy podrzędne z folderów na tym dysku współdzielonym.

themeId

string

Identyfikator motywu, z którego zostanie ustawiony obraz i kolor tła. Zbiór możliwych elementów driveThemes można pobrać z odpowiedzi drive.about.get. Jeśli w żądaniu drive.drives.create nie określono tego ustawienia, zostanie wybrany losowy motyw, na podstawie którego ustawiany jest obraz i kolor tła. To jest pole tylko do zapisu; można go ustawiać tylko dla żądań, które nie mają ustawionego colorRgb ani backgroundImageFile.

backgroundImageFile

object

Plik graficzny z parametrami przycinania, na podstawie których ustawiany jest obraz tła tego dysku współdzielonego. To jest pole tylko do zapisu; można go ustawić tylko dla żądań drive.drives.update, które nie mają ustawionej themeId. Jeśli określisz wartość, wszystkie pola w tabeli backgroundImageFile muszą być ustawione.

backgroundImageFile.id

string

Identyfikator pliku graficznego na Dysku Google, który ma być używany jako obraz tła.

backgroundImageFile.xCoordinate

number

Współrzędna X lewego górnego rogu obszaru przycięcia na obrazie tła. Podana wartość mieści się w zakresie zamkniętym od 0 do 1. Ta wartość reprezentuje odległość w poziomie od lewej strony całego obrazu do lewej krawędzi obszaru przycinania podzieloną przez szerokość całego obrazu.

backgroundImageFile.yCoordinate

number

Współrzędna Y lewego górnego rogu obszaru przycięcia na obrazie tła. Podana wartość mieści się w zakresie zamkniętym od 0 do 1. Ta wartość reprezentuje odległość w pionie od górnej krawędzi całego obrazu do górnej krawędzi obszaru przycięcia podzielonego przez wysokość całego obrazu.

backgroundImageFile.width

number

Szerokość przyciętego obrazu w zamkniętym zakresie od 0 do 1. Ta wartość reprezentuje szerokość przyciętego obrazu podzieloną przez szerokość całego obrazu. Wysokość jest obliczana przez zastosowanie współczynnika proporcji szerokości do wysokości o wartości 80–9. Otrzymany obraz musi mieć co najmniej 1280 pikseli szerokości i 144 piksele wysokości.

createdTime

string

Tylko dane wyjściowe. Godzina utworzenia dysku współdzielonego (data i godzina w dokumencie RFC 3339).

hidden

boolean

Określa, czy dysk współdzielony jest ukryty w widoku domyślnym.

restrictions

object

Zestaw ograniczeń dotyczących tego dysku współdzielonego lub znajdujących się na nim elementów. Pamiętaj, że podczas tworzenia dysku współdzielonego nie można ustawić ograniczeń. Aby dodać ograniczenie, najpierw utwórz dysk współdzielony, a następnie użyj narzędzia drives.update.

restrictions.copyRequiresWriterPermission

boolean

Opcje kopiowania, drukowania i pobierania plików z tego dysku współdzielonego powinny być wyłączone dla czytelników i komentujących. Gdy to ograniczenie jest ustawione na true, zastępuje ono pole o podobnej nazwie z wartością true w przypadku wszystkich plików na tym dysku współdzielonym.

restrictions.domainUsersOnly

boolean

Określa, czy dostęp do tego dysku współdzielonego i znajdujących się na nim elementów jest ograniczony do użytkowników w domenie, do której należy ten dysk współdzielony. 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 jego użytkowników.

restrictions.adminManagedRestrictions

boolean

Określa, czy do modyfikowania ograniczeń wymagane są uprawnienia administratora tego dysku współdzielonego.

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Jeśli ma wartość prawda, tylko użytkownicy z rolą organizatora mogą udostępniać foldery. Jeśli ma wartość false (fałsz), użytkownicy z przypisaną rolą organizatora lub organizatora plików mogą udostępniać foldery.

orgUnitId

string

Tylko dane wyjściowe. Jednostka organizacyjna tego dysku współdzielonego. To pole jest wypełniane tylko w odpowiedziach typu drives.list, gdy parametr useDomainAdminAccess ma wartość true.

Metody

create

Tworzy dysk współdzielony.

delete

Trwale usuwa dysk współdzielony, którego użytkownik ma uprawnienia organizer.

get

Pobiera metadane dysku współdzielonego według identyfikatora.

hide

Ukrywa dysk współdzielony w widoku domyślnym.

list

Wyświetla listę dysków współdzielonych użytkownika.

unhide

Przywraca widok domyślny dysku współdzielonego.

update

Aktualizuje metadane dysku współdzielonego.