Ta strona została przetłumaczona przez Cloud Translation API.

Method: files.insert

Żądanie HTTP
Parametry zapytania
Treść żądania
Treść odpowiedzi
Zakresy autoryzacji
Wypróbuj

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: określ prawidłowy typ MIME, a nie literał */*. Literał */* służy tylko do wskazywania, że można przesłać dowolny prawidłowy typ MIME.

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

Aplikacje tworzące skróty za pomocą files.insert muszą mieć 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 określać w metadanych coś takiego jak "title": "cat.jpg".

Kolejne żądania GET zawierają właściwość fileExtension tylko do odczytu, w której znajduje się rozszerzenie określone pierwotnie we właściwości title. Gdy użytkownik Dysku Google poprosi o pobranie pliku lub gdy zostanie on pobrany przez klienta synchronizacji, Dysk utworzy na podstawie tytułu pełną nazwę pliku (z rozszerzeniem). Jeśli nie ma rozszerzenia, Dysk próbuje określić rozszerzenie na podstawie typu MIME pliku.

Żądanie HTTP

Identyfikator URI przesyłania dla żądań przesłania multimediów:
POST https://www.googleapis.com/upload/drive/v2/files
Identyfikator URI metadanych dla żądań tylko metadanych:
POST https://www.googleapis.com/drive/v2/files

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
`uploadType`	`string` Typ żądania przesłania do identyfikatora URI `/upload`. To pole jest wymagane, jeśli przesyłasz dane za pomocą identyfikatora URI `/upload`. 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ż widżet nie obsługuje przesyłania danych. Dopuszczalne wartości: `media` – Proste przesyłanie. Przesyłaj tylko multimedia, bez metadanych. `multipart` – przesyłanie wieloczęściowe. Prześlij zarówno multimedia, jak i ich metadane w jednym żądaniu. `resumable` – przesyłanie z możliwością wznowienia. Prześlij plik w sposób umożliwiający jego wznowienie, korzystając z serii co najmniej 2 żądań, z których pierwsze zawiera metadane.
`convert`	`boolean` Określa, czy ten plik ma być przekonwertowany na odpowiedni format edytorów Dokumentów.
`enforceSingleParent (deprecated)`	`boolean` Wycofane: tworzenie plików w wielu folderach nie jest już obsługiwane.
`ocr`	`boolean` Określa, czy ma zostać podjęta próba użycia OCR w przypadku plików .jpg, .png, .gif, czy .pdf.
`ocrLanguage`	`string` Jeśli ocr ma wartość true (prawda), wskazówki dotyczące języka, którego należy użyć. Prawidłowe wartości to kody BCP 47.
`pinned`	`boolean` Określa, czy ma być przypięta wersja nagłówka przesłanego pliku. Plik może zawierać maksymalnie 200 przypiętych wersji.
`supportsAllDrives`	`boolean` Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone.
`supportsTeamDrives (deprecated)`	`boolean` Wycofane: zamiast tego użyj elementu `supportsAllDrives`.
`timedTextLanguage`	`string` Język tekstu wskazywanego przez funkcję czasu.
`timedTextTrackName`	`string` Nazwa ścieżki tekstowej z licznikiem czasu.
`useContentAsIndexableText`	`boolean` Określa, czy treść ma być używana jako indeksowalny tekst.
`visibility`	`enum (Visibility)` Widoczność nowego pliku. Ten parametr ma znaczenie tylko wtedy, gdy conversion=false.
`includePermissionsForView`	`string` Określa, które dodatkowe uprawnienia do widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość `published`.
`includeLabels`	`string` Rozdzielona przecinkami lista identyfikatorów etykiet do uwzględnienia 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, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.