Tworzenie plików i zarządzanie nimi

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

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 ma kind drive.file, id, name „Bez tytułu” i mimeType application/octet-stream. Parametr uploadType jest oznaczony jako wymagany, ale domyślnie ma wartość media, więc nie musisz go podawać.

Więcej informacji o ograniczeniach dotyczących plików na Dysku znajdziesz w artykule Limity 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 wyświetlają się tak samo dla każdego z nich, natomiast pola takie jak viewedByMeTime zawierają wartości specyficzne dla użytkownika.

Przykładem pliku zawierającego tylko metadane jest folder o typie MIMEapplication/vnd.google-apps.folder. Więcej informacji znajdziesz w artykule Tworzenie folderów i wypełnianie ich zawartością. Inny przykład to 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 identyfikować pliki na Dysku. Dysk może automatycznie generować miniatury popularnych typów plików. Możesz też przesłać obraz miniatury wygenerowany 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źć symbol fileId do skopiowania, użyj metody files.list.

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

Limity i kwestie do rozważenia

Podczas przygotowywania się do kopiowania plików pamiętaj o tych limitach i kwestiach:

  • Uprawnienia:

    • Obiekt DownloadRestrictionsMetadata zasobu files określa, kto może skopiować plik. Więcej informacji znajdziesz w artykule Uniemożliwianie użytkownikom pobierania, drukowania i kopiowania Twojego pliku.
    • Pole capabilities.canCopy określa, czy użytkownik może kopiować plik. Więcej informacji znajdziesz w artykule Omówienie możliwości plików.
    • Użytkownik, który utworzył kopię, jest właścicielem skopiowanego pliku. Ż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łasność skopiowanego pliku może ulec zmianie, a kopia może nie odziedziczyć ustawień udostępniania oryginalnego pliku. Te ustawienia mogą wymagać zresetowania.

  • Zarządzanie plikami:

    • Niektórych plików, np. skrótów do usług innych firm, nie można skopiować.
    • Plik możesz skopiować tylko do jednego folderu nadrzędnego. Określanie wielu elementów nadrzędnych nie jest obsługiwane. Jeśli pole parents nie jest określone, plik dziedziczy wszystkie wykrywalne elementy nadrzędne z pliku źródłowego.
    • Chociaż folder jest rodzajem pliku, nie można go skopiować. Zamiast tego utwórz folder docelowy i ustaw w nim pole parents istniejących plików. Następnie możesz usunąć oryginalny folder źródłowy.
    • Jeśli nie podasz nowej nazwy pliku, metoda files.copy utworzy plik o takiej samej nazwie jak oryginał.
    • Nadmierne korzystanie z files.copy może prowadzić do przekroczenia limitów interfejsu Drive API. Więcej informacji znajdziesz w sekcji Limity użytkowania.

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