- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- Wypróbuj
Tworzy 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/v3/files/{fileId}/permissions
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
fileId |
Identyfikator pliku lub dysku współdzielonego. |
Parametry zapytania
Parametry | |
---|---|
emailMessage |
Niestandardowa wiadomość w postaci zwykłego tekstu, która zostanie dołączona do e-maila z powiadomieniem. |
enforceSingleParent |
Wycofane: szczegółowe informacje znajdziesz na stronie |
moveToNewOwnersRoot |
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ść |
sendNotificationEmail |
Określa, czy e-mail z powiadomieniem ma być wysyłany podczas udostępniania plików użytkownikom lub grupom. Domyślnie ma wartość Prawda w przypadku użytkowników i grup, ale nie jest dozwolona w przypadku innych żądań. Nie można jej wyłączyć w przypadku przenoszenia własności. |
supportsAllDrives |
Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: zamiast tego użyj elementu |
transferOwnership |
Określa, czy przenieść własność na określonego użytkownika, a bieżącemu właścicielowi przyznać uprawnienia zapisującego. Ten parametr jest wymagany jako potwierdzenie efektu ubocznego. |
useDomainAdminAccess |
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/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.