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

niestandardowy tekst w postaci zwykłego tekstu, 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 zamian supportsAllDrives.
useDomainAdminAccess

boolean

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

boolean

Określa, czy prośba ma stosować rozszerzone reguły dostępu.

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 po autoryzacji.