Method: permissions.create

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

Niestandardowa wiadomość w formacie zwykłego tekstu, która ma zostać dołączona do e-maila z powiadomieniem.
enforceSingleParent
(deprecated)

boolean

Wycofane: więcej informacji znajdziesz w sekcji moveToNewOwnersRoot.
moveToNewOwnersRoot

boolean

Ten parametr będzie miał wpływ 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 wartość false, rodzice nie zostaną zmienieni.
sendNotificationEmail

boolean

Określ, czy podczas udostępniania użytkownikom lub grupom ma być wysyłany e-mail z powiadomieniem. W przypadku użytkowników i grup ta wartość domyślna to true. Nie jest ona dozwolona w przypadku innych żądań. Nie może być wyłączona w przypadku przeniesienia własności.
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.
transferOwnership

boolean

Określa, czy przenieść własność na podanego użytkownika i ograniczyć uprawnienia obecnego właściciela do poziomu osoby z uprawnieniami do edycji. Ten parametr jest wymagany jako potwierdzenie efektu ubocznego.
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

boolean

Określa, czy w przypadku żądania mają być egzekwowane reguły 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/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.