Informacje o użytkownikach Dysku możesz zebrać na 2 sposoby:
Korzystając z zasobu
about
, możesz uzyskać informacje o użytkowniku, jego ustawieniach Dysku i możliwościach systemowych.Korzystając z zasobu
apps
, możesz pobrać listę aplikacji zainstalowanych przez użytkownika wraz z informacjami o obsługiwanych typach MIME, rozszerzeniach plików i innych danych.
Z tego przewodnika dowiesz się, jak odzyskać informacje o użytkownikach zapisane na Dysku.
Pobieranie informacji o użytkowniku
Aby zwrócić informacje o użytkowniku Dysku jako instancję about
, użyj metody about.get
. Metoda about.get
wymaga parametru zapytania fields
w wywołaniu metody. Zwrócone wartości są mierzone w bajtach. Więcej informacji znajdziesz w sekcji Zwracanie określonych pól w pliku.
Pokaż przykład
Poniższy przykładowy kod pokazuje, jak podać w żądaniu wiele elementów fields
jako parametr zapytania. Odpowiedź zwraca wartości pól żądania.
Wyślij prośbę
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
Odpowiedź
{ "kind": "drive#about", "user": { "kind": "drive#user", "displayName": "DISPLAY_NAME", "photoLink": "PHOTO_LINK", "me": true, "permissionId": "PERMISSION_ID", "emailAddress": "EMAIL_ADDRESS" }, "storageQuota": { "usage": "10845031958", "usageInDrive": "2222008387", "usageInDriveTrash": "91566" } }
Odpowiedź zawiera te wartości:
DISPLAY_NAME
: nazwa użytkownika w postaci zwykłego tekstu.PHOTO_LINK
: adres URL zdjęcia profilowego użytkownika.PERMISSION_ID
: identyfikator użytkownika w zasobachPermission
.EMAIL_ADDRESS
: adres e-mail użytkownika
Pobieranie informacji o aplikacjach użytkownika
Aplikacje Dysku Google są dostępne w Google Workspace Marketplace. Są to na przykład Dokumenty Google lub dodatek do podpisywania dokumentów, który zwiększa wygodę korzystania z Dysku. Więcej informacji znajdziesz w artykule Korzystanie z aplikacji Dysku Google.
Aby zwrócić listę wszystkich aplikacji zainstalowanych przez użytkownika jako wystąpienie apps
, użyj metody apps.list
bez parametrów.
Pokaż przykład
Poniższy przykładowy kod pokazuje, jak zwrócić w żądaniu listę wszystkich aplikacji zainstalowanych przez użytkownika. Odpowiedź zwraca wartości pól żądania.
Wyślij prośbę
GET https://www.googleapis.com/drive/v3/apps
Odpowiedź
{ "kind": "drive#appList", "selfLink": "https://www.googleapis.com/drive/v3/apps", "items": [ { "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" } ], "defaultAppIds": [ "ID" ] }
Odpowiedź zawiera te wartości:
ID
: identyfikator aplikacji.PRODUCT_ID
: identyfikator informacji o produkcie dla tej aplikacji.
Wyświetlanie listy aplikacji użytkowników z parametrami zapytania
Aby znaleźć konkretną aplikację, użyj co najmniej jednego z opcjonalnych parametrów zapytania:
appFilterExtensions
: filtruje wyniki wyszukiwania, korzystając z rozdzielonej przecinkami listy rozszerzeń plików. Odpowiedź zawiera aplikacje z zakresu zapytań dotyczących aplikacji, które mogą otworzyć wymienione rozszerzenia plików. Jeśli podana jest też wartośćappFilterMimeTypes
, zwracane są 2 utworzone listy aplikacji. Przykładowe rozszerzenia todocx
dla programu Microsoft Word ipptx
dla programu Microsoft PowerPoint. Więcej przykładów rozszerzeń plików znajdziesz w artykule Eksportowanie typów MIME dokumentów Google Workspace.Poniższy przykładowy kod pokazuje, jak jako parametr zapytania podać kilka rozszerzeń plików:
GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx
.appFilterMimeTypes
: filtruje wyniki wyszukiwania za pomocą listy typów MIME rozdzielonych przecinkami. Odpowiedź zawiera aplikacje z zakresu zapytań dotyczących aplikacji, które mogą otworzyć wymienione typy MIME. Jeśli podany jest też parametrappFilterExtensions
, zwracane są 2 utworzone listy aplikacji. Przykłady typów MIME toapplication/vnd.google-apps.form
w przypadku Formularzy Google iapplication/vnd.google-apps.site
w przypadku Witryn Google. Więcej przykładów typów MIME znajdziesz w artykule na temat obsługiwanych typów MIME w Google Workspace i Dysku Google.Poniższy przykładowy kod pokazuje, jak podać wiele typów MIME jako parametr zapytania:
GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site
.languageCode
: możesz filtrować wyniki wyszukiwania według kodu języka lub regionu, zgodnie z definicją w BCP 47, z niektórymi rozszerzeniami w formacie LDML Unicode. Przykłady kodów języków toen-us
dla języka angielskiego (Stany Zjednoczone) ifr-ca
dla francuskiego (Kanada).Poniższy przykładowy kod pokazuje, jak podać wiele kodów językowych jako parametr zapytania:
GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca
.
Pobierz aplikację użytkownika według identyfikatora
Aby pobrać szczegółowe informacje o aplikacji jako instancję apps
, użyj metody apps.get
z identyfikatorem aplikacji.
Pokaż przykład
Poniższy przykładowy kod pokazuje, jak podać appId
jako parametr zapytania w żądaniu. Odpowiedź zwraca wartości pól żądania.
Wyślij prośbę
GET https://www.googleapis.com/drive/v3/apps/APP_ID
Odpowiedź
{ "kind": "drive#app", "id": "ID", "name": "Google Sheets", "supportsCreate": true, "supportsImport": true, "supportsMultiOpen": false, "supportsOfflineCreate": true, "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap", "productId": "PRODUCT_ID" }
Odpowiedź zawiera te wartości:
ID
: identyfikator aplikacji.PRODUCT_ID
: identyfikator informacji o produkcie dla tej aplikacji.
Powiązane artykuły
Oto kilka kolejnych rozwiązań, które możesz wypróbować:
Aby utworzyć plik na Dysku, przeczytaj artykuł Tworzenie plików.
Aby przesłać dane podczas tworzenia lub aktualizowania pliku, przeczytaj artykuł Przesyłanie danych pliku.
Informacje o pobieraniu i eksportowaniu plików znajdziesz w artykule Pobieranie i eksportowanie plików.