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ść literalną */*. 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ą interfejsu files.insert muszą określić typ MIME application/vnd.google-apps.shortcut.

Aplikacje powinny określać rozszerzenie pliku we właściwości title podczas wstawiania plików za pomocą interfejsu API. Na przykład operacja wstawiania pliku JPEG powinna zawierać w metadanych coś w rodzaju "title": "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 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 jest niedostę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 pró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ą /upload identyfikatora URI, 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

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ą objęte ograniczeniami i wymagają oceny bezpieczeństwa, aby aplikacja mogła ich używać. Więcej informacji znajdziesz w przewodniku po autoryzacji.