Method: files.accessproposals.list

Listen Sie die AccessProposals in einer Datei auf. Hinweis: Nur Genehmiger können Zugriffsanträge für eine Datei auflisten. Wenn der Nutzer kein Genehmiger ist, wird 403 zurückgegeben.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
fileId

string

Erforderlich. Die ID des Artikels, auf den sich die Anfrage bezieht.

Abfrageparameter

Parameter
pageToken

string

Optional. Das Fortsetzungstoken auf der Liste der Zugriffsanfragen.
pageSize

integer

Optional. Die Anzahl der Ergebnisse pro Seite

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Die Antwort auf eine Anfrage für eine Liste der Angebote zugreifen.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Felder
accessProposals[]

object (AccessProposal)

Die Liste der Zugriffsanfragen. Dieses Feld wird nur in Version 3 und Version 3beta ausgefüllt.
nextPageToken

string

Das Fortsetzungstoken für die nächste Ergebnisseite. Dieser Wert wird nicht angezeigt, wenn das Ende der Ergebnisliste erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung von der ersten Ergebnisseite aus neu gestartet werden.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • 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

Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.

AccessProposal

Die Ressource „Zugriffsangebot“ für ausstehende Zugriffsvorschläge in einer Datei

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

string

Die Datei-ID, für die der Zugriff beantragt wird
proposalId

string

Die ID des Zugriffsvorschlags
requesterEmailAddress

string

E-Mail-Adresse des anfragenden Nutzers
recipientEmailAddress

string

Die E-Mail-Adresse des Nutzers, der Berechtigungen erhält, wenn er akzeptiert wird
rolesAndViews[]

object (RoleAndView)

Ein Wrapper für die Rolle und Ansicht eines Zugriffsvorschlags.
requestMessage

string

Die Nachricht, die der Antragsteller dem Antrag hinzugefügt hat
createTime

string (Timestamp format)

Erstellungszeit

Ein Zeitstempel im Format RFC3339 UTC "Zulu" mit einer Auflösung im Nanosekundenbereich und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".

RoleAndView

Ein Wrapper für die Rolle und Ansicht eines Zugriffsvorschlags.

JSON-Darstellung 
{
  "role": string,
  "view": string
}
Felder
role

string

Die vom Antragsteller vorgeschlagene Rolle. Neue Werte können in Zukunft hinzugefügt werden, derzeit sind jedoch nur die folgenden möglich: * writer * commenter * reader
view

string

Zeigt die Ansicht für dieses Zugriffsangebot an. Wird nur für Angebote ausgefüllt, die zu einer Ansicht gehören. published ist der einzige unterstützte Wert.