Pobiera metadane dodatków do Classroom w kontekście konkretnego posta.
Aby zachować integralność własnych danych i modelu uprawnień, dodatek powinien wywoływać tę metodę w celu sprawdzania parametrów zapytania i roli użytkownika przesyłającego żądanie, gdy dodatek jest otwarty w ramce.
Identyfikator Announcement, CourseWork lub CourseWorkMaterial, pod którym załącznik jest załączony. To pole jest wymagane, ale nie jest oznaczone jako takie podczas migracji z postId.
Parametry zapytania
Parametry
postId (deprecated)
string
Opcjonalnie: Wycofane. Zamiast tego używaj elementu itemId.
addOnToken
string
Opcjonalnie: Token autoryzujący żądanie.
Token jest przekazywany jako parametr zapytania, gdy użytkownik jest przekierowywany z Classroom do adresu URL dodatku.
Token autoryzacji jest wymagany, gdy nie jest spełniony żaden z tych warunków:
Dodatek zawiera załączniki w poście.
Projekt dewelopera, który wysyła żądanie, to ten sam projekt, który utworzył post.
attachmentId
string
Opcjonalnie: Identyfikator załącznika. To pole jest wymagane w przypadku wszystkich żądań, z wyjątkiem sytuacji, gdy użytkownik znajduje się w ramce iframe usługi Odkrywanie 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-12-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."]]],[]]