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 jenis MIME, ekstensi file, dan detail lainnya yang didukung setiap 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.

Anda harus menetapkan parameter sistem fields pada metode get untuk menentukan kolom yang akan ditampilkan dalam respons. Di sebagian besar metode Drive, tindakan ini hanya diperlukan untuk menampilkan kolom non-default, tetapi wajib untuk resource about. Jika Anda menghilangkan parameter, metode akan menampilkan error. Untuk mengetahui informasi selengkapnya, lihat Menampilkan kolom tertentu.

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

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

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.

Jika ingin menentukan kolom yang akan ditampilkan dalam respons, Anda dapat menetapkan parameter sistem fields. Jika Anda tidak menentukan parameter fields, server akan menampilkan kumpulan kolom default. Untuk mengetahui informasi selengkapnya, lihat Menampilkan kolom tertentu.

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

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

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.

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

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

Topik terkait

Berikut beberapa langkah berikutnya yang dapat Anda coba:

• Untuk membuat file di Drive, lihat Membuat dan mengelola file.

• Untuk mengupload data file saat Anda membuat atau memperbarui file, lihat Mengupload data file.

• Untuk mendownload dan mengekspor file, lihat Mendownload dan mengekspor file.