Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Google Drive, Drive kullanıcıları hakkında bilgi toplamak için iki seçenek sunar:
about kaynağını kullanarak kullanıcı, kullanıcının Drive ayarları ve sistem özellikleri hakkında bilgi alabilirsiniz.
apps kaynağını kullanarak kullanıcının yüklü uygulamalarının listesini alabilir, her uygulamanın desteklenen MIME türleri, dosya uzantıları ve diğer ayrıntıları hakkında bilgi edinebilirsiniz.
Bu kılavuzda, Drive'da kullanıcı bilgilerini nasıl alabileceğiniz açıklanmaktadır.
Kullanıcılarla ilgili ayrıntıları alma
Bir Drive kullanıcısıyla ilgili bilgileri about örneği olarak döndürmek için get yöntemini kullanın. Döndürülen değerler bayt cinsinden ölçülür.
Yanıt içinde döndürülecek alanları belirtmek için fieldssystem
parametresiniget yönteminde ayarlamanız gerekir. Çoğu Drive yönteminde bu işlem yalnızca varsayılan olmayan alanları döndürmek için gereklidir ancak about kaynağı için zorunludur. Parametreyi atlarsanız yöntem hata döndürür. Daha fazla bilgi için Belirli alanları döndürme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, istekte sorgu parametresi olarak birden fazla fields değerinin nasıl sağlanacağı gösterilmektedir. Yanıt, isteğin alan değerlerini döndürür.
İstek
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
Google Drive uygulamaları Google Workspace Marketplace'te listelenir ve Drive'ı daha kullanışlı hale getirmek için kullanılır. Örneğin, Google Dokümanlar uygulaması veya Dokümanlar'da dokümanları imzalamak için kullanılan bir eklenti. Daha fazla bilgi için Google Drive uygulamalarını kullanma başlıklı makaleyi inceleyin.
Kullanıcının yüklü tüm uygulamalarının listesini apps örneği olarak döndürmek için list yöntemini parametre olmadan kullanın.
Yanıt içinde döndürülecek alanları belirtmek istiyorsanız fieldssystem
parametresini ayarlayabilirsiniz. fields parametresini belirtmezseniz sunucu varsayılan bir alan grubu döndürür. Daha fazla bilgi için Belirli alanları döndürme başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, istekte kullanıcının yüklü tüm uygulamalarının listesinin nasıl döndürüleceği gösterilmektedir. Yanıt, isteğin alan değerlerini döndürür.
Belirli bir uygulamayı bulmak için isteğe bağlı sorgu parametrelerinden birini veya daha fazlasını kullanın:
appFilterExtensions: Arama sonuçlarını, virgülle ayrılmış dosya uzantıları listesini kullanarak filtreleyin. Uygulama sorgu kapsamındaki ve listelenen dosya uzantılarını açabilen uygulamalar yanıta dahil edilir. appFilterMimeTypes
de sağlanırsa sonuçta elde edilen iki uygulama listesinin birleşimi döndürülür.
Uzantı örnekleri arasında Microsoft Word için docx ve Microsoft PowerPoint için pptx yer alır. Dosya uzantılarıyla ilgili daha fazla örnek için Google Workspace dokümanları için MIME türlerini dışa aktarma başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, GET
https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx sorgu parametresi olarak birden fazla dosya uzantısının nasıl sağlanacağı gösterilmektedir.
appFilterMimeTypes: Arama sonuçlarını virgülle ayrılmış bir MIME türleri listesi kullanarak filtreleyin. Uygulama sorgusu kapsamındaki, listelenen MIME türlerini açabilen uygulamalar yanıta dahil edilir. appFilterExtensions da sağlanırsa sonuçta elde edilen iki uygulama listesinin birleşimi döndürülür. MIME türlerine örnek olarak Google Formlar için application/vnd.google-apps.form, Google Sites için application/vnd.google-apps.site verilebilir. MIME türleriyle ilgili daha fazla örnek için Google Workspace ve Google Drive'da desteklenen MIME türleri başlıklı makaleyi inceleyin.
Aşağıdaki kod örneğinde, sorgu parametresi olarak birden fazla MIME türünün nasıl sağlanacağı gösterilmektedir: GET
https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site.
languageCode: Arama sonuçlarını, Unicode'un LDML biçiminden bazı uzantılarla birlikte BCP 47 tarafından tanımlanan bir dil veya yerel ayar kodu kullanarak filtreleyin. Dil kodu örnekleri arasında İngilizce (ABD) için en-us ve Fransızca (Kanada) için fr-ca yer alır.
Aşağıdaki kod örneğinde, sorgu parametresi olarak birden fazla dil kodunun nasıl sağlanacağı gösterilmektedir: GET
https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca.
Kullanıcı uygulamasını kimliğe göre alma
Ayrıntılı uygulama bilgilerini apps örneği olarak indirmek için uygulama kimliğiyle birlikte get yöntemini kullanın.
Aşağıdaki kod örneğinde, istekte sorgu parametresi olarak appId nasıl sağlanacağı gösterilmektedir. Yanıt, isteğin alan değerlerini döndürür.
İstek
GET https://www.googleapis.com/drive/v3/apps/APP_ID
[null,null,["Son güncelleme tarihi: 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)."]]
