Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
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
sistemfields 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
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 sistemfields. 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.
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
[null,null,["Terakhir diperbarui pada 2025-09-01 UTC."],[],[],null,["Google Drive provides two options to gather information about\nDrive users:\n\n- Using the [`about`](/workspace/drive/api/reference/rest/v3/about) resource, you can retrieve\n information about the user, the user's Drive settings, and\n their system capabilities.\n\n- Using the [`apps`](/workspace/drive/api/reference/rest/v3/apps) resource, you can retrieve a\n list of the user's installed apps, with information about each app's\n supported MIME types, file extensions, and other details.\n\nThis guide explains how you can retrieve user info in Drive.\n\nGet details about a user\n\nTo return information on a Drive user as an instance of\n[`about`](/workspace/drive/api/reference/rest/v3/about), use the\n[`get`](/workspace/drive/api/reference/rest/v3/about/get) method. The returned values are measured\nin bytes.\n\nYou *must* set the `fields` [system\nparameter](https://cloud.google.com/apis/docs/system-parameters#definitions) on\nthe `get` method to specify the fields to return in the response. In most\nDrive methods this action is only required to return non-default\nfields but it's mandatory for the `about` resource. If you omit the parameter,\nthe method returns an error. For more information, see [Return specific fields](/workspace/drive/api/guides/fields-parameter).\n| **Note:** If you're using the previous Drive API v2 version, setting the `fields` parameter in the `get` method isn't required. Learn how to [migrate to\nDrive API v3](/workspace/drive/api/guides/migrate-to-v3). \nThe following code sample shows how to provide multiple `fields` as a query parameter in the request. The response returns the field values for the request.\n\n**Request** \n\n```text\nGET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota\n```\n\n**Response** \n\n```scdoc\n{\n \"kind\": \"drive#about\",\n \"user\": {\n \"kind": \"drive#user\",\n \"displayName\": \"DISPLAY_NAME\",\n \"photoLink\": \"PHOTO_LINK\";,\n \"me\": true,\n \"permissionId\": \"PERMISSION_ID\",\n \"emailAddress\": \"EMAIL_ADDRESS\"\n },\n \"storageQuota\": {\n \"usage\": \"10845031958\",\n \"usageInDrive\": \"2222008387\",\n \"usageInDriveTrash\": \"91566\"\n }\n}\n```\n\nThe response includes the following values:\n\n- \u003cvar translate=\"no\"\u003eDISPLAY_NAME\u003c/var\u003e: the user's name in plain text.\n- \u003cvar translate=\"no\"\u003ePHOTO_LINK\u003c/var\u003e: the URL of the user's profile photo.\n- \u003cvar translate=\"no\"\u003ePERMISSION_ID\u003c/var\u003e: the user's ID within the `Permission` resources.\n- \u003cvar translate=\"no\"\u003eEMAIL_ADDRESS\u003c/var\u003e: the user's email address\n\nList user apps\n\nGoogle Drive apps are listed in the\n[Google Workspace Marketplace](https://workspace.google.com/marketplace) and\nare used to make Drive more convenient such as the Google Docs\napp or an add-on used within Docs to\nsign documents. For more information, see [Use Google Drive\napps](https://support.google.com/drive/answer/2500820).\n\nTo return a list of all the user's installed apps as an instance of [`apps`](/workspace/drive/api/reference/rest/v3/apps), use the [`list`](/workspace/drive/api/reference/rest/v3/apps/list) method\nwithout any parameters.\n\nIf you want to specify the fields to return in the response, you can set the\n`fields` [system\nparameter](https://cloud.google.com/apis/docs/system-parameters#definitions). If\nyou don't specify the `fields` parameter, the server returns a default set of\nfields. For more information, see [Return specific fields](/workspace/drive/api/guides/fields-parameter).\n| **Note:** If you're using the previous Drive API v2 version, the response body also includes the `etag` field. Learn how to [migrate to\nDrive API v3](/workspace/drive/api/guides/migrate-to-v3). \nThe following code sample shows how to return a list of all the user's installed apps in the request. The response returns the field values for the request.\n\n**Request** \n\n```text\nGET https://www.googleapis.com/drive/v3/apps\n```\n\n**Response** \n\n```scdoc\n{\n \"kind\": \"drive#appList\",\n \"selfLink\": \"https://www.googleapis.com/drive/v3/apps\",\n \"items\": [\n {\n \"kind\": \"drive#app\",\n \"id\": \"ID\",\n \"name\": \"Google Sheets\",\n \"supportsCreate\": true,\n \"supportsImport\": true,\n \"supportsMultiOpen\": false,\n \"supportsOfflineCreate\": true,\n \"productUrl\": \"https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap\",\n \"productId\": \"PRODUCT_ID\"\n }\n ],\n \"defaultAppIds\": [\n \"ID\"\n ]\n}\n```\n\nThe response includes the following values:\n\n- \u003cvar translate=\"no\"\u003eID\u003c/var\u003e: the app ID.\n- \u003cvar translate=\"no\"\u003ePRODUCT_ID\u003c/var\u003e: the product listing ID for this app.\n\nList user apps with query parameters\n\nTo find a specific app, use one or more of the optional query parameters:\n\n- `appFilterExtensions`: Filter the search results using a comma-separated\n list of file extensions. Apps within the app query scope that can open the\n listed file extensions are included in the response. If `appFilterMimeTypes`\n are also provided, a union of the two resulting app lists is returned.\n Examples of extensions include `docx` for Microsoft Word and `pptx` for\n Microsoft PowerPoint. For more examples of file extensions, see [Export MIME\n types for Google Workspace documents](/workspace/drive/api/guides/ref-export-formats).\n\n The following code sample shows how to provide multiple file extensions as a\n query parameter: `GET\n https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx`.\n- `appFilterMimeTypes`: Filter the search results using a comma-separated list\n of MIME types. Apps within the app query scope that can open the listed MIME\n types are included in the response. If `appFilterExtensions` are also\n provided, a union of the two resulting app lists is returned. Examples of\n MIME types include `application/vnd.google-apps.form` for Google Forms and\n `application/vnd.google-apps.site` for Google Sites. For more examples of\n MIME types, see [Google Workspace and Google Drive supported MIME\n types](/workspace/drive/api/guides/mime-types).\n\n The following code sample shows how to provide multiple MIME types as a\n query parameter: `GET\n https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site`.\n- `languageCode`: Filter the search results using a language or locale code,\n as defined by BCP 47, with some extensions from [Unicode's LDML\n format](https://www.unicode.org/reports/tr35/). Examples of language codes\n include `en-us` for English (United States) and `fr-ca` for French (Canada).\n\n The following code sample shows how to provide multiple language codes as a\n query parameter: `GET\n https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca`.\n\nGet user app by ID\n\nTo download the detailed app info as an instance of\n[`apps`](/workspace/drive/api/reference/rest/v3/apps), use the [`get`](/workspace/drive/api/reference/rest/v3/apps/get)\nmethod with the app ID. \nThe following code sample shows how to provide an `appId` as a query parameter in the request. The response returns the field values for the request.\n\n**Request** \n\n```scdoc\nGET https://www.googleapis.com/drive/v3/apps/APP_ID\n```\n\n**Response** \n\n```scdoc\n{\n \"kind\": \"drive#app\",\n \"id\": \"ID\",\n \"name\": \"Google Sheets\",\n \"supportsCreate\": true,\n \"supportsImport\": true,\n \"supportsMultiOpen\": false,\n \"supportsOfflineCreate\": true,\n \"productUrl": \"https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap\",\n \"productId\": \"PRODUCT_ID\"\n}\n```\n\nThe response includes the following values:\n\n- \u003cvar translate=\"no\"\u003eID\u003c/var\u003e: the app ID.\n- \u003cvar translate=\"no\"\u003ePRODUCT_ID\u003c/var\u003e: the product listing ID for this app.\n\nRelated topics\n\nHere are a few next steps you might try:\n\n- To create a file in Drive, see [Create and manage files](/workspace/drive/api/guides/create-file).\n\n- To upload file data when you create or update a file, see [Upload file\n data](/workspace/drive/api/guides/manage-uploads).\n\n- To download and export files, see [Download and export\n files](/workspace/drive/api/guides/manage-downloads)."]]
