Method: files.create

Tworzy nowy plik.

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

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

Uwaga: zamiast dosłownej wartości */* podaj prawidłowy typ MIME. Wartość dosłowna */* jest używana tylko do wskazania, że można przesłać dowolny prawidłowy typ MIME.

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

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

Podczas wstawiania plików za pomocą interfejsu API aplikacje powinny określać rozszerzenie pliku w właściwości name. Na przykład operacja wstawiania pliku JPEG powinna zawierać w metadanych wartość "name": "cat.jpg".

Kolejne żądania GET zawierają właściwości fileExtension tylko do odczytu wypełnione rozszerzeniem określonym pierwotnie we właściwości title. Gdy użytkownik Dysku Google poprosi o pobranie pliku lub gdy plik zostanie pobrany przez klienta synchronizacji, Dysk utworzy pełną nazwę pliku (z rozszerzeniem) na podstawie tytułu. Jeśli rozszerzenie jest nieobecne, Dysk próbuje je określić na podstawie typu MIME pliku.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
enforceSingleParent

boolean

Rola wycofana. Tworzenie plików w wielu folderach nie jest już obsługiwane.
ignoreDefaultVisibility

boolean

Określa, czy w przypadku utworzonego pliku mają być ignorowane domyślne ustawienia widoczności domeny. Administratorzy domeny mogą ustawić, aby wszystkie przesłane pliki były domyślnie widoczne w domenie. Ten parametr pozwala pominąć to ustawienie w przypadku żądania. Uprawnienia są nadal dziedziczone z folderów nadrzędnych.
keepRevisionForever

boolean

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

string

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

boolean

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

boolean

Wycofane: użyj w zastępstwie tego supportsAllDrives.
uploadType

string

Typ żądania przesyłania do identyfikatora URI /upload. Jeśli przesyłasz dane z identyfikatorem URI /upload, to pole jest wymagane. Jeśli tworzysz plik tylko z metadanymi, 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śl, czy przesłane treści mają być używane jako tekst możliwy do zindeksowania.
includePermissionsForView

string

Określa, które uprawnienia dodatkowego widoku należy uwzględnić w odpowiedzi. Obsługiwana jest tylko opcja „opublikowane”.
includeLabels

string

Lista identyfikatorów etykiet rozdzielona przecinkami, które mają być uwzględnione w sekcji 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 z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.