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 . Plik otrzymuje kind o wartości drive.file, id, name o wartości „Bez tytułu” i mimeType z application/octet-stream. uploadType to oznaczone jako wymagane, ale domyślnie ustawiona jest wartość media, więc nie trzeba podawać .

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

Tworzenie plików z samymi metadanymi

Pliki z samymi metadanymi nie zawierają żadnych treści. Metadane to dane (np. name, mimeType i createdTime), który opisuje plik. Pola takie jak name są niezależne od użytkownika i wyglądają tak samo u każdego użytkownika, natomiast pola takie jak Pole viewedByMeTime zawiera wartości dla poszczególnych użytkowników.

Przykładem pliku zawierającego tylko metadane jest folder z typem MIME application/vnd.google-apps.folder Więcej informacji znajdziesz w artykule Tworzenie i uzupełnić foldery. Innym przykładem jest skrót, który wskazuje inny plik na Dysku z typem MIME application/vnd.google-apps.shortcut Więcej informacji znajdziesz w sekcji Tworzenie do pliku na Dysku.

Zarządzanie miniaturami

Miniatury pomagają użytkownikom identyfikować pliki na Dysku. Samochodem może automatycznie generować miniatury popularnych typów plików. Możesz też dodać obraz miniatury wygenerowany przez aplikację. Więcej informacji znajdziesz w artykule Przesyłanie miniatury.

Kopiowanie istniejącego pliku

Aby skopiować plik i zastosować wszelkie żądane aktualizacje, użyj files.copy. Aby znaleźć: fileId do kopiowania, użyj metody files.list.

Pamiętaj, że musisz użyć odpowiedniego interfejsu Drive API. zakresu, aby autoryzować . Więcej informacji o zakresach dotyczących Dysku znajdziesz w sekcji Wybierz Zakresy interfejsów API Dysku Google.

Ograniczenia i uwagi

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

  • Uprawnienia:

    • Ograniczenie dotyczące pliku copyRequiresWriterPermission określa, kto może to robić skopiuj plik. Więcej informacji znajdziesz w artykule Blokowanie użytkownikom możliwości pobieranie, drukowanie lub kopiowanie .
    • Pole capabilities/canCopy elementu Określa zasób files czy użytkownik może skopiować plik. Więcej informacji: Potencjał.
    • Użytkownik, który utworzył kopię, jest właścicielem skopiowanego pliku. Nie udostępniam żadnych innych treści a ustawienia z pliku źródłowego są replikowane. Jeśli kopia została utworzona w folderu udostępnionego, dziedziczy uprawnienia tego folderu.
    • Własność skopiowanego pliku może się zmienić, a kopia może nie dziedziczyć ustawienia udostępniania oryginalnego pliku. Może być konieczne .
  • Zarządzanie plikami:

    • Niektóre pliki, np. pliki innych firm na skróty, skopiowano.
    • Plik możesz skopiować tylko do jednego folderu nadrzędnego. Określanie wielu Rodzice nie są obsługiwani. Jeśli pole parents nie zostało określone, dziedziczy z pliku źródłowego wszystkie możliwe do znalezienia elementy nadrzędne.
    • Mimo że folder jest typem pliku, nie możesz skopiować folderu. Zamiast tego utwórz folder docelowy i ustaw pole parents folderu do folderu docelowego. Następnie możesz usunąć pierwotny folder źródłowy.
    • Jeśli nie podasz nowej nazwy pliku, metoda files.copy wygeneruje błąd o tej samej nazwie co oryginał.
    • Nadmierne korzystanie z files.copy może spowodować przekroczenie Limity interfejsu Drive API. Więcej informacji znajdziesz w sekcji Użycie .

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