Method: files.accessproposals.list

Répertoriez les AccessProposals d'un fichier. Remarque: Seuls les approbateurs peuvent répertorier les propositions d'accès dans un fichier. Si l'utilisateur n'est pas un approbateur, renvoie une erreur 403.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

Obligatoire. ID de l'élément concerné par la requête.

Paramètres de requête

Paramètres
pageToken

string

Facultatif. Jeton de continuité dans la liste des demandes d'accès.
pageSize

integer

Facultatif. Nombre de résultats par page

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

La réponse à une demande de liste de propositions d'accès.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Champs
accessProposals[]

object (AccessProposal)

Liste des propositions d'accès. Ce champ n'est renseigné que dans les versions v3 et v3beta.
nextPageToken

string

Jeton de continuité pour la page de résultats suivante. Ce champ est absent si la fin de la liste des résultats est atteinte. Si le jeton est refusé pour une raison quelconque, il doit être supprimé et la pagination doit être redémarrée à partir de la première page de résultats.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Certains champs d'application sont restreints et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le Guide relatif aux autorisations.

AccessProposal

Ressource "Access Proposal" (Proposition d'accès) pour les propositions d'accès en attente sur un fichier

Représentation JSON 
{
  "fileId": string,
  "proposalId": string,
  "requesterEmailAddress": string,
  "recipientEmailAddress": string,
  "rolesAndViews": [
    {
      object (RoleAndView)
    }
  ],
  "requestMessage": string,
  "createTime": string
}
Champs
fileId

string

ID du fichier pour lequel la proposition d'accès est effectuée
proposalId

string

ID de la proposition d'accès
requesterEmailAddress

string

Adresse e-mail de l'utilisateur à l'origine de la demande
recipientEmailAddress

string

Adresse e-mail de l'utilisateur qui recevra les autorisations si elles sont acceptées
rolesAndViews[]

object (RoleAndView)

Wrapper pour le rôle et la vue d'une proposition d'accès.
requestMessage

string

Message ajouté par le demandeur à la proposition
createTime

string (Timestamp format)

Heure de création

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".

RoleAndView

Wrapper du rôle et de la vue d'une proposition d'accès.

Représentation JSON 
{
  "role": string,
  "view": string
}
Champs
role

string

Rôle proposé par la personne à l'origine de la demande De nouvelles valeurs pourront être ajoutées à l'avenir, mais les suivantes sont actuellement possibles : * writer * commenter * reader
view

string

Indique la vue pour cette proposition d'accès. Renseigné uniquement pour les propositions appartenant à une vue. published est la seule valeur acceptée.