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.
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
postId (deprecated)
string
Opcjonalnie: Wycofano. Zamiast niego użyj zasady itemId.
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.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2024-09-05 UTC."],[[["Retrieves metadata for Classroom add-ons within a specific post, validating user roles and query parameters."],["Requires `courseId`, `itemId` as path parameters, with optional `postId`, `addOnToken`, and `attachmentId` as query parameters."],["Returns an `AddOnContext` object upon successful execution, with potential errors including `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND`."],["Needs authorization with either `https://www.googleapis.com/auth/classroom.addons.student` or `https://www.googleapis.com/auth/classroom.addons.teacher` scope."],["Add-ons should utilize this method for validation when opened in an iframe to maintain data and permission integrity."]]],[]]