Method: courses.posts.getAddOnContext

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.

Ta metoda zwraca te kody błędów:

  • PERMISSION_DENIED w przypadku błędów dostępu.
  • INVALID_ARGUMENT jeśli żądanie ma nieprawidłowy format.
  • NOT_FOUND jeśli jeden z identyfikowanych zasobów nie istnieje.

Żądanie HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnContext

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
courseId

string

Wymagane. Identyfikator kursu.
postId
(deprecated)

string

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.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.