Tworzenie plików i zarządzanie nimi

Z tego przewodnika dowiesz się, jak tworzyć pliki na Dysku Google i nimi zarządzać.

Utwórz plik

Aby utworzyć na Dysku plik, który nie zawiera żadnych metadanych ani treści, użyj metody files.create() bez parametrów. Plik ma kind drive.file, id, name „Bez tytułu” i mimeType application/octet-stream. Parametr uploadType jest oznaczony jako wymagany, ale domyślnie ustawiony jest na media, więc nie musisz go podawać.

Więcej informacji o ograniczeniach dotyczących plików na Dysku znajdziesz w artykule Ograniczenia dotyczące plików i folderów.

Tworzenie plików zawierających tylko metadane

Pliki zawierające tylko metadane nie zawierają treści. Metadane to dane (takie jak name, mimeType i createdTime), które opisują plik. Pola takie jak name są niezależne od użytkownika i wyglądają tak samo dla każdego użytkownika, podczas gdy pola takie jak viewedByMeTime zawierają wartości specyficzne dla użytkownika.

Przykładem pliku zawierającego tylko metadane jest folder o typie MIME application/vnd.google-apps.folder. Więcej informacji znajdziesz w artykule Tworzenie i wypełnianie folderów. Innym przykładem jest skrót, który odwołuje się do innego pliku na Dysku i ma typ MIMEapplication/vnd.google-apps.shortcut. Więcej informacji znajdziesz w artykule Tworzenie skrótu do pliku na Dysku.

Zarządzanie miniaturami

Miniatury pomagają użytkownikom identyfikować pliki na Dysku. Drive może automatycznie generować miniatury typowych plików lub możesz przesłać miniaturę wygenerowaną przez aplikację. Więcej informacji znajdziesz w artykule Przesyłanie miniatur.

Kopiowanie istniejącego pliku

Aby skopiować plik i zastosować żądane aktualizacje, użyj metody files.copy(). Aby znaleźć fileId do skopiowania, użyj metody files.list().

Pamiętaj, że aby autoryzować wywołanie, musisz użyć odpowiedniego zakresu interfejsu Drive API. Więcej informacji o zakresach Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.

Ograniczenia i uwagi

Przygotowując się do kopiowania plików, weź pod uwagę te limity i ograniczenia:

  • Uprawnienia:

    • Ograniczenie pliku copyRequiresWriterPermission określa, kto może go kopiować. Więcej informacji znajdziesz w artykule Uniemożliwianie użytkownikom pobierania, drukowania i kopiowania Twojego pliku.
    • Pole capabilities/canCopy zasobu files określa, czy użytkownik może kopiować pliki. Więcej informacji znajdziesz w artykule Znajomość możliwości plików.
    • Plik, którego kopia została utworzona, należy do użytkownika, który utworzył kopię. Żadne inne ustawienia udostępniania z pliku źródłowego nie są powielane. Jeśli kopia jest tworzona w folderze udostępnionym, dziedziczy uprawnienia tego folderu.
    • Własność skopiowanego pliku może się zmienić, a kopia może nie odziedziczyć ustawień udostępniania pierwotnego pliku. Może być konieczne zresetowanie tych ustawień.

  • Zarządzanie plikami:

    • Niektórych plików, np. skrótów innych firm, nie można skopiować.
    • Plik możesz skopiować tylko do jednego folderu nadrzędnego. Podawanie wielu elementów nadrzędnych nie jest obsługiwane. Jeśli pole parents nie jest określone, plik dziedziczy wszystkie możliwe elementy nadrzędne z pliku źródłowego.
    • Folder jest typem pliku, ale nie można go kopiować. Zamiast tego utwórz folder docelowy i ustaw pole parents istniejących plików na folder docelowy. Następnie możesz usunąć folder ze źródłem danych.
    • Jeśli nie podasz nowej nazwy pliku, metoda files.copy() wygeneruje plik o tej samej nazwie co plik oryginalny.
    • Nadmierne korzystanie z interfejsu files.copy() może spowodować przekroczenie limitów interfejsu Drive API. Więcej informacji znajdziesz w sekcji Limity korzystania.

Oto kilka kolejnych kroków, które możesz wykonać: