Gestire le approvazioni

Questo documento spiega come gestire le approvazioni nell'API Google Drive.

Puoi trovare le approvazioni dei contenuti su Google Drive. L'API Google Drive fornisce la approvals risorsa per consentirti di ottenere ed elencare lo stato delle tue approvazioni. I metodi della risorsa approvals funzionano sugli elementi di Drive, Documenti Google e altri editor di Google Workspace.

Puoi utilizzare questo processo per individuare le approvazioni in situazioni di revisione formale, ad esempio una revisione di un contratto o di un documento ufficiale prima della pubblicazione. Un'approvazione tiene traccia dello stato della revisione (ad esempio In corso, Approvato o Rifiutato) e dei revisori coinvolti. Le approvazioni sono un ottimo modo per convalidare i contenuti e tenere traccia dei revisori.

Per visualizzare le approvazioni di un file, devi disporre dell'autorizzazione per leggere i metadati del file. Per ulteriori informazioni, vedi Ruoli e autorizzazioni.

Utilizzare il parametro fields

Se vuoi specificare i campi da restituire nella risposta, puoi impostare il fields parametro di sistema con qualsiasi metodo della ris3/} risorsa.approvals Se ometti il parametro fields, il server restituisce un insieme predefinito di campi specifici per il metodo. Per restituire campi diversi, vedi Restituire campi specifici.

Ottenere un'approvazione

Per ottenere un'approvazione per un file, utilizza il get metodo sulla risorsa approvals con i parametri del percorso fileId e approvalId. Se non conosci l'ID di approvazione, puoi elencare le approvazioni utilizzando il metodo list.

Il corpo della risposta contiene un'istanza della approvals risorsa.

Elencare le approvazioni

Per elencare le approvazioni di un file, chiama il list metodo sulla approvals risorsa e includi il fileId parametro del percorso.

Il corpo della risposta è costituito da un elenco di approvazioni per il file. Il campo items include informazioni su ogni approvazione sotto forma di risorsa approvals.

La risorsa approvals include anche un Status oggetto che descrive in dettaglio lo stato dell'approvazione, nonché l' ReviewerResponse oggetto che descrive in dettaglio la risposta a un'approvazione effettuata da un revisore specifico. La risposta di questo revisore è rappresentata dall'oggetto Response.

Puoi anche passare i seguenti parametri di query per personalizzare la paginazione o filtrare le approvazioni:

  • pageSize: il numero massimo di approvazioni da restituire per pagina. Se non imposti pageSize, il server restituisce fino a 100 approvazioni.

  • pageToken: un token di pagina, ricevuto da una precedente chiamata dell'elenco. Questo token viene utilizzato per recuperare la pagina successiva. Deve essere impostato sul valore di nextPageToken di una risposta precedente.