Method: permissions.create

Tworzy uprawnienia do pliku lub dysku współdzielonego. Więcej informacji znajdziesz w artykule Udostępnianie plików, folderów i dysków.

Ostrzeżenie: równoczesne operacje na uprawnieniach 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 zostanie dołączona do e-maila z powiadomieniem.
enforceSingleParent
(deprecated)

boolean

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

boolean

Ten parametr działa 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 katalogu 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 domyślnie jest to true, a w przypadku innych żądań jest to niedozwolone. 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

Wycofano: 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. Więcej informacji znajdziesz w artykule Przenoszenie własności plików.
useDomainAdminAccess

boolean

Wyślij żądanie jako administrator domeny.

Jeśli to ustawienie ma wartość true i są spełnione te dodatkowe warunki, osoba wysyłająca prośbę uzyskuje dostęp:

  1. Parametr identyfikatora pliku odnosi się do dysku współdzielonego.
  2. Osoba wysyłająca prośbę jest administratorem domeny, do której należy dysk współdzielony.

Więcej informacji znajdziesz w artykule Zarządzanie dyskami współdzielonymi jako administrator domeny.
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.