Method: permissions.insert

Wstawia uprawnienia do pliku lub dysku współdzielonego.

Ostrzeżenie: jednoczesne operacje dotyczące uprawnień do tego samego pliku nie są obsługiwane. Zastosowana zostanie 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

Niestandardowa wiadomość w formacie zwykłego tekstu, która będzie dołączana do e-maili z powiadomieniami.

enforceSingleParent
(deprecated)

boolean

Wycofane: więcej informacji znajdziesz w sekcji moveToNewOwnersRoot.

moveToNewOwnersRoot

boolean

Ten parametr będzie miał zastosowanie tylko wtedy, gdy element nie znajduje się na dysku współdzielonym, a żądanie dotyczy przeniesienia własności elementu. Jeśli ustawisz 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 false, rodzice nie zostaną zmienieni.

sendNotificationEmails

boolean

Określ, czy podczas udostępniania użytkownikom lub grupom mają być wysyłane e-maile z powiadomieniami. Ten parametr jest ignorowany i e-mail jest wysyłany, jeśli wartość parametru role to owner.

supportsAllDrives

boolean

Czy aplikacja wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone.

supportsTeamDrives
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady supportsAllDrives.

useDomainAdminAccess

boolean

Wystaw prośbę jako administrator domeny. Jeśli wartość to „true”, wnioskodawca otrzyma dostęp, jeśli parametr fileId odnosi się do dysku współdzielonego, a wnioskodawca jest administratorem domeny, do której należy dysk współdzielony.

enforceExpansiveAccess
(deprecated)

boolean

Wycofano: wszystkie żądania korzystają z reguł dostępu o szerokim zakresie.

Treść żądania

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

Treść odpowiedzi

Jeśli operacja się uda, 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 ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.