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. Element 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 z samymi metadanymi

Pliki zawierające tylko metadane nie zawierają treści. Metadane to dane (np. name, mimeType i createdTime) opisujące plik. Pola takie jak name są niezależne od użytkownika i wyglądają tak samo w przypadku każdego użytkownika, a pola takie jak viewedByMeTime zawierają wartości przeznaczone dla konkretnego 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 MIME application/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 Google Drive API.

Ograniczenia i uwagi

Przygotowując się do kopiowania plików, pamiętaj o tych ograniczeniach i kwestiach:

  • Uprawnienia:

    • Ograniczenie pliku copyRequiresWriterPermission określa, kto może go kopiować. Więcej informacji znajdziesz w artykule Blokowanie użytkownikom możliwości pobierania, drukowania i kopiowania pliku.
    • Pole capabilities/canCopy zasobu files określa, czy użytkownik może kopiować plik. Więcej informacji znajdziesz w artykule Możliwości.
    • 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ą replikowane. 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 oryginalnego 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. Potem możesz usunąć pierwotny folder źródłowy.
    • 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 artykule Limity wykorzystania.

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