Method: userProfiles.guardians.delete

Usuwa opiekuna.

Opiekun nie będzie już otrzymywać powiadomień dla opiekuna, a nie będzie on już dostępny przez interfejs API.

Ta metoda zwraca następujące kody błędów:

  • PERMISSION_DENIED, jeśli żaden użytkownik pasujący do podanego studentId nie jest widoczny dla użytkownika wysyłającego prośbę, użytkownik wysyłający prośbę nie ma uprawnień do zarządzania opiekunami ucznia określonego przez studentId, gdy opiekunowie nie są włączony w danej domenie, lub występują inne błędy dostępu.
  • INVALID_ARGUMENT, jeśli określono studentId, ale nie można rozpoznać jego formatu (nie jest to adres e-mail ani studentId z interfejsu API).
  • NOT_FOUND, jeśli użytkownik wysyłający prośbę może modyfikować opiekunów wskazanego elementu studentId, ale w przypadku tego ucznia nie istnieje rekord Guardian z podanym identyfikatorem guardianId.

Żądanie HTTP

DELETE https://classroom.googleapis.com/v1/userProfiles/{studentId}/guardians/{guardianId}

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
studentId

string

Uczeń, którego opiekun zostanie usunięty. Jedna z tych wersji:

  • identyfikator numeryczny użytkownika
  • adres e-mail użytkownika.
  • literał ciągu znaków "me" wskazujący użytkownika wysyłającego żądanie
guardianId

string

Pole id z tabeli Guardian.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie pusta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/classroom.guardianlinks.students

Więcej informacji znajdziesz w przewodniku po autoryzacji.