Method: permissions.insert

Wstawia uprawnienia do pliku lub dysku współdzielonego.

Ostrzeżenie: równoczesne operacje dotyczące uprawnień w tym samym pliku nie są obsługiwane. Zastosowana zostaje tylko ostatnia aktualizacja.

Żądanie HTTP

POST https://www.googleapis.com/drive/v2/files/{fileId}/permissions

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku lub dysku współdzielonego.

Parametry zapytania

Parametry
emailMessage

string

Tekst niestandardowy, który ma być dołączany do e-maili z powiadomieniami.
enforceSingleParent
(deprecated)

boolean

Wycofane: więcej informacji znajdziesz na stronie moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Ten parametr zadziała tylko wtedy, gdy element nie znajduje się na dysku współdzielonym, a prośba dotyczy przeniesienia własności tego elementu. Jeśli ustawisz wartość true, element zostanie przeniesiony do folderu głównego Mojego dysku nowego właściciela, a wszystkie poprzednie foldery nadrzędne zostaną usunięte. Jeśli ustawisz wartość false, elementy nadrzędne nie zostaną zmienione.
sendNotificationEmails

boolean

Określ, czy chcesz wysyłać e-maile z powiadomieniami, gdy udostępniasz pliki użytkownikom lub grupom. Ten parametr jest ignorowany, a e-mail jest wysyłany, jeśli wartość parametru role to owner.
supportsAllDrives

boolean

Czy aplikacja przesyłająca żądanie obsługuje zarówno Mój Dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofane: użyj w zastępstwie tego supportsAllDrives.
useDomainAdminAccess

boolean

Przesyłanie prośby przez administratora domeny. Jeśli ta opcja jest ustawiona na wartość true, proszący otrzyma dostęp, jeśli parametr identyfikatora pliku odnosi się do dysku współdzielonego, a proszący jest administratorem domeny, do której należy ten dysk współdzielony.

Treść żądania

Treść żądania zawiera wystąpienie elementu Permission.

Treść odpowiedzi

Jeśli operacja się powiedzie, treść odpowiedzi będzie zawierała nowo utworzoną instancję Permission.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.