Zwrot informacji użytkownika

Dysk Google oferuje 2 sposoby zbierania informacji o użytkownikach Dysku:

  • Za pomocą zasobu about możesz pobierać informacje o użytkowniku, jego ustawieniach Dysku i możliwościach systemu.

  • Za pomocą zasobu apps możesz pobierać listę zainstalowanych aplikacji użytkownika wraz z informacjami o obsługiwanych przez każdą aplikację typach MIME, rozszerzeniach plików i innymi szczegółami.

Z tego przewodnika dowiesz się, jak pobierać informacje o użytkownikach na Dysku.

Pobieranie szczegółowych informacji o użytkowniku

Aby zwrócić informacje o użytkowniku Dysku jako instancję about, użyj get metody. Zwracane wartości są mierzone w bajtach.

W metodzie get musisz ustawić fields parametr systemowy na the, aby określić pola, które mają zostać zwrócone w odpowiedzi. W większości metod Dysku ta czynność jest wymagana tylko w przypadku zwracania pól innych niż domyślne, ale w przypadku zasobu about jest obowiązkowa. Jeśli pominiesz ten parametr, metoda zwróci błąd. Więcej informacji znajdziesz w artykule Zwracanie określonych pól.

Poniższy przykładowy kod pokazuje, jak podać kilka pól fields jako parametr zapytania w żądaniu. Odpowiedź zwraca wartości pól dla żądania.

Żądanie

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 zasobach Permission.
  • EMAIL_ADDRESS: adres e-mail użytkownika.

Wyświetlanie listy aplikacji użytkownika

Aplikacje Dysku Google są wymienione w Google Workspace Marketplace i służą do zwiększania wygody korzystania z Dysku, np. aplikacja Dokumenty Google lub dodatek używany w Dokumentach do podpisywania dokumentów. Więcej informacji znajdziesz w artykule Korzystanie z aplikacji Dysku Google.

Aby zwrócić listę wszystkich zainstalowanych aplikacji użytkownika jako instancję apps, użyj metody list bez żadnych parametrów.

Jeśli chcesz określić pola, które mają zostać zwrócone w odpowiedzi, możesz ustawić fields parametr systemowy. Jeśli nie określisz parametru fields, serwer zwróci domyślny zestaw pól. Więcej informacji znajdziesz w artykule Zwracanie określonych pól.

Poniższy przykładowy kod pokazuje, jak zwrócić listę wszystkich zainstalowanych aplikacji użytkownika w żądaniu. Odpowiedź zwraca wartości pól dla żądania.

Żądanie

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żytkownika z parametrami zapytania

Aby znaleźć konkretną aplikację, użyj co najmniej jednego opcjonalnego parametru zapytania:

  • appFilterExtensions: filtruj wyniki wyszukiwania za pomocą rozdzielonej przecinkami listy rozszerzeń plików. W odpowiedzi uwzględniane są aplikacje w zakresie zapytania o aplikację, które mogą otwierać wymienione rozszerzenia plików. Jeśli podasz też appFilterMimeTypes, zostanie zwrócona suma dwóch list aplikacji. Przykłady rozszerzeń to docx w przypadku Microsoft Word i pptx w przypadku 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 podać kilka rozszerzeń plików jako parametr zapytania: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: filtruj wyniki wyszukiwania za pomocą rozdzielonej przecinkami listy typów MIME. W odpowiedzi uwzględniane są aplikacje w zakresie zapytania o aplikację, które mogą otwierać wymienione typy MIME. Jeśli podasz też appFilterExtensions, zostanie zwrócona suma dwóch list aplikacji. Przykłady typów MIME to application/vnd.google-apps.form w przypadku Formularzy Google i application/vnd.google-apps.site w przypadku Witryn Google. Więcej przykładów typów MIME znajdziesz w artykule Obsługiwane typy MIME w Google Workspace i na Dysku Google.

    Poniższy przykładowy kod pokazuje, jak podać kilka 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: filtruj wyniki wyszukiwania za pomocą kodu języka lub ustawień regionalnych, zgodnie z definicją w BCP 47 z kilkoma rozszerzeniami z formatu LDML Unicode. Przykłady kodów języka to en-us w przypadku języka angielskiego (Stany Zjednoczone) i fr-ca w przypadku języka francuskiego (Kanada).

    Poniższy przykładowy kod pokazuje, jak podać kilka kodów języka jako parametr zapytania: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Pobieranie aplikacji użytkownika według identyfikatora

Aby pobrać szczegółowe informacje o aplikacji jako instancję apps, użyj get metody z identyfikatorem aplikacji.

Poniższy przykładowy kod pokazuje, jak podać appId jako parametr zapytania w żądaniu. Odpowiedź zwraca wartości pól dla żądania.

Żądanie

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.

Oto kilka kolejnych kroków, które możesz wykonać: