Method: files.accessproposals.list

Elenca le AccessProposte in un file. Nota: solo gli approvatori possono elencare AccessProposals in un file. Se l'utente non è un approvatore, restituisce un errore 403.

Richiesta HTTP

GET https://www.googleapis.com/drive/v3/files/{fileId}/accessproposals

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
fileId

string

Obbligatorio. L'ID dell'articolo per cui viene effettuata la richiesta.

Parametri di query

Parametri
pageToken

string

(Facoltativo) Il token di continuazione nell'elenco delle richieste di accesso.

pageSize

integer

(Facoltativo) Il numero di risultati per pagina

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

La risposta a una richiesta di elenco di proposte di accesso.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Campi
accessProposals[]

object (AccessProposal)

L'elenco delle proposte di accesso. Questo campo viene compilato solo nelle versioni v3 e v3beta.

nextPageToken

string

Il token di continuazione per la pagina di risultati successiva. Non sarà presente se è stata raggiunta la fine dell'elenco dei risultati. Se per qualsiasi motivo il token viene rifiutato, deve essere eliminato e l'impaginazione deve essere riavviata dalla prima pagina dei risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Alcuni ambiti sono limitati e richiedono una valutazione della sicurezza per consentire alla tua app di utilizzarli. Per ulteriori informazioni, consulta la Guida all'autorizzazione.

AccessProposal

La risorsa Access Proposal per le proposte di accesso in sospeso per un file

Rappresentazione JSON
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
Campi
fileId

string

L'ID file su cui si trova la proposta di accesso

proposalId

string

L'ID della proposta di accesso

requesterEmailAddress

string

L'indirizzo email dell'utente che ha effettuato la richiesta

recipientEmailAddress

string

L'indirizzo email dell'utente che riceverà le autorizzazioni se accettate

rolesAndViews[]

object (RoleAndView)

Un wrapper per il ruolo e la visualizzazione di una proposta di accesso.

requestMessage

string

Il messaggio che il richiedente ha aggiunto alla proposta

createTime

string (Timestamp format)

L'ora di creazione

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

RoleAndView

Un wrapper per il ruolo e la visualizzazione di una proposta di accesso.

Rappresentazione JSON
{
  "role": string,
  "view": string
}
Campi
role

string

Il ruolo proposto dal richiedente. In futuro potrebbero essere aggiunti nuovi valori, ma al momento sono possibili i seguenti: * writer * commenter * reader

view

string

Indica la visualizzazione di questa proposta di accesso. Compilato solo per le proposte che appartengono a una vista. published è l'unico valore supportato.