Method: files.create

Tworzy plik. Więcej informacji znajdziesz w artykule Tworzenie plików i zarządzanie nimi.

Ta metoda obsługuje identyfikator URI /upload i akceptuje przesłane pliki multimedialne o tych cechach:

  • Maksymalny rozmiar pliku: 5120 GB
  • Akceptowane typy MIME multimediów: */*

    (Podaj prawidłowy typ MIME, a nie dosłowną wartość */*. Literał */* jest używany tylko po to, aby wskazać, że można przesłać dowolny prawidłowy typ MIME. Więcej informacji znajdziesz w artykule Obsługiwane typy MIME w Google Workspace i na Dysku Google.

Więcej informacji o przesyłaniu plików znajdziesz w artykule Przesyłanie danych z pliku.

Aplikacje tworzące skróty za pomocą metody create muszą określić typ MIME application/vnd.google-apps.shortcut.

Aplikacje powinny określać rozszerzenie pliku we właściwości name podczas wstawiania plików za pomocą interfejsu API. Na przykład operacja wstawienia pliku JPEG powinna zawierać w metadanych informację podobną do "name": "cat.jpg".

Kolejne żądania GET zawierają właściwość fileExtension tylko do odczytu, która jest wypełniona rozszerzeniem pierwotnie określonym we właściwości name. Gdy użytkownik Dysku Google prosi o pobranie pliku lub gdy plik jest pobierany za pomocą klienta synchronizacji, Dysk tworzy pełną nazwę pliku (z rozszerzeniem) na podstawie nazwy. Jeśli rozszerzenie nie jest dostępne, Dysk próbuje je określić na podstawie typu MIME pliku.

Żądanie HTTP

  • Identyfikator URI przesyłania w przypadku żądań przesyłania multimediów:
    POST https://www.googleapis.com/upload/drive/v3/files
  • Identyfikator URI metadanych w przypadku żądań dotyczących tylko metadanych:
    POST https://www.googleapis.com/drive/v3/files

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
enforceSingleParent
(deprecated)

boolean

Wycofane: tworzenie plików w wielu folderach nie jest już obsługiwane.
ignoreDefaultVisibility

boolean

Określa, czy zignorować domyślne ustawienia widoczności domeny w przypadku utworzonego pliku. Administratorzy domeny mogą domyślnie ustawić widoczność wszystkich przesłanych plików dla domeny. Ten parametr pomija to zachowanie w przypadku żądania. Uprawnienia są nadal dziedziczone z folderów nadrzędnych.
keepRevisionForever

boolean

Określa, czy w nowej wersji głównej ma być ustawione pole keepForever. Dotyczy to tylko plików z zawartością binarną na Dysku Google. Na zawsze można zachować tylko 200 wersji pliku. Jeśli limit zostanie osiągnięty, spróbuj usunąć przypięte wersje.
ocrLanguage

string

Wskazówka dotycząca języka na potrzeby przetwarzania OCR podczas importowania obrazu (kod ISO 639-1).
supportsAllDrives

boolean

Czy aplikacja wysyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone.
supportsTeamDrives
(deprecated)

boolean

Wycofana: zamiast niej używaj zasady supportsAllDrives.
uploadType

string

Typ żądania przesyłania do identyfikatora URI /upload. Jeśli przesyłasz dane za pomocą identyfikatora URI /upload, to pole jest wymagane. Jeśli tworzysz plik zawierający tylko metadane, to pole nie jest wymagane. Poza tym to pole nie jest widoczne w widżecie „Wypróbuj tę metodę”, ponieważ nie obsługuje on przesyłania danych.

Akceptowane wartości:
useContentAsIndexableText

boolean

Określa, czy przesłane treści mają być używane jako tekst indeksowany.
includePermissionsForView

string

Określa, które uprawnienia do dodatkowego widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość published.
includeLabels

string

Lista identyfikatorów etykiet rozdzielona przecinkami, które mają być uwzględnione w części labelInfo odpowiedzi.

Treść żądania

Treść żądania zawiera wystąpienie elementu File.

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu File.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

Niektóre zakresy są ograniczone i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.