- Richiesta HTTP
- Parametri percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
Recupera i metadati per i componenti aggiuntivi di Classroom nel contesto di un post specifico.
Per mantenere l'integrità del proprio modello di dati e autorizzazioni, un componente aggiuntivo deve chiamarlo per convalidare i parametri di query e il ruolo dell'utente richiedente ogni volta che il componente aggiuntivo viene aperto in un iframe.
Questo metodo restituisce i seguenti codici di errore:
PERMISSION_DENIED
per gli errori di accesso.INVALID_ARGUMENT
se la richiesta non è valida.NOT_FOUND
se una delle risorse identificate non esiste.
Richiesta HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnContext
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
courseId |
Obbligatorio. Identificatore del corso. |
itemId |
Identificatore di |
Parametri di query
Parametri | |
---|---|
addOnToken |
(Facoltativo) Token che autorizza la richiesta. Il token viene passato come parametro di query quando l'utente viene reindirizzato da Classroom all'URL del componente aggiuntivo. Il token di autorizzazione è necessario quando nessuna delle seguenti condizioni è vera:
|
attachmentId |
(Facoltativo) L'identificatore dell'allegato. Questo campo è obbligatorio per tutte le richieste, tranne quando l'utente si trova nell'iframe di rilevamento degli allegati. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene un'istanza di AddOnContext
.
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/classroom.addons.student
https://www.googleapis.com/auth/classroom.addons.teacher
Per ulteriori informazioni, consulta la Guida all'autorizzazione.