Tworzenie skrótu do pliku na Dysku

Skróty to pliki, które zawierają linki do innych plików lub folderów na Dysku Google. Skróty mają te cechy:

  • Typ MIME application/vnd.google-apps.shortcut.

  • Listy ACL dla skrótu dziedziczą listę ACL elementu nadrzędnego. Listy ACL skrótów nie można bezpośrednio zmienić.

  • targetId wskazujący docelowy plik lub folder, zwany także „celem”.

  • targetMimeType wskazujący typ MIME elementu docelowego. Wartość targetMimeType jest używana do określenia typu wyświetlania do wyświetlenia. Typ MIME elementu docelowego jest kopiowany do pola targetMimeType podczas tworzenia skrótu.

  • Pola targetId i targetMimeType są częścią pola shortcutDetails w zasobie Pliki.

  • Skrót może mieć tylko 1 element nadrzędny. Jeśli plik skrótu jest wymagany w innych lokalizacjach na Dysku, możesz skopiować ten plik do dodatkowych lokalizacji.

  • Gdy cel zostanie usunięty lub obecny użytkownik utraci do niego dostęp, jego skrót wskazujący cel przestanie działać.

  • Tytuł skrótu może różnić się od docelowego. Po utworzeniu skrótu jego nazwa zostanie użyta jako tytuł skrótu. Po utworzeniu tytułu skrótu i tytułu celu możesz zmienić niezależnie. Jeśli zmienisz nazwę celu, utworzone wcześniej skróty zachowają stary tytuł.

  • Typ MIME skrótu może stać się nieaktualny. W rzadkich przypadkach typ MIME pliku blob zmienia się po przekazaniu wersji innego typu, ale wszystkie skróty prowadzące do zaktualizowanego pliku zachowają oryginalny typ MIME. Jeśli na przykład prześlesz plik JPG na Dysk, a następnie poprawkę AVI, Dysk rozpozna zmianę i zaktualizuje miniaturę pliku. Skrót nadal ma miniaturę.

  • W eksporcie danych konta Google, nazywanym też Google Takeout, skróty są reprezentowane przez pliki Netscape zakładek zawierających linki do elementu docelowego.

  • Więcej informacji znajdziesz w artykule Znajdowanie plików i folderów za pomocą skrótów Dysku Google.

Utwórz skrót

Aby utworzyć skrót, ustaw typ MIME na application/vnd.google-apps.shortcut, ustaw targetId na plik lub folder, do którego ma prowadzić link, a następnie wywołaj Files.create.

Poniższe przykłady pokazują, jak utworzyć skrót przy użyciu biblioteki klienta:

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);
      }
    }
  }
});

Zastąp następujące elementy:

  • FILE_NAME: nazwa pliku wymagającego skrótu
  • SHORTCUT_NAME: nazwa tego skrótu

Domyślnie skrót jest tworzony na Moim dysku bieżącego użytkownika, a skróty są tworzone tylko dla plików lub folderów, do których bieżący użytkownik ma dostęp.

Wyszukaj skrót

Aby wyszukać skrót, użyj ciągu zapytania q z files.list w celu odfiltrowania skrótów do zwrócenia.

mimeType operator values

Gdzie:

  • query_term to wyszukiwane hasło lub pole. Wyszukiwane hasła, których można użyć do filtrowania dysków współdzielonych, znajdziesz w artykule Wyszukiwane hasła.
  • Operator określa warunek zapytania. Aby sprawdzić, których operatorów możesz użyć w przypadku poszczególnych haseł, zapoznaj się z artykułem Operatory zapytań.
  • Wartości to konkretne wartości, których chcesz używać do filtrowania wyników wyszukiwania.

Na przykład ten ciąg zapytania filtruje wyniki wyszukiwania, aby wyświetlić wszystkie skróty do plików arkuszy kalkulacyjnych:

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