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 obiektu nadrzędnego. Nie można bezpośrednio zmienić listy ACL skrótu.

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

• targetMimeType wskazujący typ MIME celu. Wartość targetMimeType służy do określenia wyświetlanej ikony typu. Podczas tworzenia skrótu typ MIME celu jest kopiowany do pola targetMimeType.

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

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

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

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

• Typ MIME skrótu może się zdezaktualizować. Chociaż rzadko się to zdarza, typ MIME pliku blob może się zmienić, gdy przesłana zostanie wersja pliku o innym typie. Jednak skróty odwołujące się do zaktualizowanego pliku zachowają pierwotny typ MIME. Jeśli na przykład prześlesz na Dysk plik JPG, a potem nową wersję tego pliku w formacie AVI, Dysk wykryje zmianę i zaktualizuje miniaturę rzeczywistego pliku. Jednak skrót nadal ma miniaturę w formacie 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, a targetId na plik lub folder, do którego ma on się odwoływać, i wywołaj files.create, aby utworzyć skrót.

Poniższe przykłady pokazują, jak utworzyć skrót za pomocą biblioteki klienta:

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')))

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 dysku Moje Dysk bieżącego użytkownika. Skróty są tworzone tylko w przypadku 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 do zwrócenia.

mimeType operator values

Gdzie:

• query_term to hasło lub pole, w których mają być przeprowadzane wyszukiwania. Aby wyświetlić zapytania, których można używać do filtrowania dysków współdzielonych, zapoznaj się z artykułem Terminy zapytań wyszukiwania.
• operator określa warunek dla wyrażenia zapytania. Aby sprawdzić, których operatorów możesz używać z poszczególnymi terminami zapytań, zapoznaj się z artykułem 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 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'