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. Więcej informacji znajdziesz w artykule Obsługiwane typy MIME w Google Workspace i na Dysku Google.

  • Lista ACL skrótu dziedziczy listę ACL elementu nadrzędnego. Listy ACL skrótu nie można zmienić bezpośrednio.

  • targetId wskazujący plik lub folder docelowy, zwany też „elementem docelowym”.

  • targetMimeType wskazujący typ MIME celu. Pole targetMimeType służy do określania ikony typu, która ma się wyświetlać. Typ MIME elementu docelowego jest kopiowany do pola targetMimeType podczas tworzenia skrótu.

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

  • Skrót może mieć tylko jeden element nadrzędny. Jeśli plik skrótu jest potrzebny w innych lokalizacjach na Dysku, można go skopiować do tych lokalizacji.

  • Gdy element docelowy zostanie usunięty lub bieżący użytkownik utraci do niego dostęp, skrót użytkownika wskazujący ten element przestanie działać.

  • Tytuł skrótu może się różnić od elementu docelowego. Gdy tworzony jest skrót, tytuł elementu docelowego jest używany jako tytuł skrótu. Po utworzeniu skrótu można niezależnie zmienić jego tytuł i tytuł elementu docelowego. Jeśli nazwa elementu docelowego zostanie zmieniona, wcześniej utworzone skróty zachowają stary tytuł.

  • Typ MIME skrótu może stać się nieaktualny. Chociaż rzadko, typ MIME pliku blob zmienia się, gdy przesyłana jest wersja innego typu, ale wszystkie skróty wskazujące zaktualizowany plik zachowują pierwotny typ MIME. Jeśli na przykład prześlesz na Dysk plik JPG, a następnie prześlesz wersję AVI, Dysk wykryje zmianę i zaktualizuje miniaturę rzeczywistego pliku. Jednak skrót nadal ma miniaturę JPG.

  • W Eksporcie danych z konta Google, znanym też jako Google Takeout, skróty są reprezentowane jako pliki zakładek Netscape zawierające linki do miejsca 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ć skrót, i wywołaj files.create, aby utworzyć skrót.

Poniższe przykłady pokazują, jak utworzyć skrót za pomocą 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, do którego chcesz utworzyć skrót.
  • 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 do plików lub folderów, do których bieżący użytkownik ma dostęp.

Wyszukiwanie skrótu

Aby wyszukać skrót, użyj ciągu zapytania q with files.list, aby odfiltrować skróty do zwrócenia.

mimeType operator values

Gdzie:

  • query_term to wyszukiwane hasło lub pole. Aby wyświetlić terminy zapytań, których można używać do filtrowania dysków współdzielonych, zapoznaj się z sekcją Terminy zapytań.
  • operator określa warunek terminu zapytania. Aby sprawdzić, których operatorów możesz używać z poszczególnymi terminami zapytania, zapoznaj się z sekcją Operatory zapytań.
  • wartości to konkretne wartości, których chcesz użyć do filtrowania wyników wyszukiwania.

Na przykład ten ciąg zapytania filtruje wyszukiwanie, aby zwracać wszystkie skróty do plików arkuszy kalkulacyjnych:

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