Method: files.insert

Wstawia nowy plik.

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:*/*

Uwaga: podaj prawidłowy typ MIME, a nie wartość dosłowną */*. Literał */* jest używany 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 z pliku.

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

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

Kolejne żądania GET zawierają właściwość tylko do odczytu fileExtension wypełnioną rozszerzeniem pierwotnie określonym we właściwości title. Gdy użytkownik Dysku Google poprosi o pobranie pliku lub gdy plik zostanie pobrany za pomocą klienta synchronizacji, Dysk utworzy pełną nazwę pliku (z rozszerzeniem) na podstawie tytułu. 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/v2/files
  • Identyfikator URI metadanych w przypadku żądań dotyczących tylko metadanych:
    POST https://www.googleapis.com/drive/v2/files

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
convert

boolean

Określa, czy ten plik ma zostać przekonwertowany na odpowiedni format edytorów Dokumentów.
enforceSingleParent
(deprecated)

boolean

Wycofano: tworzenie plików w wielu folderach nie jest już obsługiwane.
ocr

boolean

Określa, czy należy spróbować przeprowadzić OCR w przypadku przesłanych plików .jpg, .png, .gif lub .pdf.
ocrLanguage

string

Jeśli ocr ma wartość true, podpowiada język, którego należy użyć. Prawidłowe wartości to kody BCP 47.
pinned

boolean

Określ, czy chcesz przypiąć główną wersję przesłanego pliku. Plik może mieć maksymalnie 200 przypiętych wersji.
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.
timedTextLanguage

string

Język tekstu synchronizowanego.
timedTextTrackName

string

Nazwa ścieżki z tekstem synchronizowanym.
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. To pole nie jest też widoczne w widżecie „Wypróbuj tę metodę”, ponieważ nie obsługuje on przesyłania danych.

Akceptowane wartości:
useContentAsIndexableText

boolean

Czy treść ma być używana jako tekst indeksowany.
visibility

enum (Visibility)

Widoczność nowego pliku. Uprawnienia są nadal dziedziczone z folderów nadrzędnych. Ten parametr jest istotny tylko wtedy, gdy convert=false.
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/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • 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.