- Żądanie HTTP
- Parametry ścieżki
- Parametry zapytania
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- AccessProposal
- RoleAndView
- Wypróbuj
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 | |
---|---|
file |
Wymagane. Identyfikator elementu, którego dotyczy żądanie. |
Parametry zapytania
Parametry | |
---|---|
page |
Opcjonalnie: Token kontynuacji na liście żądań dostępu. |
page |
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 ( |
Pola | |
---|---|
access |
Lista propozycji dostępu. To pole jest wypełniane tylko w wersjach v3 i v3beta. |
next |
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 ( |
Pola | |
---|---|
file |
Identyfikator pliku powiązany z ofertą pakietową o dostępie |
proposal |
Identyfikator propozycji dostępu |
requester |
Adres e-mail użytkownika, który wysłał prośbę |
recipient |
Adres e-mail użytkownika, który otrzyma uprawnienia, jeśli zostanie zaakceptowany |
roles |
Kod roli i widoku oferty pakietowej dotyczącej dostępu. |
request |
wiadomość dodana przez osobę przesyłającą prośbę do propozycji; |
create |
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: |
RoleAndView
Kod roli i widoku oferty pakietowej dotyczącej dostępu.
Zapis JSON |
---|
{ "role": string, "view": string } |
Pola | |
---|---|
role |
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: * |
view |
Wskazuje widok danych dla tej propozycji dostępu. Wartość jest podawana tylko w przypadku propozycji należących do widoku. |