Method: courses.posts.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}/posts/{postId}/addOnContext

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

To pole jest wymagane. Identyfikator zajęć.
postId
(deprecated)

string

Opcjonalnie. Wycofano. Użyj identyfikatora elementu.

Parametry zapytania

Parametry
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.
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.