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. Listy ACL skrótu nie można zmienić bezpośrednio.

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

• targetMimeType wskazujący typ MIME elementu docelowego. 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 skrótu można niezależnie zmienić tytuł skrótu i tytuł celu. Jeśli nazwa celu zostanie zmieniona, 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, ale wszystkie skróty wskazujące zaktualizowany plik zachowują oryginalny 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. 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 przy użyciu skrótów do 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 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:

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ć wyszukiwane hasła, których można używać do filtrowania dysków współdzielonych, zapoznaj się z wyszukiwanymi hasłami.
• 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'