Reference

Endpoint Upload a file


Name

upload_file

Description

Uploads a file. If file exits it does not overwrite. If you like to overwrite existing file then use [Replace file data] endpoint. It requires FileId you like to replace. Get file id by calling list_parent_items or list_files endpoint (Search for file name and get id). Google API does not allow to perform create or replace in one operation. [API reference]

Related Tables

Files

Parameters

Parameter Required Options
Name: FileName

Label: Target FileName

A filename the file will have in Google Drive
YES
Name: DiskFilePath

Label: Local FilePath

Specify a disk file path
YES
Name: KeepRevisionForever

Label: Keep Revision Forever

Defines whether uploaded file has revisions
Option Value
true true
false false
Name: ParentFolderId

Label: Parent FolderId

Id of a parent folder you want to upload the file in. Use value 'root' to place the file in the topmost level.
Name: DriveId

Label: Shared DriveId

By default file lists from MyDrive but if you like to search other Shared drive then set this parameter.
Name: DriveType

Label: Drive Type

Default search context is User's drive. Bodies of items (files/documents) to which the query applies. Supported bodies are 'user', 'domain', 'drive', and 'allDrives'. Prefer 'user' or 'drive' to 'allDrives' for efficiency. By default, corpora is set to 'user'. However, this can change depending on the filter set through the 'Query' parameter.
Option Value
My Drive user
Shared Drive drive
Name: SupportsAllDrives

Label: Supports all drives (e.g. My and Shared)

Whether the requesting application supports both My Drives and shared drives.
Option Value
true true
false false
Name: AddParents

Label: AddParents

A comma-separated list of parent IDs to add
Name: ocrLanguage

Label: OcrLanguage

A language hint for OCR processing during image import (ISO 639-1 code).
Name: useContentAsIndexableText

Label: UseContentAsIndexableText

Whether to use the uploaded content as indexable text.

Output Columns

Label Data Type (SSIS) Data Type (SQL) Length Description
Id DT_WSTR nvarchar(440) 440
Kind DT_WSTR nvarchar(200) 200
Name DT_WSTR nvarchar(780) 780
MimeType DT_WSTR nvarchar(650) 650
FileSize DT_I8 bigint
DriveId DT_WSTR nvarchar(4000) 4000
If the column you are looking for is missing, consider customizing Google Drive Connector.

Input Columns

Label Data Type (SSIS) Data Type (SQL) Length Description
There are no Static columns defined for this endpoint. This endpoint detects columns dynamically at runtime.

Examples

SSIS

Use Google Drive Connector in API Source or in API Destination SSIS Data Flow components to read or write data.

API Source

API Source - Google Drive
Read / write Google Drive data inside your app; perform many Google Drive operations without coding, just using easy to use high performance API Connector for Google Drive
Google Drive
Upload a file
Required Parameters
Target FileName Fill-in the parameter...
Local FilePath Fill-in the parameter...
Optional Parameters
Keep Revision Forever
Parent FolderId root
Shared DriveId
Drive Type user
Supports all drives (e.g. My and Shared) true
RawOutputDataRowTemplate {Status:'Uploaded'}
EnableRawOutputModeSingleRow True
AddParents
OcrLanguage
UseContentAsIndexableText False
SSIS API Source - Read from table or endpoint

API Destination

This Endpoint belongs to the Files table, therefore it is better to use it, instead of accessing the endpoint directly. Use this table and table-operation pair to upload a file:

API Destination - Google Drive
Read / write Google Drive data inside your app; perform many Google Drive operations without coding, just using easy to use high performance API Connector for Google Drive
Google Drive
Files
Insert
Required Parameters
Target FileName Fill-in the parameter...
Local FilePath Fill-in the parameter...
Optional Parameters
Keep Revision Forever
Parent FolderId root
Shared DriveId
Drive Type user
Supports all drives (e.g. My and Shared) true
RawOutputDataRowTemplate {Status:'Uploaded'}
EnableRawOutputModeSingleRow True
AddParents
OcrLanguage
UseContentAsIndexableText False
SSIS API Destination - Access table operation

ODBC application

Use these SQL queries in your ODBC application data source:

Upload a file with INSERT keyword

Upload a file with INSERT keyword. Advantage of INSERT is you can use Bulk option using SOURCE clause. This way you can upload many files

INSERT INTO Files
  WITH (FileName='My filename'
      ,DiskFilePath='C:\MyFolder\Mymyfile.ext'
      ,ParentFolderId='root'
	  )
  --You can get ParentFolderId by selecting from 'list_folders' endpoint or just use 'root'

upload_file endpoint belongs to Files table(s), and can therefore be used via those table(s).

SQL Server

Use these SQL queries in SQL Server after you create a data source in Data Gateway:

Upload a file with INSERT keyword

Upload a file with INSERT keyword. Advantage of INSERT is you can use Bulk option using SOURCE clause. This way you can upload many files

DECLARE @MyQuery NVARCHAR(MAX) = 'INSERT INTO Files
  WITH (FileName=''My filename''
      ,DiskFilePath=''C:\MyFolder\Mymyfile.ext''
      ,ParentFolderId=''root''
	  )
  --You can get ParentFolderId by selecting from ''list_folders'' endpoint or just use ''root''';

EXEC (@MyQuery) AT [LS_TO_GOOGLE_DRIVE_IN_GATEWAY];

upload_file endpoint belongs to Files table(s), and can therefore be used via those table(s).