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 필드는 파일 리소스 내의 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: 이 바로가기의 이름

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

바로가기 검색

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

mimeType operator values

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

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

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

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