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.

Mendapatkan detail tentang pengguna

Untuk menampilkan informasi tentang pengguna Drive sebagai instance about, gunakan metode get(). Nilai yang ditampilkan diukur dalam byte.

Metode get() memerlukan parameter fields untuk mencantumkan kolom yang akan ditampilkan dalam respons. Jika Anda menghilangkan parameter, metode akan menampilkan error. Untuk menampilkan kolom yang tepat yang Anda butuhkan, lihat Menampilkan kolom tertentu.

Tampilkan contoh

Contoh kode berikut menunjukkan cara memberikan 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

Mencantumkan 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 list() tanpa parameter apa pun.

Anda dapat menetapkan parameter fields untuk mencantumkan kolom yang akan ditampilkan dalam respons. Untuk menampilkan kolom yang tepat yang Anda perlukan, lihat Menampilkan kolom tertentu.

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-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 memberikan 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 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-nilai berikut:

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

Berikut beberapa langkah berikutnya yang dapat Anda coba: