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ż „celem”.

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

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

  • 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 tych lokalizacji.

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

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

  • Typ MIME skrótu może się zdezaktualizować. Chociaż rzadko, typ MIME pliku blob zmienia się, gdy prześlesz wersję innego typu, ale wszystkie skróty wskazujące na 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. Skrót nadal będzie jednak miał miniaturę JPG.

  • W ramach eksportu danych z konta Google znanego też jako Google Takeout, skróty są reprezentowane jako pliki zakładek Netscape zawierające linki do celu.

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

Tworzenie skrótu

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 te elementy:

  • FILE_NAME: nazwa pliku, do którego ma prowadzić skrót.
  • SHORTCUT_NAME: nazwa tego skrótu.

Domyślnie skrót jest tworzony na 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 z files.list, aby odfiltrować skróty, które mają zostać zwrócone.

mimeType operator values

Gdzie:

  • query_term to wyszukiwane hasło lub pole, w którym ma być wyszukiwane. Aby wyświetlić hasła , których można użyć do filtrowania dysków współdzielonych, zapoznaj się z artykułem Hasła wyszukiwania.
  • operator określa warunek dla hasła. Aby sprawdzić, których operatorów możesz używać z poszczególnymi hasłami, zapoznaj się z artykułem Operatory zapytań.
  • values to konkretne wartości, których chcesz użyć do filtrowania wyników wyszukiwania.

Na przykład ten ciąg zapytania filtruje wyszukiwanie, 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'