REST Resource: accessproposals

Ressource: AccessProposal

Die AccessProposal-Ressource für ausstehende Zugriffsvorschläge für eine Datei

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

string

Die Datei-ID, in der sich der Vorschlag für den Zugriff befindet

proposalId

string

Die ID des Zugriffsvorschlags

requesterEmailAddress

string

Die E‑Mail-Adresse des anfragenden Nutzers

recipientEmailAddress

string

Die E-Mail-Adresse des Nutzers, der bei Annahme Berechtigungen erhält

rolesAndViews[]

object (RoleAndView)

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

requestMessage

string

Die Nachricht, die der Antragsteller dem Vorschlag hinzugefügt hat

createTime

string (Timestamp format)

Erstellungszeit

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

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. In Zukunft können neue Werte hinzugefügt werden, derzeit sind jedoch nur die folgenden möglich: * writer * commenter * reader

view

string

Gibt die Ansicht für diesen Zugriffsvorschlag an. Wird nur für Vorschläge ausgefüllt, die zu einer Ansicht gehören. published ist der einzige unterstützte Wert.

Methoden

get

Ruft ein AccessProposal anhand der ID ab.

list

AccessProposals für eine Datei auflisten

resolve

Wird verwendet, um einen Zugriffsvorschlag zu genehmigen oder abzulehnen.