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ą następujące cechy:

• Typ MIME: application/vnd.google-apps.shortcut. Więcej informacji znajdziesz w artykule Typy MIME obsługiwane przez Google Workspace i Dysk Google.

• Lista kontroli dostępu do skrótu dziedziczy listę kontroli dostępu (ACL) elementu 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. targetMimeType określa wyświetlaną ikonę typu. Typ MIME celu 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 1 element nadrzędny. Jeśli plik skrótu jest wymagany w innych lokalizacjach na Dysku, można go skopiować do dodatkowych lokalizacji.

• Po usunięciu celu lub gdy bieżący użytkownik utraci do niego dostęp, skrót użytkownika wskazujący przerwy w miejscu docelowym.

• Nazwa skrótu może się różnić od nazwy elementu docelowego. Po utworzeniu skrótu nazwa miejsca docelowego jest używana jako nazwa skrótu. Po utworzeniu skrótu można niezależnie zmienić tytuł skrótu i tytuł celu. Jeśli zmienisz nazwę miejsca docelowego, 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 plik JPG na Dysk, a potem prześlesz wersję AVI, Dysk rozpozna zmianę i zaktualizuje miniaturę rzeczywistego pliku. Skrót nadal ma miniaturę w formacie JPG.

• W narzędziu Eksport danych konta Google, nazywanym też Google Takeout, skróty są reprezentowane jako pliki zakładek Netscape zawierające linki do elementu 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, jako targetId ustaw plik lub folder, do którego powinien prowadzić skrót, a następnie 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 Moim dysku bieżącego użytkownika, a skróty są tworzone tylko dla plików lub 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 files.list w celu odfiltrowania skrótów do powrotu.

mimeType operator values

Gdzie:

• query_term to wyszukiwane hasło lub pole 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 wyszukiwanego hasła. Informacje o tym, których operatorów możesz używać z poszczególnymi hasłami w zapytaniu, znajdziesz w artykule 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, by zwracały wszystkie skróty do plików arkuszy kalkulacyjnych:

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