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 유형을 유지합니다. 예를 들어 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 는 쿼리 용어의 조건을 지정합니다. 각 쿼리 용어와 함께 사용할 수 있는 연산자를 보려면 쿼리 연산자를 참고하세요.
values 는 검색 결과를 필터링하는 데 사용할 특정 값입니다.

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

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