Method: permissions.insert

Wstawia uprawnienia do pliku lub dysku współdzielonego.

Ostrzeżenie: równoczesne operacje na uprawnieniach do tego samego pliku nie są obsługiwane. Stosowana jest 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 postaci zwykłego tekstu, która będzie dołączana do e-maili z powiadomieniami.

enforceSingleParent
(deprecated)

boolean

Wycofane: szczegółowe informacje znajdziesz na stronie moveToNewOwnersRoot.

moveToNewOwnersRoot

boolean

Ten parametr działa tylko w sytuacji, gdy elementu nie ma na dysku współdzielonym, a żądanie próbuje przenieść prawo własności do tego elementu. Jeśli ma wartość true, element zostanie przeniesiony do folderu głównego Mój dysk nowego właściciela, a wszystkie elementy nadrzędne zostaną usunięte. Jeśli zasada ma wartość false, elementy nadrzędne nie są zmieniane.

sendNotificationEmails

boolean

Określa, czy e-maile z powiadomieniami mają być wysyłane przy udostępnianiu treści użytkownikom lub grupom. Jeśli role ma wartość owner, ten parametr jest ignorowany. Otrzymasz też e-maila.

supportsAllDrives

boolean

Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone.

supportsTeamDrives
(deprecated)

boolean

Wycofane: zamiast tego użyj elementu supportsAllDrives.

useDomainAdminAccess

boolean

Wyślij żądanie jako administrator domeny. Jeśli zasada ma wartość Prawda, osoba wysyłająca prośbę otrzymuje dostęp, jeśli parametr identyfikatora pliku odnosi się do dysku współdzielonego, a zgłaszający 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ę 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ą objęte ograniczeniami, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.