Method: files.insert

Wstawia 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.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 w właściwości title. Na przykład operacja wstawiania pliku JPEG powinna zawierać w metadanych wartość "title": "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, na potrzeby żądań przesyłania multimediów:
    POST https://www.googleapis.com/upload/drive/v2/files
  • Identyfikator URI metadanych, w przypadku żądań tylko z metadanymi:
    POST https://www.googleapis.com/drive/v2/files

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
convert

boolean

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

boolean

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

boolean

Czy próbować przeprowadzić rozpoznawanie tekstu OCR w przypadku przesłanych plików w formacie .jpg, .png, .gif lub .pdf.
ocrLanguage

string

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

boolean

Określa, czy należy przypiąć najnowszą wersję przesłanego pliku. Plik może zawierać maksymalnie 200 przypiętych wersji.
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.
timedTextLanguage

string

Język napisów.
timedTextTrackName

string

Nazwa ścieżki napisów.
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

czy treść ma być używana jako tekst możliwy do zindeksowania;
visibility

enum (Visibility)

Widoczność nowego pliku. Ten parametr ma znaczenie tylko wtedy, gdy convert=false.
includePermissionsForView

string

Określa, które uprawnienia dodatkowego widoku należy uwzględnić w odpowiedzi. Obsługiwana jest tylko wartość published.
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/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 z nich korzystać. Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.