사용자 정보 반환

Google Drive에서는 Drive 사용자에 대한 정보를 수집하는 두 가지 옵션을 제공합니다.

  • about 리소스를 사용하여 사용자, 사용자의 Drive 설정, 시스템 기능에 대한 정보를 검색할 수 있습니다.

  • apps 리소스를 사용하면 각 앱에서 지원되는 MIME 유형, 파일 확장자, 기타 세부정보에 관한 정보와 함께 사용자가 설치한 앱 목록을 검색할 수 있습니다.

이 가이드에서는 Drive에서 사용자 정보를 검색하는 방법을 설명합니다.

사용자에 대한 정보 가져오기

Drive 사용자의 정보를 about의 인스턴스로 반환하려면 about.get 메서드를 사용하세요. about.get 메서드를 사용하려면 메서드 호출에 fields 쿼리 매개변수가 필요합니다. 반환된 값은 바이트 단위로 측정됩니다. 자세한 내용은 파일의 특정 필드 반환을 참고하세요.

예 보기

다음 코드 샘플은 요청에서 여러 fields를 쿼리 매개변수로 제공하는 방법을 보여줍니다. 응답에서 요청의 필드 값을 반환합니다.

요청

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

응답에는 다음 값이 포함됩니다.

  • DISPLAY_NAME: 일반 텍스트로 된 사용자 이름입니다.
  • PHOTO_LINK: 사용자 프로필 사진의 URL입니다.
  • PERMISSION_ID: Permission 리소스 내의 사용자 ID
  • EMAIL_ADDRESS: 사용자의 이메일 주소입니다.

사용자의 앱에 대한 정보 가져오기

Google Drive 앱은 Google Workspace Marketplace에 등록되어 있으며, Google Docs 앱 또는 Docs 내에서 문서에 서명하는 데 사용되는 부가기능과 같이 Drive를 더 편리하게 만드는 데 사용됩니다. 자세한 내용은 Google Drive 앱 사용을 참고하세요.

사용자가 설치한 모든 앱 목록을 apps의 인스턴스로 반환하려면 매개변수 없이 apps.list 메서드를 사용합니다.

예 보기

다음 코드 샘플은 요청에서 사용자가 설치한 모든 앱 목록을 반환하는 방법을 보여줍니다. 응답에서 요청의 필드 값을 반환합니다.

요청

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

응답에는 다음 값이 포함됩니다.

  • ID: 앱 ID입니다.
  • PRODUCT_ID: 이 앱의 제품 등록정보 ID입니다.

쿼리 매개변수가 있는 사용자 앱 나열

특정 앱을 찾으려면 선택적 쿼리 매개변수 중 하나 이상을 사용합니다.

  • 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에 정의된 언어 또는 언어 코드를 사용하여 검색결과를 필터링합니다. 언어 코드의 예로는 영어 (미국)를 나타내는 en-us, 프랑스어 (캐나다)를 나타내는 fr-ca가 있습니다.

    다음 코드 샘플은 여러 언어 코드를 쿼리 매개변수로 제공하는 방법을 보여줍니다. GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca

ID로 사용자 앱 가져오기

자세한 앱 정보를 apps의 인스턴스로 다운로드하려면 apps.get 메서드와 앱 ID를 사용하세요.

예 보기

다음 코드 샘플은 appId를 요청에서 쿼리 매개변수로 제공하는 방법을 보여줍니다. 응답에서 요청의 필드 값을 반환합니다.

요청

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

응답에는 다음 값이 포함됩니다.

  • ID: 앱 ID입니다.
  • PRODUCT_ID: 이 앱의 제품 등록정보 ID입니다.

다음 단계를 시도해 보세요.