Tworzenie skrótu do pliku na Dysku

Skróty to pliki zawierające 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 o obsługiwanych typach MIME w Google Workspace i Dysku Google.

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

  • Element targetId wskazujący plik lub folder docelowy (nazywany też „celem”).

  • Wartość targetMimeType wskazująca typ MIME elementu docelowego. targetMimeType służy do określania ikony typu, która ma być wyświetlana. Typ MIME celu jest kopiowany do pola targetMimeType po utworzeniu skrótu.

  • Pola targetId i targetMimeType wchodzą w skład pola shortcutDetails w zasobie file.

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

  • Gdy miejsce docelowe zostanie usunięte lub bieżący użytkownik utraci do niego dostęp, skrót użytkownika wskazujący przerwy w środowisku docelowym.

  • Tytuł skrótu może różnić się od nazwy elementu docelowego. Po utworzeniu skrótu jego nazwa będzie używana jako tytuł skrótu. Po utworzeniu skrótu możesz zmienić jego tytuł i tytuł miejsca docelowego. Jeśli nazwa miejsca docelowego się zmieni, wcześniej utworzone skróty zachowają stary tytuł.

  • Typ MIME skrótu może stać się nieaktualny. W rzadkich przypadkach typ MIME pliku blob zmienia się po przesłaniu wersji innego typu. Jednak wszystkie skróty wskazujące zaktualizowanego pliku zachowują oryginalny typ MIME. Jeśli na przykład prześlesz plik JPG na Dysk, a potem prześlesz wersję AVI, Dysk rozpozna zmianę i zaktualizuje miniaturę pliku. Skrót nadal ma miniaturę w formacie JPG.

  • W eksportowaniu danych konta Google, nazywanym też 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 powinien 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 wymagająca skrótu.
  • SHORTCUT_NAME: nazwa skrótu.

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

Wyszukaj skrót

Aby wyszukać skrót, użyj ciągu zapytania q z parametrem files.list, aby przefiltrować skróty do zwracania.

mimeType operator values

Gdzie:

  • query_term to wyszukiwane hasło lub pole zapytania. Aby wyświetlić hasła, na podstawie których można filtrować dyski współdzielone, zapoznaj się z sekcją Wyszukiwane hasła.
  • Operator określa warunek zapytania. Informacje o tym, których operatorów możesz używać w poszczególnych zapytaniach, znajdziesz w sekcji 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 wyszukiwanie w taki sposób, aby zwrócić wszystkie skróty do plików arkuszy kalkulacyjnych:

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