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 risorsa approvals per consentirti di ottenere e 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 monitora lo stato sia della revisione (ad esempio In corso, Approvato o Rifiutato) sia 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 maggiori informazioni, consulta 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 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 metodo get sulla risorsa approvals con i parametri di percorso fileId e approvalId. Se non conosci l'ID approvazione, puoi elencare le approvazioni utilizzando il metodo list.

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

Elenco approvazioni

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

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

La risorsa approvals include anche un oggetto Status che descrive in dettaglio lo stato dell'approvazione, nonché l'oggetto ReviewerResponse 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.