Method: courses.courseWorkMaterials.getAddOnContext

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

Aby zachować integralność modelu danych i uprawnień, dodatek powinien je wywoływać w celu weryfikacji parametrów zapytania i roli użytkownika, który wysłał żądanie, przy każdym otwarciu dodatku w elemencie iframe.

Ta metoda zwraca te 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 zidentyfikowanych 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

Wymagane. Identyfikator zajęć.
itemId

string

Identyfikator załącznika Announcement, CourseWork lub CourseWorkMaterial, do którego jest dołączony załącznik. To pole jest wymagane, ale nie jest odpowiednio oznaczone podczas migracji z postId.

Parametry zapytania

Parametry
addOnToken

string

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

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

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

  • Dodatek ma załączniki w poście.
  • Projekt dewelopera, który przesłał prośbę, to ten sam projekt, z którego utworzono posta.
attachmentId

string

Opcjonalnie: Identyfikator załącznika. To pole jest wymagane w przypadku wszystkich żądań poza sytuacjami, w których użytkownik znajduje się w elemencie iframe wykrywania załączników.

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 protokołu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.