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
zasobufiles
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ń.
- Ograniczenie dotyczące pliku
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.
Powiązane artykuły
Oto kilka kolejnych rozwiązań, które możesz wypróbować:
Aby przesłać dane podczas tworzenia lub aktualizowania pliku, przeczytaj artykuł Przesyłanie danych pliku.
Aby dowiedzieć się, jak utworzyć plik w określonym folderze, przeczytaj sekcję Tworzenie pliku w określonym folderze.
Instrukcje pracy z metadanymi plików znajdziesz w artykule Zarządzanie metadanymi plików.
Aby dowiedzieć się, jak usunąć plik, przeczytaj artykuł Przenoszenie plików do kosza lub usuwanie ich.