Method: permissions.create

Tworzy 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/v3/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łączony do e-maila z powiadomieniem.
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.
sendNotificationEmail

boolean

Określ, czy chcesz wysyłać e-maila z powiadomieniem, gdy udostępniasz plik użytkownikom lub grupom. Domyślnie jest to ustawione na „Prawda” w przypadku użytkowników i grup, a nie jest dozwolone w przypadku innych żądań. Nie może być wyłączona w przypadku przeniesienia własności.
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.
transferOwnership

boolean

Czy chcesz przenieść własność na wskazanego użytkownika i ograniczyć uprawnienia obecnego właściciela do poziomu autora. Ten parametr jest wymagany jako potwierdzenie wystąpienia działania niepożądanego.
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.

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/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.