Method: userProfiles.guardians.delete

Usuwa opiekuna.

opiekun nie będzie już otrzymywać powiadomień i nie będzie dostępny za pomocą interfejsu API;

Ta metoda zwraca te kody błędów:

  • PERMISSION_DENIED jeśli użytkownik nie widzi żadnego użytkownika pasującego do podanego identyfikatora studentId, jeśli użytkownik nie ma uprawnień do zarządzania opiekunami ucznia określonego przez studentId, jeśli opiekunowie nie są włączeni w danej domenie lub z innych błędów dostępu.
  • INVALID_ARGUMENT, jeśli podano parametr studentId, ale nie można rozpoznać jego formatu (nie jest to adres e-mail ani parametr studentId z interfejsu API).
  • NOT_FOUND, jeśli użytkownik, który wysłał żądanie, może modyfikować opiekunów w wybranym studentId, ale nie ma rekordu Guardian dla tego ucznia z podanym 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 ma zostać usunięty. Jedna z tych wartości:

  • identyfikator liczbowy użytkownika;
  • adres e-mail użytkownika.
  • ciąg znaków "me" wskazujący użytkownika, który wysłał żądanie;
guardianId

string

Pole id w elementach Guardian.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi jest pusta.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.