Method: files.accessproposals.list

Wyświetlanie listy ofert dostępu w pliku. Uwaga: tylko zatwierdzający mogą wyświetlać propozycje dostępu w pliku. Jeśli użytkownik nie jest osobą zatwierdzającą, zwraca kod 403.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
fileId

string

Wymagane. Identyfikator elementu, którego dotyczy żądanie.

Parametry zapytania

Parametry
pageToken

string

Opcjonalnie: Token kontynuacji na liście żądań dostępu.

pageSize

integer

Opcjonalnie: Liczba wyników na stronę

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź na prośbę o listę propozycji dostępu.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON
{
  "accessProposals": [
    {
      object (AccessProposal)
    }
  ],
  "nextPageToken": string
}
Pola
accessProposals[]

object (AccessProposal)

Lista propozycji dostępu. To pole jest wypełniane tylko w wersjach v3 i v3beta.

nextPageToken

string

Token kontynuacji dla następnej strony wyników. Jeśli dotarłeś(-aś) do końca listy wyników, nie będzie to widoczne. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go unieważnić, a podział na strony powinien rozpocząć się od nowa na pierwszej stronie wyników.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu 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

Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby można było ich używać w aplikacji. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.

AccessProposal

Zasób propozycji dostępu w przypadku zaległych propozycji dostępu do pliku

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

string

Identyfikator pliku powiązany z ofertą pakietową o dostępie

proposalId

string

Identyfikator propozycji dostępu

requesterEmailAddress

string

Adres e-mail użytkownika, który wysłał prośbę

recipientEmailAddress

string

Adres e-mail użytkownika, który otrzyma uprawnienia, jeśli zostanie zaakceptowany

rolesAndViews[]

object (RoleAndView)

Kod roli i widoku oferty pakietowej dotyczącej dostępu.

requestMessage

string

wiadomość dodana przez osobę przesyłającą prośbę do propozycji;

createTime

string (Timestamp format)

Czas utworzenia

Sygnatura czasowa w formacie UTC „Zulu” zdefiniowanym w dokumencie RFC 3339, z dokładnością do nanosekund i maksymalnie 9 miejsc po przecinku. Przykłady: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

RoleAndView

Kod roli i widoku oferty pakietowej dotyczącej dostępu.

Zapis JSON
{
  "role": string,
  "view": string
}
Pola
role

string

Rola zaproponowana przez osobę przesyłającą prośbę. W przyszłości możemy dodać nowe wartości, ale obecnie dostępne są te: * writercommenterreader

view

string

Wskazuje widok danych dla tej propozycji dostępu. Wartość jest podawana tylko w przypadku propozycji należących do widoku. published to jedyna obsługiwana wartość.