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.
Opcjonalnie: Wycofane. Zamiast tego używaj elementu itemId.
Parametry zapytania
Parametry
itemId
string
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.
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."],[[["This method is deprecated and you should use `course.announcements`, `course.courseWork`, or `course.courseWorkMaterials` methods instead."],["It retrieves metadata for Classroom add-ons within a specific post's context, requiring validation via this method when add-ons are opened in iframes."],["You will need courseId and itemId as required path and query parameters respectively, along with optional parameters like addOnToken and attachmentId based on the specific context."],["Authorizing this request necessitates using OAuth scopes like `https://www.googleapis.com/auth/classroom.addons.student` or `https://www.googleapis.com/auth/classroom.addons.teacher`."]]],[]]