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

Panduan ini menjelaskan cara Anda dapat 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 Mengembalikan kolom tertentu.

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 dicantumkan 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 mengetahui 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 menyetel parameter sistem fields. Jika Anda tidak menentukan parameter fields, server akan menampilkan kumpulan kolom default. Untuk mengetahui informasi selengkapnya, lihat Mengembalikan kolom tertentu.

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 diberikan, gabungan dari dua daftar aplikasi yang dihasilkan akan ditampilkan. Contoh ekstensi mencakup docx untuk Microsoft Word dan pptx untuk Microsoft PowerPoint. Untuk melihat 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 diberikan, 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 mencakup 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.

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 selanjutnya yang dapat Anda coba: