Tampilkan info pengguna

Google Drive menyediakan dua opsi untuk mengumpulkan informasi tentang pengguna Drive:

  • Dengan menggunakan resource about, Anda dapat mengambil informasi tentang pengguna, setelan Drive pengguna, dan kemampuan sistemnya.

  • Dengan menggunakan resource apps, Anda dapat mengambil daftar aplikasi yang diinstal pengguna, dengan informasi tentang setiap jenis MIME, ekstensi file, dan detail lainnya yang didukung aplikasi.

Panduan ini menjelaskan cara mengambil info pengguna di Drive.

Mengambil informasi tentang pengguna

Untuk menampilkan informasi tentang pengguna Drive sebagai instance about, gunakan metode about.get. Metode about.get memerlukan parameter kueri fields dalam panggilan metode Anda. Nilai yang ditampilkan diukur dalam byte. Untuk mengetahui informasi selengkapnya, lihat Menampilkan kolom tertentu untuk file.

Tampilkan contoh

Contoh kode berikut menunjukkan cara menyediakan beberapa fields sebagai parameter kueri dalam permintaan. Respons menampilkan nilai kolom untuk permintaan.

Permintaan

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

Respons

{
  "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"
  }
}

Responsnya mencakup nilai berikut:

  • DISPLAY_NAME: nama pengguna dalam teks biasa.
  • PHOTO_LINK: URL foto profil pengguna.
  • PERMISSION_ID: ID pengguna dalam resource Permission.
  • EMAIL_ADDRESS: alamat email pengguna

Mengambil informasi tentang aplikasi pengguna

Aplikasi Google Drive tercantum di Google Workspace Marketplace dan digunakan untuk membuat Drive lebih praktis seperti aplikasi Google Dokumen atau add-on yang digunakan dalam Dokumen untuk menandatangani dokumen. Untuk informasi selengkapnya, lihat Menggunakan aplikasi Google Drive.

Untuk menampilkan daftar semua aplikasi yang diinstal pengguna sebagai instance apps, gunakan metode apps.list tanpa parameter apa pun.

Tampilkan contoh

Contoh kode berikut menunjukkan cara menampilkan daftar semua aplikasi yang diinstal pengguna dalam permintaan. Respons menampilkan nilai kolom untuk permintaan.

Permintaan

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

Respons

{
  "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"
  ]
}

Responsnya mencakup nilai berikut:

  • ID: ID aplikasi.
  • PRODUCT_ID: ID listingan produk untuk aplikasi ini.

Mencantumkan aplikasi pengguna dengan parameter kueri

Untuk menemukan aplikasi tertentu, gunakan satu atau beberapa parameter kueri opsional:

  • appFilterExtensions: Memfilter hasil penelusuran menggunakan daftar ekstensi file yang dipisahkan koma. Aplikasi dalam cakupan kueri aplikasi yang dapat membuka ekstensi file yang tercantum disertakan dalam respons. Jika appFilterMimeTypes juga disediakan, gabungan dari dua daftar aplikasi yang dihasilkan akan ditampilkan. Contoh ekstensi meliputi docx untuk Microsoft Word dan pptx untuk Microsoft PowerPoint. Untuk contoh ekstensi file lainnya, lihat Mengekspor jenis MIME untuk dokumen Google Workspace.

    Contoh kode berikut menunjukkan cara memberikan beberapa ekstensi file sebagai parameter kueri: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx.

  • appFilterMimeTypes: Memfilter hasil penelusuran menggunakan daftar jenis MIME yang dipisahkan koma. Aplikasi dalam cakupan kueri aplikasi yang dapat membuka jenis MIME yang tercantum disertakan dalam respons. Jika appFilterExtensions juga disediakan, gabungan dari dua daftar aplikasi yang dihasilkan akan ditampilkan. Contoh jenis MIME mencakup application/vnd.google-apps.form untuk Google Formulir dan application/vnd.google-apps.site untuk Google Sites. Untuk contoh jenis MIME lainnya, lihat jenis MIME yang didukung Google Workspace dan Google Drive.

    Contoh kode berikut menunjukkan cara menyediakan beberapa jenis MIME sebagai parameter kueri: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.

  • languageCode: Memfilter hasil penelusuran menggunakan kode bahasa atau lokalitas, seperti yang ditentukan oleh BCP 47, dengan beberapa ekstensi dari format LDML Unicode. Contoh kode bahasa meliputi en-us untuk bahasa Inggris (Amerika Serikat) dan fr-ca untuk bahasa Prancis (Kanada).

    Contoh kode berikut menunjukkan cara memberikan beberapa kode bahasa sebagai parameter kueri: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.

Mendapatkan aplikasi pengguna berdasarkan ID

Untuk mendownload info aplikasi mendetail sebagai instance apps, gunakan metode apps.get dengan ID aplikasi.

Tampilkan contoh

Contoh kode berikut menunjukkan cara memberikan appId sebagai parameter kueri dalam permintaan. Respons menampilkan nilai kolom untuk permintaan.

Permintaan

GET https://www.googleapis.com/drive/v3/apps/APP_ID

Respons

{
  "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"
}

Responsnya mencakup nilai berikut:

  • ID: ID aplikasi.
  • PRODUCT_ID: ID listingan produk untuk aplikasi ini.

Berikut beberapa langkah berikutnya yang dapat Anda coba: