- Richiesta HTTP
- Parametri del 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 autorizzazioni e dati, un componente aggiuntivo deve richiamare questa funzionalità 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 errori di accesso.INVALID_ARGUMENT
se il formato della richiesta non è corretto.NOT_FOUND
se una delle risorse identificate non esiste.
Richiesta HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/posts/{postId}/addOnContext
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
courseId |
Obbligatorio. Identificatore del corso. |
postId |
Campo facoltativo. Deprecato, utilizza itemId. |
Parametri di ricerca
Parametri | |
---|---|
itemId |
Identificativo dell'annuncio, del lavoro del corso o del materiale del corso a cui è allegato l'allegato. Questo campo è obbligatorio, ma non viene contrassegnato come tale durante la migrazione da postId. |
addOnToken |
Campo facoltativo. Token che autorizza la richiesta. Il token viene trasmesso come parametro di ricerca quando l'utente viene reindirizzato da Classroom all'URL del componente aggiuntivo. Il token di autorizzazione è obbligatorio quando nessuna delle seguenti condizioni è vera:
|
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 alle autorizzazioni.