Drive 파일 바로가기 만들기

바로가기는 Google Drive에 있는 다른 파일 또는 폴더로 연결되는 파일입니다. 바로가기의 특징은 다음과 같습니다.

  • application/vnd.google-apps.shortcut MIME 유형입니다. 자세한 내용은 Google Workspace 및 Google Drive에서 지원되는 MIME 유형을 참고하세요.

  • 바로가기의 ACL은 상위 요소의 ACL을 상속합니다. 바로가기의 ACL은 직접 변경할 수 없습니다.

  • 타겟 파일 또는 폴더를 가리키는 targetId. '대상'이라고도 합니다.

  • 대상의 MIME 유형을 나타내는 targetMimeType입니다. targetMimeType는 표시할 유형 아이콘을 결정하는 데 사용됩니다. 바로가기가 생성되면 타겟의 MIME 유형이 targetMimeType 필드에 복사됩니다.

  • targetIdtargetMimeType 필드는 file 리소스 내 shortcutDetails 필드의 일부입니다.

  • 바로가기에는 상위 요소가 하나만 있을 수 있습니다. 다른 Drive 위치에 바로가기 파일이 필요한 경우 바로가기 파일을 추가 위치에 복사할 수 있습니다.

  • 타겟이 삭제되거나 현재 사용자가 타겟에 대한 액세스 권한을 상실하면 타겟을 가리키는 사용자의 바로가기가 중단됩니다.

  • 바로가기의 제목은 대상과 다를 수 있습니다. 바로가기가 생성되면 타겟의 제목이 바로가기의 제목으로 사용됩니다. 생성 후 바로가기의 제목과 타겟의 제목은 독립적으로 변경할 수 있습니다. 타겟의 이름이 변경되면 이전에 만든 바로가기는 이전 제목을 유지합니다.

  • 바로가기의 MIME 유형이 오래될 수 있습니다. 드물기는 하지만 다른 유형의 버전이 업로드될 때 blob 파일의 MIME 유형이 변경되지만 업데이트된 파일을 가리키는 모든 바로가기는 원래 MIME 유형을 유지합니다. 예를 들어 JPG 파일을 Drive에 업로드한 다음 AVI 버전을 업로드하면 Drive가 변경사항을 식별하고 실제 파일의 썸네일을 업데이트합니다. 하지만 바로가기에는 JPG 썸네일이 계속 포함됩니다.

  • Google 테이크아웃이라고도 하는 Google 계정 데이터 내보내기에서 바로가기는 대상 링크가 포함된 Netscape 북마크 파일로 표시됩니다.

자세한 내용은 Google Drive 바로가기로 파일 및 폴더 찾기를 참고하세요.

바로가기 만들기

바로가기를 만들려면 MIME 유형을 application/vnd.google-apps.shortcut으로 설정하고 targetId을 바로가기가 연결할 파일 또는 폴더로 설정한 다음 files.create를 호출하여 바로가기를 만듭니다.

다음 예는 클라이언트 라이브러리를 사용하여 바로가기를 만드는 방법을 보여줍니다.

Python

file_metadata = {
    'name': 'FILE_NAME',
    'mimeType': 'text/plain'
}
file = drive_service.files().create(body=file_metadata, fields='id').execute()
print('File ID: %s' % file.get('id'))
shortcut_metadata = {
     'Name': 'SHORTCUT_NAME',
     'mimeType': 'application/vnd.google-apps.shortcut',
     'shortcutDetails': {
        'targetId': file.get('id')
     }
}
shortcut = drive_service.files().create(body=shortcut_metadata,
                                    fields='id,shortcutDetails').execute()
print('File ID: %s, Shortcut Target ID: %s, Shortcut Target MIME type: %s' % (
    shortcut.get('id'),
    shortcut.get('shortcutDetails').get('targetId'),
    shortcut.get('shortcutDetails').get('targetMimeType')))

Node.js

var fileMetadata = {
  'name': 'FILE_NAME',
  'mimeType': 'text/plain'
};
drive.files.create({
  'resource': fileMetadata,
  'fields': 'id'
}, function (err, file) {
  if (err) {
    // Handle error
    console.error(err);
  } else {
    console.log('File Id: ' + file.id);
    shortcutMetadata = {
      'name': 'SHORTCUT_NAME',
      'mimeType': 'application/vnd.google-apps.shortcut'
      'shortcutDetails': {
        'targetId': file.id
      }
    };
    drive.files.create({
      'resource': shortcutMetadata,
      'fields': 'id,name,mimeType,shortcutDetails'
    }, function(err, shortcut) {
      if (err) {
        // Handle error
        console.error(err);
      } else {
        console.log('Shortcut Id: ' + shortcut.id +
                    ', Name: ' + shortcut.name +
                    ', target Id: ' + shortcut.shortcutDetails.targetId +
                    ', target MIME type: ' + shortcut.shortcutDetails.targetMimeType);
      }
    }
  }
});

다음을 바꿉니다.

  • FILE_NAME: 바로가기가 필요한 파일 이름입니다.
  • SHORTCUT_NAME: 바로가기의 이름입니다.

기본적으로 바로가기는 현재 사용자의 내 드라이브에 생성되고 바로가기는 현재 사용자가 액세스할 수 있는 파일 또는 폴더에만 생성됩니다.

바로가기 검색

바로가기를 검색하려면 files.list와 함께 쿼리 문자열 q를 사용하여 반환할 바로가기를 필터링합니다.

mimeType operator values

각 항목의 의미는 다음과 같습니다.

  • query_term은 검색할 검색어 또는 필드입니다. 공유 드라이브를 필터링하는 데 사용할 수 있는 검색어를 보려면 검색어를 참고하세요.
  • 연산자는 검색어의 조건을 지정합니다. 각 검색어와 함께 사용할 수 있는 연산자를 보려면 쿼리 연산자를 참조하세요.
  • values는 검색 결과를 필터링하는 데 사용할 특정 값입니다.

예를 들어 다음 쿼리 문자열은 검색을 필터링하여 스프레드시트 파일의 모든 바로가기를 반환합니다.

q: mimeType='application/vnd.google-apps.shortcut' AND shortcutDetails.targetMimeType='application/vnd.google-apps.spreadsheet'