REST Resource: drives

Zasób: Dysk

Wizualizacja 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
  },
  "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 tego dysku.
name

string

Nazwa tego dysku współdzielonego.
colorRgb

string

Kolor tego dysku współdzielonego jako szesnastkowy kod koloru RGB. Może być ustawiony tylko w prośbie drive.drives.update, która nie ma ustawionego parametru 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. Możliwości, które ma bieżący użytkownik na tym dysku współdzielonym.
capabilities.canAddChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może dodawać podfoldery do folderów na 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 udać, jeśli na dysku znajdują się elementy, które nie zostały przeniesione do 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świetlić podfoldery 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 rolę.
capabilities.canReadRevisions

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może odczytywać zasób rewizji 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 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 zmienić 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 copyRequiresWriterPermission na dysku współdzielonym.
capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

boolean

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

boolean

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

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może przywrócić domyślne ograniczenia dysku współdzielonego.
capabilities.canDeleteChildren

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może usuwać podrzędne foldery na tym dysku współdzielonym.
capabilities.canTrashChildren

boolean

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

string

Identyfikator motywu, z którego zostaną ustawione obraz i kolor tła. Zbiór możliwych wartości driveThemes można pobrać z odpowiedzi drive.about.get. Jeśli nie zostanie określony w prośbie drive.drives.create, zostanie wybrany losowy motyw, z którego zostaną ustawione obraz i kolor tła. To pole służy tylko do zapisu. Można je ustawić tylko w przypadku żądań, w których nie ustawiono wartości colorRgb ani backgroundImageFile.
backgroundImageFile

object

Plik obrazu i parametry przycinania, na podstawie których ustawiany jest obraz tła na tym dysku współdzielonym. To pole służy tylko do zapisu. Można je ustawić tylko w przypadku żądań drive.drives.update, które nie mają ustawionego pola themeId. Jeśli jest to określone, wszystkie pola w backgroundImageFile muszą być ustawione.
backgroundImageFile.id

string

Identyfikator pliku obrazu na Dysku Google, który ma być użyty jako obraz tła.
backgroundImageFile.xCoordinate

number

Pozioma współrzędna lewego górnego rogu obszaru przycięcia na obrazie tła. Jest to wartość z zamkniętego zakresu od 0 do 1. Ta wartość to odległość pozioma od lewej strony całego obrazu do lewej strony obszaru przycinania podzielona przez szerokość całego obrazu.
backgroundImageFile.yCoordinate

number

Pionowa współrzędna lewego górnego rogu obszaru przycięcia na obrazie tła. Jest to wartość z zamkniętego zakresu od 0 do 1. Ta wartość 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ść to szerokość przyciętego obrazu podzielona przez szerokość całego obrazu. Wysokość jest obliczana na podstawie współczynnika proporcji szerokości do wysokości wynoszącego 80 do 9. Wygenerowany obraz musi mieć co najmniej 1280 pikseli szerokości i 144 piksele wysokości.
createdTime

string

Tylko dane wyjściowe. Czas utworzenia dysku współdzielonego (format daty i godziny RFC 3339).
hidden

boolean

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

object

Zestaw ograniczeń, które dotyczą tego dysku współdzielonego lub elementów na tym dysku. 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 opcji drives.update, aby dodać ograniczenia.
restrictions.copyRequiresWriterPermission

boolean

Określ, czy opcje kopiowania, drukowania i pobierania plików na tym dysku współdzielonym powinny być wyłączone dla czytelników i komentujących. Gdy to ograniczenie zostanie ustawione na true, zastąpi ono pole o podobnej nazwie true w przypadku każdego pliku na tym dysku współdzielonym.
restrictions.domainUsersOnly

boolean

Czy dostęp do tego dysku współdzielonego i elementów na nim jest ograniczony do użytkowników domeny, 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

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ń na tym dysku współdzielonym są wymagane uprawnienia administracyjne.
restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Jeśli to pole ma wartość Prawda, tylko użytkownicy z rolą organizatora mogą udostępniać foldery. Jeśli wartość to false, foldery mogą udostępniać użytkownicy z rolą organizatora lub rolą organizatora pliku.
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

create

 Tworzy dysk współdzielony.

delete

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

get

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

hide

 Ukrywa dysk współdzielony z widoku domyślnego.

list

Wyświetla dyski współdzielone użytkownika.

unhide

 Przywraca dysk współdzielony do widoku domyślnego.

update

 Zaktualizuje metadane dysku współdzielonego.