사용자 정보 반환

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

  • about 리소스를 사용하면 사용자, 사용자의 Drive 설정, 시스템 기능에 관한 정보를 가져올 수 있습니다.

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

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

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

Drive 사용자에 대한 정보를 about의 인스턴스로 반환하려면 get() 메서드를 사용하세요. 반환된 값은 바이트 단위로 측정됩니다.

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의 인스턴스로 반환하려면 매개변수 없이 list() 메서드를 사용하세요.

fields 매개변수를 설정하여 응답에 반환할 필드를 나열할 수 있습니다. 필요한 필드를 정확하게 반환하려면 특정 필드 반환을 참고하세요.

예 보기

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

요청

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: BCP 47에 정의된 언어 또는 언어 코드(Unicode의 LDML 형식의 일부 확장 포함)를 사용하여 검색 결과를 필터링합니다. 언어 코드의 예로는 영어 (미국)의 경우 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

응답

{
  "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입니다.

다음과 같은 몇 가지 단계를 수행할 수 있습니다.