Method: permissions.update

Aktualizuje uprawnienie za pomocą semantyki poprawki. Więcej informacji znajdziesz w artykule Udostępnianie plików, folderów i dysków.

Ostrzeżenie: jednoczesne operacje na uprawnieniach do tego samego pliku nie są obsługiwane. Zastosowana zostanie tylko ostatnia aktualizacja.

Żądanie HTTP

PATCH https://www.googleapis.com/drive/v3/files/{fileId}/permissions/{permissionId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Identyfikator pliku lub dysku współdzielonego.
permissionId

string

Identyfikator uprawnienia.

Parametry zapytania

Parametry
removeExpiration

boolean

Określa, czy usunąć datę ważnoś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 pisania. 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
(deprecated)

boolean

Wycofano: wszystkie żądania korzystają z reguł dostępu o szerokim zakresie.

Treść żądania

Treść żądania zawiera wystąpienie elementu Permission.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu 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.