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 create w zasobie files bez parametrów.

Gdy utworzysz plik, metoda zwróci zasób files. 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.

Używanie parametru fields

Jeśli chcesz określić pola, które mają być zwracane w odpowiedzi, możesz ustawić fields parametr systemfields w dowolnej metodzie zasobu files. Jeśli pominiesz parametr fields, serwer zwróci domyślny zestaw pól specyficznych dla danej metody. Na przykład metoda list zwraca tylko pola kind, id, name, mimeType i resourceKey dla każdego pliku. Aby zwrócić inne pola, zobacz Zwracanie określonych pól.

Generowanie identyfikatorów do użycia w plikach

Metoda generateIds w zasobie files umożliwia wstępne generowanie unikalnych identyfikatorów plików, których można używać podczas tworzenia lub kopiowania plików i folderów na Dysku. Może to być przydatne, gdy chcesz kontrolować identyfikatory plików w aplikacji, zamiast pozwalać Dyskowi na automatyczne przypisywanie ich.

Liczbę wygenerowanych identyfikatorów możesz ustawić za pomocą parametru zapytania count. Jeśli parametr count nie jest ustawiony, domyślnie zwracanych jest 10 wyników. Maksymalna liczba identyfikatorów, o które możesz poprosić, to 1000.

Możesz też określić space, w których można używać identyfikatorów, oraz type produktów, w przypadku których można ich używać.

Po wygenerowaniu identyfikatora można go przekazać do metody create lub copy za pomocą pola id. Dzięki temu utworzony lub skopiowany plik będzie używać wstępnie określonego identyfikatora.

Jeśli plik zostanie utworzony lub skopiowany, kolejne próby zwrócą odpowiedź z kodem stanu HTTP 409 Conflict i nie zostaną utworzone zduplikowane pliki.

Pamiętaj, że wstępnie wygenerowane identyfikatory nie są obsługiwane w przypadku tworzenia plików Google Workspace, z wyjątkiem application/vnd.google-apps.drive-sdki application/vnd.google-apps.folder typów MIME. Podobnie nie są obsługiwane przesyłane pliki, które odwołują się do konwersji na format pliku Google Workspace.

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ć wszelkie wymagane aktualizacje, użyj metody copy w zasobie files. Aby znaleźć znak fileId do skopiowania, użyj metody list.

Aktualizacje możesz stosować za pomocą semantyki poprawek, co oznacza, że możesz wprowadzać częściowe modyfikacje zasobu. W żądaniu musisz wyraźnie ustawić pola, które chcesz zmodyfikować. Pola, które nie są uwzględnione w żądaniu, zachowują swoje dotychczasowe wartości. Więcej informacji znajdziesz w artykule Praca z częściowymi zasobami.

Identyfikator skopiowanego pliku możesz ustawić wstępnie za pomocą metody generateIds. Więcej informacji znajdziesz w artykule Generowanie identyfikatorów do użycia w plikach.

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:

  • 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 zostanie określone, plik odziedziczy wszystkie wykrywalne foldery 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 copy utworzy plik o takiej samej nazwie jak oryginał.
    • Nadmierne korzystanie z copy może spowodować przekroczenie limitów interfejsu Drive API. Więcej informacji znajdziesz w sekcji Limity użytkowania.

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