공유 드라이브 지원 구현

공유 드라이브에는 다양한 조직, 공유, 소유권이 적용됩니다. 내 드라이브에서 모델을 찾을 수 있습니다. 앱에서 공유 파일을 만들고 관리하려는 경우 앱에서 공유 드라이브 지원을 구현해야 합니다. Kubernetes의 복잡성 구현은 앱의 기능에 따라 달라집니다.

시작하려면 supportsAllDrives=true 쿼리 매개변수를 앱에서 다음과 같은 작업을 수행할 때 요청을 처리합니다.

드라이브 API v3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

드라이브 API v2

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

supportsAllDrives=true 매개변수는 Google Drive에 공유 드라이브의 파일을 처리하도록 설계되었습니다.

권한을 읽거나 수정하거나, 변경사항을 추적하거나, 수정해야 하는 애플리케이션 여러 코퍼스에서 검색하려면 공유 드라이브 기능이 추가로 필요합니다. 이 문서의 나머지 부분에서는 다음을 수행하는 데 필요한 추가 변경사항에 대해 설명합니다. 작업을 수행합니다

공유 드라이브의 콘텐츠 검색하기

files.list 메서드를 사용하여 공유 드라이브를 탭합니다. 이 섹션에서는 files.list 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 공유 드라이브를 검색하려면 다음을 참고하세요. 파일 및 폴더 검색

files.list 메서드에는 다음과 같은 공유된 드라이브 전용 필드 및 쿼리 모드:

  • driveId — 검색할 공유 드라이브의 ID입니다.

  • includeItemsFromAllDrives: 공유 드라이브 항목 포함 여부 표시됩니다. 존재하지 않거나 false로 설정된 경우 공유 드라이브 항목 반환되지 않습니다.

  • corpora - 대상 항목 (파일/문서)의 본문 지정할 수 있습니다. 지원되는 본문은 user, domain, drive, allDrives 효율성을 위해 allDrives보다 user 또는 drive를 사용하는 것이 좋습니다.

  • supportsAllDrives — 요청하는 애플리케이션의 지원 여부 내 드라이브와 공유 드라이브 모두 false인 경우 공유 드라이브 항목이 포함되지 않습니다. 포함되어 있습니다.

다음 쿼리 모드는 공유 드라이브에만 적용됩니다.

includeItemsFromAllDrives corpora 검색어 설명
true user 공유 드라이브 및 내 드라이브 파일을 비롯하여 사용자가 액세스한 파일을 쿼리합니다.
true drive 지정된 공유 드라이브의 모든 항목을 쿼리합니다. 요청에 driveId를 지정해야 합니다.
true allDrives 사용자가 액세스한 파일 및 사용자가 구성원인 모든 공유 드라이브를 쿼리합니다. 응답에는 incompleteSearch : true가 포함될 수 있으며, 이는 이 요청에서 일부 코퍼스가 검색되지 않았음을 나타냅니다.
true domain 공유 드라이브 및 내 드라이브 파일을 모두 비롯하여 도메인에 공유된 파일을 쿼리합니다.

공유 드라이브의 변경사항 추적하기

changes.list 메서드를 사용하여 변경사항 추적 (공유 드라이브) 이 섹션에서는 changes.list 메서드를 사용하여 지도 가장자리에 패딩을 추가할 수 있습니다. 자세한 내용은 사용자 및 공유 드라이브의 변경사항 추적 changes.list 메서드에는 다음과 같은 공유된 드라이브 전용 필드 및 쿼리 모드:

  • driveId - 변경사항이 반환되는 공유 드라이브입니다. 만약 지정된 경우 변경 ID는 공유 드라이브 내의 변경사항을 나타내며 변경할 수 없습니다. 특정 공유 드라이브 참조하기 변경하려면 공유 드라이브 ID와 변경 ID가 모두 식별자로 사용되어야 합니다.
  • supportsAllDrives: 요청하는 애플리케이션이 공유를 지원하는지 여부 있습니다. false인 경우 공유 드라이브 및 공유 드라이브 항목을 모두 포함한 공유 드라이브 항목 파일은 반환되지 않습니다.
  • includeItemsFromAllDrives: 공유 드라이브 파일 또는 변경사항 적용 여부 확인할 수 있습니다

다음 쿼리 모드는 공유 드라이브에만 적용됩니다.

includeItemsFromAllDrives driveId 검색어 설명
true 아니요 변경사항은 사용자가 액세스한 공유 드라이브 내부 또는 외부의 파일과 사용자가 회원으로 속해 있는 공유 드라이브의 변경사항을 반영합니다.
true 예 변경사항은 지정된 특정 공유 드라이브와 해당 공유 드라이브 내 항목의 변경사항을 반영합니다.

변경 로그 동작에 대한 자세한 내용은 다음을 참조하세요. 변경 로그.

Drive UI에서 공유 드라이브 지원 사용 설정

Drive UI를 사용하여 공유 드라이브 콘텐츠에 액세스하려면 '공유 드라이브 지원' 를 Google API 콘솔. 자세한 내용은 Drive UI 통합 구성하기

공유 드라이브에서 파일 선택 도구 사용하기

파일 선택 도구로 공유 드라이브의 항목을 선택할 수 있습니다. 공유 드라이브 지원 사용 설정 및 공유 드라이브 뷰 추가에 대한 자세한 내용 파일 선택 도구에서 Google Picker API를 참고하세요.

다음 단계

공유 드라이브 관리로 이동하여 다음을 수행합니다. 공유 드라이브 생성 및 공유 드라이브 권한 관리에 대한 도움말을 확인하세요.