Google Drive에서는 Drive 사용자에 관한 정보를 수집하는 두 가지 옵션을 제공합니다.
about 리소스를 사용하면 사용자, 사용자의 Drive 설정, 시스템 기능에 관한 정보를 가져올 수 있습니다.
apps 리소스를 사용하면 각 앱의 지원되는 MIME 유형, 파일 확장자, 기타 세부정보와 함께 사용자가 설치한 앱 목록을 가져올 수 있습니다.
이 가이드에서는 Drive에서 사용자 정보를 가져오는 방법을 설명합니다.
사용자에 대한 세부정보 가져오기
드라이브 사용자에 관한 정보를 about 인스턴스로 반환하려면 get 메서드를 사용합니다. 반환된 값은 바이트 단위로 측정됩니다.
get 메서드에서 fields시스템 매개변수를 설정하여 응답에 반환할 필드를 지정해야 합니다. 대부분의 Drive 메서드에서 이 작업은 기본값이 아닌 필드를 반환하는 데만 필요하지만 about 리소스에는 필수입니다. 매개변수를 생략하면 메서드에서 오류를 반환합니다. 자세한 내용은 특정 필드 반환을 참고하세요.
다음 코드 샘플은 요청에서 여러 fields를 쿼리 매개변수로 제공하는 방법을 보여줍니다. 응답은 요청의 필드 값을 반환합니다.
요청
GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota
appFilterExtensions: 쉼표로 구분된 파일 확장자 목록을 사용하여 검색 결과를 필터링합니다. 나열된 파일 확장자를 열 수 있는 앱이 앱 쿼리 범위 내에 포함되어 응답에 포함됩니다. appFilterMimeTypes도 제공된 경우 두 결과 앱 목록의 합집합이 반환됩니다.
확장 프로그램의 예로는 Microsoft Word의 docx와 Microsoft PowerPoint의 pptx가 있습니다. 파일 확장 프로그램의 추가 예는 Google Workspace 문서의 MIME 유형 내보내기를 참고하세요.
다음 코드 샘플은 여러 파일 확장자를 GET
https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx 쿼리 매개변수로 제공하는 방법을 보여줍니다.
appFilterMimeTypes: 쉼표로 구분된 MIME 유형 목록을 사용하여 검색 결과를 필터링합니다. 나열된 MIME 유형을 열 수 있는 앱이 앱 쿼리 범위 내에 포함됩니다. appFilterExtensions도 제공된 경우 두 결과 앱 목록의 합집합이 반환됩니다. MIME 유형의 예로는 Google Forms의 application/vnd.google-apps.form와 Google Sites의 application/vnd.google-apps.site이 있습니다. MIME 유형의 추가 예는 Google Workspace 및 Google Drive 지원 MIME 유형을 참고하세요.
다음 코드 샘플은 여러 MIME 유형을 GET
https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site 쿼리 매개변수로 제공하는 방법을 보여줍니다.
languageCode: 유니코드의 LDML 형식의 일부 확장 프로그램과 함께 BCP 47에 정의된 언어 또는 언어 코드(locale code)를 사용하여 검색 결과를 필터링합니다. 언어 코드의 예로는 영어 (미국)의 경우 en-us, 프랑스어 (캐나다)의 경우 fr-ca이 있습니다.
다음 코드 샘플은 여러 언어 코드를 GET
https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca 쿼리 매개변수로 제공하는 방법을 보여줍니다.
ID로 사용자 앱 가져오기
자세한 앱 정보를 apps 인스턴스로 다운로드하려면 앱 ID와 함께 get 메서드를 사용합니다.
다음 코드 샘플은 요청에서 appId를 쿼리 매개변수로 제공하는 방법을 보여줍니다. 응답은 요청의 필드 값을 반환합니다.
요청
GET https://www.googleapis.com/drive/v3/apps/APP_ID
[null,null,["최종 업데이트: 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)."]]
