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 sistem mereka.

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

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 informasi selengkapnya, lihat Menampilkan kolom tertentu untuk file.

Tampilkan contoh

Contoh kode berikut menunjukkan cara menyediakan beberapa fields sebagai parameter kueri dalam permintaan. Respons akan 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 menjadi lebih praktis, seperti aplikasi Google Dokumen atau add-on yang digunakan dalam Dokumen untuk menandatangani dokumen. Untuk mengetahui 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 terinstal pengguna dalam permintaan. Respons akan 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 akan disertakan dalam respons. Jika appFilterMimeTypes juga disediakan, gabungan dari dua daftar aplikasi yang dihasilkan akan ditampilkan. Contoh ekstensi mencakup 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 menyediakan 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 akan disertakan dalam respons. Jika appFilterExtensions juga disediakan, gabungan 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 mengetahui 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 mencakup en-us untuk bahasa Inggris (Amerika Serikat) dan fr-ca untuk Prancis (Kanada).

    Contoh kode berikut menunjukkan cara menyediakan 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 menyediakan appId sebagai parameter kueri dalam permintaan. Respons akan 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 selanjutnya yang dapat Anda coba: