Drive 파일 바로가기 만들기

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

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

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

  • 대상 파일 또는 폴더를 가리키는 targetId('타겟'이라고도 함)

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

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

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

  • 타겟이 삭제되거나 현재 사용자가 타겟에 액세스할 수 없게 되면 타겟을 가리키는 사용자의 바로가기가 중단됩니다.

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

  • 바로가기의 MIME 유형이 오래될 수 있습니다. 드물지만 다른 유형의 버전이 업로드되면 blob 파일의 MIME 유형이 변경되지만 업데이트된 파일을 가리키는 바로가기는 원래 MIME 유형을 유지합니다. 예를 들어 Drive에 JPG 파일을 업로드한 다음 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: 이 바로가기의 이름입니다.

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

바로가기 검색

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

mimeType operator values

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

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

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

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