Method: drives.list

Wyświetla listę dysków współdzielonych użytkownika.

Ta metoda akceptuje parametr q, czyli zapytanie łączące co najmniej jedno wyszukiwane hasło. Więcej informacji znajdziesz w przewodniku Wyszukiwanie dysków współdzielonych.

Żądanie HTTP

GET https://www.googleapis.com/drive/v3/drives

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Maksymalna liczba dysków współdzielonych zwracanych na stronę.

pageToken

string

Token strony dla dysków współdzielonych.

q

string

Ciąg zapytania do wyszukania dysków współdzielonych.

useDomainAdminAccess

boolean

Wyślij prośbę jako administrator domeny. jeśli ma wartość true (prawda), zwracane są wszystkie dyski współdzielone w domenie, w której użytkownik wysyłający prośbę jest administratorem.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista dysków współdzielonych.

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

Zapis JSON
{
  "nextPageToken": string,
  "kind": string,
  "drives": [
    {
      object (Drive)
    }
  ]
}
Pola
nextPageToken

string

Token strony dla następnej strony dysków współdzielonych. Nie pojawi się, jeśli dotarliśmy do końca listy. 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. Token strony jest zwykle ważny przez kilka godzin. Jeśli jednak dodasz lub usuniesz nowe elementy, oczekiwane wyniki mogą się różnić.

kind

string

Określa rodzaj danego zasobu. Wartość: ustalony ciąg znaków "drive#driveList".

drives[]

object (Drive)

Lista dysków współdzielonych. Jeśli pole nextPageToken jest wypełnione, ta lista może być niekompletna i powinna zostać pobrana dodatkowa strona z wynikami.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly

Niektóre zakresy są ograniczone. Aby można było z nich korzystać, aplikacja musi przeprowadzić ocenę zabezpieczeń. Więcej informacji znajdziesz w przewodniku na temat autoryzacji.