REST Resource: drives

Zasób: Dysk

Reprezentacja dysku współdzielonego.

Niektóre metody zasobów (np. 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,
    "canChangeDownloadRestriction": 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,
    "downloadRestriction": {
      object (DownloadRestriction)
    }
  },
  "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 jako szesnastkowy ciąg znaków RGB. Można go ustawić tylko w przypadku żądania drive.drives.update, które nie ustawia 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. 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ć podfoldery 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 obecny użytkownik może usunąć ten dysk współdzielony. Próba usunięcia dysku współdzielonego może się nie powieść, jeśli zawiera on elementy, które nie zostały przeniesione do kosza.

capabilities.canDownload

boolean

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

capabilities.canEdit

boolean

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

capabilities.canListChildren

boolean

Tylko dane wyjściowe. Określa, czy obecny 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 obecny 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ć zasoby 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 obecny użytkownik może zmienić nazwę tego dysku współdzielonego.

capabilities.canChangeDriveBackground

boolean

Tylko dane wyjściowe. Określa, czy obecny 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 obecny użytkownik może zmienić copyRequiresWriterPermission ograniczenie tego dysku współdzielonego.

capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

capabilities.canChangeDriveMembersOnlyRestriction

boolean

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

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

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

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ć elementy podrzędne z folderów na tym dysku współdzielonym.

capabilities.canTrashChildren

boolean

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

capabilities.canChangeDownloadRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmieniać ograniczenia pobierania zastosowane przez organizatora na tym dysku współdzielonym.

themeId

string

Identyfikator motywu, z którego zostaną ustawione obraz tła i kolor. Zbiór możliwych driveThemes można pobrać z odpowiedzi drive.about.get. Jeśli nie zostanie określony w drive.drives.create żądaniu, zostanie wybrany losowy motyw, z którego zostaną ustawione obraz tła i kolor. Jest to pole 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 tego dysku współdzielonego. Jest to pole tylko do zapisu. Można je ustawić tylko w przypadku żądań drive.drives.update, które nie ustawiają themeId. Jeśli jest określony, należy ustawić wszystkie pola backgroundImageFile.

backgroundImageFile.id

string

Identyfikator pliku obrazu 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 na obrazie tła. Jest to wartość z zamkniętego zakresu od 0 do 1. Ta wartość 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 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:9. Wynikowy 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 (data i godzina w formacie RFC 3339).

hidden

boolean

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

restrictions

object

Zestaw ograniczeń, które obowiązują na tym dysku współdzielonym lub w przypadku elementów na tym dysku. Pamiętaj, że nie można ustawić ograniczeń podczas tworzenia dysku współdzielonego. Aby dodać ograniczenie, najpierw utwórz dysk współdzielony, a potem użyj ikony drives.update.

restrictions.copyRequiresWriterPermission

boolean

Czy opcje kopiowania, drukowania i pobierania plików na tym dysku współdzielonym powinny być wyłączone dla czytelników i komentujących. Jeśli to ograniczenie jest ustawione na true, zastąpi ono pole o podobnej nazwie i ustawi je na 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 elementów na nim zapisanych 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

Określa, czy dostęp do elementów na tym dysku współdzielonym jest ograniczony do jego użytkowników.

restrictions.adminManagedRestrictions

boolean

Czy do modyfikowania ograniczeń wymagane są uprawnienia administracyjne na tym dysku współdzielonym.

restrictions.sharingFoldersRequiresOrganizerPermission

boolean

Jeśli ta opcja jest włączona, tylko użytkownicy z rolą organizatora mogą udostępniać foldery. Jeśli wartość to „false”, użytkownicy z rolą organizatora lub organizatora plików mogą udostępniać foldery.

restrictions.downloadRestriction

object (DownloadRestriction)

Ograniczenia pobierania zastosowane przez menedżerów dysku współdzielonego.

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, do którego użytkownik ma dostęp jako organizer.

get

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

hide

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

list

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

unhide

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

update

Aktualizuje metadane dysku współdzielonego.