Method: courses.courseWorkMaterials.getAddOnContext

Pobiera metadane dotyczące dodatków do Classroom w kontekście konkretnego posta.

Aby zachować integralność swoich danych i modelu uprawnień, dodatek powinien wywoływać to działanie w celu sprawdzenia parametrów zapytania i roli użytkownika wysyłającego żądanie za każdym razem, gdy dodatek jest otwierany w elemencie iframe.

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

  • PERMISSION_DENIED w przypadku błędów dostępu.
  • INVALID_ARGUMENT, jeśli żądanie jest uszkodzone.
  • NOT_FOUND, jeśli jeden ze wskazanych zasobów nie istnieje.

Żądanie HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWorkMaterials/{itemId}/addOnContext

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

To pole jest wymagane. Identyfikator zajęć.
itemId

string

Identyfikator ogłoszenia, sessionWork lub sessionWorkMaterial, w którym załącznik jest dołączony. To pole jest wymagane, ale nie jest oznaczone jako takie podczas migracji z postId.

Parametry zapytania

Parametry
addOnToken

string

Opcjonalnie. Token, który autoryzuje żądanie.

Token jest przekazywany jako parametr zapytania, gdy użytkownik zostanie przekierowany z Classroom na adres URL dodatku.

Token autoryzacji jest wymagany, gdy nie jest spełniony żaden z tych warunków:

  • Dodatek ma załączniki do posta.
  • Projekt deweloperski, który wysyła żądanie, to ten sam projekt, który utworzył posta.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu AddOnContext.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/classroom.addons.student
  • https://www.googleapis.com/auth/classroom.addons.teacher

Więcej informacji znajdziesz w przewodniku po autoryzacji.