Permissions

Listę metod dostępnych dla tego zasobu znajdziesz na końcu tej strony.

Reprezentacje zasobów

Uprawnienia do pliku. Uprawnienie przyznaje użytkownikowi, grupie, domenie lub światu dostęp do pliku lub hierarchii folderów.

{
  "kind": "drive#permission",
  "id": string,
  "type": string,
  "emailAddress": string,
  "domain": string,
  "role": string,
  "view": string,
  "allowFileDiscovery": boolean,
  "displayName": string,
  "photoLink": string,
  "expirationTime": datetime,
  "teamDrivePermissionDetails": [
    {
      "teamDrivePermissionType": string,
      "role": string,
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "permissionDetails": [
    {
      "permissionType": string,
      "role": string,
      "inheritedFrom": string,
      "inherited": boolean
    }
  ],
  "deleted": boolean,
  "pendingOwner": boolean
}
Nazwa usługi Wartość Opis Uwagi
kind string Określa rodzaj zasobu. Wartość: stały ciąg znaków "drive#permission".
id string Identyfikator tego uprawnienia. Jest to unikalny identyfikator podmiotu, który został opublikowany w zasobach użytkownika jako permissionId. Identyfikatory należy traktować jako wartości nieprzejrzyste.
type string Typ obdarowanego. Prawidłowe wartości to:
  • user
  • group
  • domain
  • anyone
Jeśli uprawnienie to type to user lub group, podczas tworzenia uprawnienia musisz dodać emailAddress dla użytkownika lub grupy. Jeśli type to domain, musisz podać domain. W przypadku typu anyone nie są potrzebne żadne dodatkowe informacje.		 zapisywalny
emailAddress string Adres e-mail użytkownika lub grupy, do których odnosi się to uprawnienie. zapisywalny
domain string Domena, do której odnosi się to uprawnienie. Obecnie dozwolone są następujące opcje:
  • Cała domena, na przykład „twoja-firma.com”.
  • Grupa odbiorców, np. „ID.audience.googledomains.com”.
 zapisywalny
role string Rola przyznana przez to uprawnienie. W przyszłości nowe wartości mogą być obsługiwane, jednak obecnie dozwolone są następujące opcje:
  • owner
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
 zapisywalny
allowFileDiscovery boolean Określa, czy uprawnienie umożliwia znajdowanie pliku przez wyszukiwanie. Dotyczy to tylko uprawnień typu domain lub anyone. zapisywalny
displayName string Nazwa „ładna” wartości uprawnienia. Poniżej znajduje się lista przykładów uprawnień każdego typu:
  • user – pełne imię i nazwisko użytkownika zgodnie z definicją na jego koncie Google, np. „Jan Kowalski”.
  • group – nazwa grupy dyskusyjnej Google, na przykład „Administratorzy firmy”.
  • domain – nazwa domeny ciągu znaków, np. „twoja-firma.com”;
  • anyone – brak wartości displayName.
expirationTime datetime Godzina wygaśnięcia tego uprawnienia (data i godzina RFC 3339). Okresy ważności mają następujące ograniczenia:
  • Nie można ich ustawiać na elementach na dysku współdzielonym.
  • Można je skonfigurować tylko dla uprawnień użytkowników i grup.
  • Godzina musi przypadać w przyszłości.
  • Czas nie może być oddalony o więcej niż rok.
 zapisywalny
teamDrivePermissionDetails[] list Wycofany – użyj permissionDetails.
teamDrivePermissionDetails[].teamDrivePermissionType string Wycofany – użyj permissionDetails/permissionType.
teamDrivePermissionDetails[].role string Wycofany – użyj permissionDetails/role.
teamDrivePermissionDetails[].inheritedFrom string Wycofany – użyj permissionDetails/inheritedFrom.
teamDrivePermissionDetails[].inherited boolean Wycofany – użyj permissionDetails/inherited.
deleted boolean Określa, czy konto powiązane z tym uprawnieniem zostało usunięte. To pole dotyczy tylko uprawnień użytkowników i grup.
permissionDetails[] list Szczegóły tego, czy uprawnienia do tego elementu na dysku współdzielonym są dziedziczone, czy też bezpośrednio. To pole zawiera tylko dane wyjściowe dostępne tylko dla elementów na dysku współdzielonym.
permissionDetails[].permissionType string Typ uprawnień dla tego użytkownika. W przyszłości możemy dodawać nowe wartości, jednak obecnie akceptujemy:
  • file
  • member
permissionDetails[].role string Główna rola tego użytkownika. W przyszłości mogą zostać dodane nowe wartości, jednak obecnie dozwolone są następujące elementy:
  • organizer
  • fileOrganizer
  • writer
  • commenter
  • reader
permissionDetails[].inheritedFrom string Identyfikator elementu, z którego to uprawnienie jest dziedziczone. To pole zawiera tylko dane wyjściowe.
permissionDetails[].inherited boolean Określa, czy to uprawnienie jest dziedziczone. To pole jest zawsze wypełniane. To pole zawiera tylko dane wyjściowe.
view string Określa widok danych tego uprawnienia. Wartość jest podawana tylko w przypadku uprawnień należących do widoku danych. Jedyna obsługiwana wartość to published. zapisywalny
pendingOwner boolean Określa, czy konto powiązane z tymi uprawnieniami jest oczekiwanym właścicielem. Wartość podawana tylko w przypadku uprawnień typu user w przypadku plików, których nie ma na dysku współdzielonym. zapisywalny

Metody

utwórz
tworzy uprawnienia do pliku lub dysku współdzielonego, Więcej informacji o tworzeniu uprawnień znajdziesz w artykule Udostępnianie plików, folderów i dysków.
usuń
Usuwa uprawnienie.
pobierz
Pobiera uprawnienia według identyfikatora.
list
Wyświetla listę uprawnień pliku lub dysku współdzielonego.
zaktualizuj
Aktualizuje uprawnienie za pomocą semantyki poprawki.