REST Resource: drives

Zasób: Dysk

Reprezentacja 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 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 ją ustawić tylko w żądaniu drive.drives.update, które nie ustawia 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 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 zawiera on elementy, które zostały 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ć 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 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 na tym dysku współdzielonym.

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 na tym dysku współdzielonym.

capabilities.canChangeDomainUsersOnlyRestriction

boolean

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

capabilities.canChangeDriveMembersOnlyRestriction

boolean

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

capabilities.canChangeSharingFoldersRequiresOrganizerPermissionRestriction

boolean

Tylko dane wyjściowe. Określa, czy bieżący użytkownik może zmienić ograniczenie 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, z którego zostanie ustawiony obraz i kolor tła. Zbiór możliwych do pobrania elementów driveThemes można pobrać z odpowiedzi drive.about.get. Jeśli nie określono tego w żądaniu drive.drives.create, używany jest losowy motyw, na podstawie którego ustawiany jest obraz i kolor tła. To pole jest przeznaczone tylko do zapisu. Można je ustawić tylko w żądaniach, które nie mają ustawionej wartości colorRgb ani backgroundImageFile.

backgroundImageFile

object

Plik graficzny i parametry przycinania, za pomocą których ustawiany jest 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 określono backgroundImageFile, wszystkie pola 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 na obrazie tła. Jest to wartość z zamkniętego zakresu od 0 do 1. Ta wartość określa odległość w poziomie od lewej strony całego obrazu do lewej krawędzi 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. 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ść określa szerokość przyciętego obrazu podzieloną przez szerokość całego obrazu. Wysokość jest obliczana przez zastosowanie współczynnika proporcji szerokości do wysokości wynoszącego 80:9. Powstały obraz musi mieć co najmniej 1280 pikseli szerokości i 144 pikseli wysokości.

createdTime

string

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

hidden

boolean

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

restrictions

object

Zestaw ograniczeń, które mają zastosowanie do tego dysku współdzielonego lub elementów na nim znajdujących się na tym dysku. Pamiętaj, że podczas tworzenia dysku współdzielonego nie możesz ustawić ograniczeń. Aby dodać ograniczenie, najpierw utwórz dysk współdzielony, a następnie użyj klawisza drives.update, aby dodać ograniczenia.

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 komentatorów. Jeśli to ograniczenie ma wartość true, zastąpi ono pole o podobnej nazwie 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 znajdujących się na nim elementów jest ograniczony do użytkowników w domenie, do której należy ten dysk. 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 (fałsz), użytkownicy z 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 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 uprawnienie 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.