Method: courses.courseWorkMaterials.getAddOnContext

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}/courseWorkMaterials/{itemId}/addOnContext

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
courseId

string

Obbligatorio. Identificatore del corso.
itemId

string

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.

Parametri di ricerca

Parametri
addOnToken

string

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:

  • Il componente aggiuntivo ha allegati al post.
  • Il progetto dello sviluppatore che invia la richiesta è lo stesso progetto che ha creato il post.

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.