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 metadanych ani treści, użyj metody files.create bez parametrów. Plik otrzyma kind z wartością drive.file, id, name o wartości „Bez tytułu” i mimeType o wartości application/octet-stream. Pole uploadType jest oznaczone jako wymagane, ale domyślnie przyjmuje wartość media, więc nie musisz go podawać.

Więcej informacji o limitach plików na Dysku znajdziesz w artykule Limity plików i folderów.

Tworzenie plików zawierających tylko metadane

Pliki zawierające tylko metadane nie zawierają żadnej treści. Metadane to dane (takie jak 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, natomiast pola takie jak viewedByMeTime zawierają wartości dotyczące 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 wskazuje inny plik na Dysku o typie 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 zidentyfikować pliki na Dysku. Dysk może automatycznie generować miniatury popularnych typów plików. Możesz też udostępnić 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 interfejsu Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.

Ograniczenia i uwagi

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

  • Uprawnienia:

    • Ograniczenie dotyczące pliku copyRequiresWriterPermission określa, kto może go skopiować. 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 skopiować plik. Więcej informacji znajdziesz w sekcji Możliwości.
    • Właścicielem skopiowanego pliku jest użytkownik, który utworzył kopię. Żadne inne ustawienia udostępniania z pliku źródłowego nie są replikowane. Jeśli kopia zostanie utworzona w folderze udostępnionym, odziedziczy uprawnienia tego folderu.
    • Właściciel skopiowanego pliku może się zmienić, a kopia może nie dziedziczyć ustawień udostępniania pierwotnego pliku. Konieczne może być 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 1 folderu nadrzędnego. Określanie wielu elementów nadrzędnych nie jest obsługiwane. Jeśli pole parents nie jest określone, plik odziedziczy wszystkie możliwe do znalezienia elementy nadrzędne z pliku źródłowego.
    • Mimo że folder jest typem pliku, nie możesz skopiować folderu. Zamiast tego utwórz folder docelowy i w polu parents istniejących plików ustaw folder docelowy. Następnie możesz usunąć pierwotny folder źródłowy.
    • Jeśli nie określisz nowej nazwy pliku, metoda files.copy wygeneruje plik o tej samej nazwie co oryginał.
    • Nadmierne korzystanie z tagu files.copy może spowodować przekroczenie limitów interfejsu Drive API. Więcej informacji znajdziesz w sekcji Limity wykorzystania.

Oto kilka kolejnych rozwiązań, które możesz wypróbować: