REST Resource: drives

Zasób: Dysk

Prezentacja dysku współdzielonego.

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

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
  },
  "createdDate": 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 szesnastkowego ciągu RGB. Można go ustawić tylko w żądaniu drive.drives.update, które nie ustawia themeId.
kind

string

Tylko dane wyjściowe. To zawsze 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 komentować pliki na tym dysku współdzielonym.
capabilities.canCopy

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może kopiować pliki na tym dysku współdzielonym.
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 się nie powieść, jeśli znajdują się na nim elementy przywrócone z kosza.
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ć listę elementów podrzędnych 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 lub foldery na tym dysku współdzielonym.
capabilities.canChangeCopyRequiresWriterPermissionRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie typu copyRequiresWriterPermission na tym dysku współdzielonym.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie typu domainUsersOnly na tym dysku współdzielonym.
capabilities.canChangeDriveMembersOnlyRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie typu driveMembersOnly na tym dysku współdzielonym.
capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie typu sharingFoldersRequiresOrganizerPermission na tym dysku współdzielonym.
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 przenosić dzieci do kosza z folderów na tym dysku współdzielonym.
themeId

string

Identyfikator motywu, w którym zostanie ustawiony obraz i kolor tła. Zbiór możliwych elementów driveThemes można pobrać z odpowiedzi drive.about.get. Jeśli nie określono ich w żądaniu drive.drives.insert, wybrany jest losowy motyw, na podstawie którego ustawiany jest obraz i kolor tła. To pole jest przeznaczone tylko do zapisu. Można je ustawiać tylko w żądaniach, które nie mają ustawionej wartości colorRgb ani backgroundImageFile.
backgroundImageFile

object

Plik graficzny i parametry przycinania, według których został ustawiony obraz tła na tym dysku współdzielonym. To pole jest przeznaczone tylko do zapisu. Można je ustawić tylko w żądaniach drive.drives.update, które nie mają ustawionej wartości themeId. Jeśli jest określony, wszystkie pola 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 przycinania obrazu tła. Jest to wartość z zamkniętego zakresu od 0 do 1. Jest to odległość w poziomie od lewej strony całego obrazu do lewej strony obszaru przycinania podzielona przez szerokość całego obrazu.
backgroundImageFile.yCoordinate

number

Współrzędna Y lewego górnego rogu obszaru przycinania w obrazie tła. Jest to wartość z zamkniętego zakresu od 0 do 1. Jest to odległość w pionie od górnej krawędzi całego obrazu do górnej krawędzi obszaru przycinania podzielona 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 podzielona przez szerokość całego obrazu. Wysokość jest obliczana przez zastosowanie współczynnika proporcji szerokości do wysokości 80–9. Powstały obraz musi mieć co najmniej 1280 pikseli szerokości i 144 pikseli wysokości.
createdDate

string

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

boolean

Określa, czy dysk współdzielony ma być ukryty w widoku domyślnym.
restrictions

object

Zestaw ograniczeń, które mają zastosowanie do tego dysku współdzielonego lub do znajdujących się na nim elementów.
restrictions.copyRequiresWriterPermission

boolean

Określa, czy opcje kopiowania, drukowania i pobierania plików z tego dysku współdzielonego mają być wyłączone dla czytelników i komentujących. Jeśli to ograniczenie ma wartość true, zastąpi ono pole o podobnej nazwie co true w przypadku każdego pliku na tym dysku współdzielonym.
restrictions.domainUsersOnly

boolean

Określa, czy dostęp do tego dysku współdzielonego i do znajdujących się na nim elementów mają tylko użytkownicy w domenie, do której 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 jego użytkowników.
restrictions.adminManagedRestrictions

boolean

Określa, czy do zmiany ograniczeń wymagane są uprawnienia administratora na tym dysku współdzielonym.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Jeśli ma wartość prawda, tylko użytkownicy z rolą organizatora mogą udostępniać foldery. Jeśli ma wartość false, użytkownicy z rolą organizatora lub rolę 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 drives.list, gdy parametr useDomainAdminAccess ma wartość true.

Metody

delete

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

get

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

hide

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

insert

 Tworzy nowy dysk współdzielony.

list

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

unhide

 Przywraca widok domyślny dysku współdzielonego.

update

 Aktualizuje metadane dysku współdzielonego.