- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
Pobiera metadane dodatków do Classroom w kontekście konkretnego posta.
Aby zachować integralność modelu danych i uprawnień, dodatek powinien wywoływać to działanie w celu sprawdzania 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 |
Wymagane. Identyfikator zajęć. |
itemId |
Identyfikator ogłoszenia, „courseWork” lub „courseWorkMaterial”, do których załączony jest załącznik. To pole jest wymagane, ale nie jest odpowiednio oznaczone podczas migracji z postId. |
Parametry zapytania
Parametry | |
---|---|
addOnToken |
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:
|
attachmentId |
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.