Drive.Files.Create (Google Drive API v3-rev20230822-2.0.0)

java.lang.Object
- java.util.AbstractMap<String,Object>
- - com.google.api.client.util.GenericData
  - - com.google.api.client.googleapis.services.AbstractGoogleClientRequest<T>
    - - com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest<T>
      - com.google.api.services.drive.DriveRequest<File>
        
        com.google.api.services.drive.Drive.Files.Create

All Implemented Interfaces:

Cloneable, Map<String,Object>

Enclosing class:

Drive.Files
```
public class Drive.Files.Create
extends DriveRequest<File>
```

Nested Class Summary
- Nested classes/interfaces inherited from class com.google.api.client.util.GenericData
  com.google.api.client.util.GenericData.Flags
- Nested classes/interfaces inherited from class java.util.AbstractMap
  AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
- Nested classes/interfaces inherited from interface java.util.Map
  Map.Entry<K,V>

Field Summary
- Fields inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest
  USER_AGENT_SUFFIX

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`Create(File content)` Creates a new file.
`protected`	`Create(File content, com.google.api.client.http.AbstractInputStreamContent mediaContent)` Creates a new file.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Boolean`	`getEnforceSingleParent()` Deprecated.
`Boolean`	`getIgnoreDefaultVisibility()` Whether to ignore the domain's default visibility settings for the created file.
`String`	`getIncludeLabels()` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
`String`	`getIncludePermissionsForView()` Specifies which additional view's permissions to include in the response.
`Boolean`	`getKeepRevisionForever()` Whether to set the 'keepForever' field in the new head revision.
`String`	`getOcrLanguage()` A language hint for OCR processing during image import (ISO 639-1 code).
`Boolean`	`getSupportsAllDrives()` Whether the requesting application supports both My Drives and shared drives.
`Boolean`	`getSupportsTeamDrives()` Deprecated: Use `supportsAllDrives` instead.
`Boolean`	`getUseContentAsIndexableText()` Whether to use the uploaded content as indexable text.
`boolean`	`isEnforceSingleParent()` Convenience method that returns only `Boolean.TRUE` or `Boolean.FALSE`.
`boolean`	`isIgnoreDefaultVisibility()` Convenience method that returns only `Boolean.TRUE` or `Boolean.FALSE`.
`boolean`	`isKeepRevisionForever()` Convenience method that returns only `Boolean.TRUE` or `Boolean.FALSE`.
`boolean`	`isSupportsAllDrives()` Convenience method that returns only `Boolean.TRUE` or `Boolean.FALSE`.
`boolean`	`isSupportsTeamDrives()` Convenience method that returns only `Boolean.TRUE` or `Boolean.FALSE`.
`boolean`	`isUseContentAsIndexableText()` Convenience method that returns only `Boolean.TRUE` or `Boolean.FALSE`.
`Drive.Files.Create`	`set(String parameterName, Object value)`
`Drive.Files.Create`	`set$Xgafv(String $Xgafv)` V1 error format.
`Drive.Files.Create`	`setAccessToken(String accessToken)` OAuth access token.
`Drive.Files.Create`	`setAlt(String alt)` Data format for response.
`Drive.Files.Create`	`setCallback(String callback)` JSONP
`Drive.Files.Create`	`setEnforceSingleParent(Boolean enforceSingleParent)` Deprecated.
`Drive.Files.Create`	`setFields(String fields)` Selector specifying which fields to include in a partial response.
`Drive.Files.Create`	`setIgnoreDefaultVisibility(Boolean ignoreDefaultVisibility)` Whether to ignore the domain's default visibility settings for the created file.
`Drive.Files.Create`	`setIncludeLabels(String includeLabels)` A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
`Drive.Files.Create`	`setIncludePermissionsForView(String includePermissionsForView)` Specifies which additional view's permissions to include in the response.
`Drive.Files.Create`	`setKeepRevisionForever(Boolean keepRevisionForever)` Whether to set the 'keepForever' field in the new head revision.
`Drive.Files.Create`	`setKey(String key)` API key.
`Drive.Files.Create`	`setOauthToken(String oauthToken)` OAuth 2.0 token for the current user.
`Drive.Files.Create`	`setOcrLanguage(String ocrLanguage)` A language hint for OCR processing during image import (ISO 639-1 code).
`Drive.Files.Create`	`setPrettyPrint(Boolean prettyPrint)` Returns response with indentations and line breaks.
`Drive.Files.Create`	`setQuotaUser(String quotaUser)` Available to use for quota purposes for server-side applications.
`Drive.Files.Create`	`setSupportsAllDrives(Boolean supportsAllDrives)` Whether the requesting application supports both My Drives and shared drives.
`Drive.Files.Create`	`setSupportsTeamDrives(Boolean supportsTeamDrives)` Deprecated: Use `supportsAllDrives` instead.
`Drive.Files.Create`	`setUploadProtocol(String uploadProtocol)` Upload protocol for media (e.g.
`Drive.Files.Create`	`setUploadType(String uploadType)` Legacy upload protocol for media (e.g.
`Drive.Files.Create`	`setUseContentAsIndexableText(Boolean useContentAsIndexableText)` Whether to use the uploaded content as indexable text.

Methods inherited from class com.google.api.services.drive.DriveRequest
get$Xgafv, getAbstractGoogleClient, getAccessToken, getAlt, getCallback, getFields, getKey, getOauthToken, getPrettyPrint, getQuotaUser, getUploadProtocol, getUploadType, setDisableGZipContent, setRequestHeaders

Methods inherited from class com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest
getJsonContent, newExceptionOnError, queue

Methods inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest
buildHttpRequest, buildHttpRequestUrl, buildHttpRequestUsingHead, checkRequiredParameter, execute, executeAndDownloadTo, executeAsInputStream, executeMedia, executeMediaAndDownloadTo, executeMediaAsInputStream, executeUnparsed, executeUsingHead, getDisableGZipContent, getHttpContent, getLastResponseHeaders, getLastStatusCode, getLastStatusMessage, getMediaHttpDownloader, getMediaHttpUploader, getRequestHeaders, getRequestMethod, getResponseClass, getReturnRawInputSteam, getUriTemplate, initializeMediaDownload, initializeMediaUpload, queue, setReturnRawInputStream

Methods inherited from class com.google.api.client.util.GenericData
clone, entrySet, equals, get, getClassInfo, getUnknownKeys, hashCode, put, putAll, remove, setUnknownKeys, toString

Methods inherited from class java.util.AbstractMap
clear, containsKey, containsValue, isEmpty, keySet, size, values

Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Constructor Detail
  - Create
```
protected Create(File content)
```
    Creates a new file. This method supports an upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*` Note: Specify a valid MIME type, rather than the literal `*` value. The literal `*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/drive/api/guides/manage-uploads). Apps creating shortcuts with `files.create` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `"name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `title` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the title. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type. Create a request for the method "files.create". This request holds the parameters needed by the the drive server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    Drive.initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest) must be called to initialize this instance immediately after invoking the constructor.
    
    Parameters:
    
    content - the File
    
    Since:
    
    1.13
  - Create
```
protected Create(File content,
                 com.google.api.client.http.AbstractInputStreamContent mediaContent)
```
    Creates a new file. This method supports an upload* URI and accepts uploaded media with the following characteristics: - *Maximum file size:* 5,120 GB - *Accepted Media MIME types:*`*` Note: Specify a valid MIME type, rather than the literal `*` value. The literal `*` is only used to indicate that any valid MIME type can be uploaded. For more information on uploading files, see [Upload file data](/drive/api/guides/manage-uploads). Apps creating shortcuts with `files.create` must specify the MIME type `application/vnd.google-apps.shortcut`. Apps should specify a file extension in the `name` property when inserting files with the API. For example, an operation to insert a JPEG file should specify something like `"name": "cat.jpg"` in the metadata. Subsequent `GET` requests include the read-only `fileExtension` property populated with the extension originally specified in the `title` property. When a Google Drive user requests to download a file, or when the file is downloaded through the sync client, Drive builds a full filename (with extension) based on the title. In cases where the extension is missing, Drive attempts to determine the extension based on the file's MIME type. Create a request for the method "files.create". This request holds the parameters needed by the the drive server. After setting any optional parameters, call the AbstractGoogleClientRequest.execute() method to invoke the remote operation.
    Drive.initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest) must be called to initialize this instance immediately after invoking the constructor.
    
    This constructor should be used for uploading media content.
    
    Parameters:
    
    content - the File media metadata or null if none
    
    mediaContent - The media HTTP content or null if none.
    
    Since:
    
    1.13
- Method Detail
  - set$Xgafv
```
public Drive.Files.Create set$Xgafv(String $Xgafv)
```
    Description copied from class: DriveRequest
    
    V1 error format.
    
    Overrides:
    
    set$Xgafv in class DriveRequest<File>
  - setAccessToken
```
public Drive.Files.Create setAccessToken(String accessToken)
```
    Description copied from class: DriveRequest
    
    OAuth access token.
    
    Overrides:
    
    setAccessToken in class DriveRequest<File>
  - setAlt
```
public Drive.Files.Create setAlt(String alt)
```
    Description copied from class: DriveRequest
    
    Data format for response.
    
    Overrides:
    
    setAlt in class DriveRequest<File>
  - setCallback
```
public Drive.Files.Create setCallback(String callback)
```
    Description copied from class: DriveRequest
    
    JSONP
    
    Overrides:
    
    setCallback in class DriveRequest<File>
  - setFields
```
public Drive.Files.Create setFields(String fields)
```
    Description copied from class: DriveRequest
    
    Selector specifying which fields to include in a partial response.
    
    Overrides:
    
    setFields in class DriveRequest<File>
  - setKey
```
public Drive.Files.Create setKey(String key)
```
    Description copied from class: DriveRequest
    
    API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.
    
    Overrides:
    
    setKey in class DriveRequest<File>
  - setOauthToken
```
public Drive.Files.Create setOauthToken(String oauthToken)
```
    Description copied from class: DriveRequest
    
    OAuth 2.0 token for the current user.
    
    Overrides:
    
    setOauthToken in class DriveRequest<File>
  - setPrettyPrint
```
public Drive.Files.Create setPrettyPrint(Boolean prettyPrint)
```
    Description copied from class: DriveRequest
    
    Returns response with indentations and line breaks.
    
    Overrides:
    
    setPrettyPrint in class DriveRequest<File>
  - setQuotaUser
```
public Drive.Files.Create setQuotaUser(String quotaUser)
```
    Description copied from class: DriveRequest
    
    Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.
    
    Overrides:
    
    setQuotaUser in class DriveRequest<File>
  - setUploadType
```
public Drive.Files.Create setUploadType(String uploadType)
```
    Description copied from class: DriveRequest
    
    Legacy upload protocol for media (e.g. "media", "multipart").
    
    Overrides:
    
    setUploadType in class DriveRequest<File>
  - setUploadProtocol
```
public Drive.Files.Create setUploadProtocol(String uploadProtocol)
```
    Description copied from class: DriveRequest
    
    Upload protocol for media (e.g. "raw", "multipart").
    
    Overrides:
    
    setUploadProtocol in class DriveRequest<File>
  - getEnforceSingleParent
```
public Boolean getEnforceSingleParent()
```
    Deprecated. Creating files in multiple folders is no longer supported. [default: false]
  - setEnforceSingleParent
```
public Drive.Files.Create setEnforceSingleParent(Boolean enforceSingleParent)
```
    Deprecated. Creating files in multiple folders is no longer supported.
  - isEnforceSingleParent
```
public boolean isEnforceSingleParent()
```
    Convenience method that returns only Boolean.TRUE or Boolean.FALSE.
    Boolean properties can have four possible values: null, Data.NULL_BOOLEAN, Boolean.TRUE or Boolean.FALSE.
    
    This method returns Boolean.TRUE if the default of the property is Boolean.TRUE and it is null or Data.NULL_BOOLEAN. Boolean.FALSE is returned if the default of the property is Boolean.FALSE and it is null or Data.NULL_BOOLEAN.
    
    Deprecated. Creating files in multiple folders is no longer supported.
  - getIgnoreDefaultVisibility
```
public Boolean getIgnoreDefaultVisibility()
```
    Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders. [default: false]
  - setIgnoreDefaultVisibility
```
public Drive.Files.Create setIgnoreDefaultVisibility(Boolean ignoreDefaultVisibility)
```
    Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
  - isIgnoreDefaultVisibility
```
public boolean isIgnoreDefaultVisibility()
```
    Convenience method that returns only Boolean.TRUE or Boolean.FALSE.
    Boolean properties can have four possible values: null, Data.NULL_BOOLEAN, Boolean.TRUE or Boolean.FALSE.
    
    This method returns Boolean.TRUE if the default of the property is Boolean.TRUE and it is null or Data.NULL_BOOLEAN. Boolean.FALSE is returned if the default of the property is Boolean.FALSE and it is null or Data.NULL_BOOLEAN.
    
    Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.
  - getIncludeLabels
```
public String getIncludeLabels()
```
    A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
  - setIncludeLabels
```
public Drive.Files.Create setIncludeLabels(String includeLabels)
```
    A comma-separated list of IDs of labels to include in the `labelInfo` part of the response.
  - getIncludePermissionsForView
```
public String getIncludePermissionsForView()
```
    Specifies which additional view's permissions to include in the response. Only 'published' is supported.
  - setIncludePermissionsForView
```
public Drive.Files.Create setIncludePermissionsForView(String includePermissionsForView)
```
    Specifies which additional view's permissions to include in the response. Only 'published' is supported.
  - getKeepRevisionForever
```
public Boolean getKeepRevisionForever()
```
    Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions. [default: false]
  - setKeepRevisionForever
```
public Drive.Files.Create setKeepRevisionForever(Boolean keepRevisionForever)
```
    Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
  - isKeepRevisionForever
```
public boolean isKeepRevisionForever()
```
    Convenience method that returns only Boolean.TRUE or Boolean.FALSE.
    Boolean properties can have four possible values: null, Data.NULL_BOOLEAN, Boolean.TRUE or Boolean.FALSE.
    
    This method returns Boolean.TRUE if the default of the property is Boolean.TRUE and it is null or Data.NULL_BOOLEAN. Boolean.FALSE is returned if the default of the property is Boolean.FALSE and it is null or Data.NULL_BOOLEAN.
    
    Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Google Drive. Only 200 revisions for the file can be kept forever. If the limit is reached, try deleting pinned revisions.
  - getOcrLanguage
```
public String getOcrLanguage()
```
    A language hint for OCR processing during image import (ISO 639-1 code).
  - setOcrLanguage
```
public Drive.Files.Create setOcrLanguage(String ocrLanguage)
```
    A language hint for OCR processing during image import (ISO 639-1 code).
  - getSupportsAllDrives
```
public Boolean getSupportsAllDrives()
```
    Whether the requesting application supports both My Drives and shared drives. [default: false]
  - setSupportsAllDrives
```
public Drive.Files.Create setSupportsAllDrives(Boolean supportsAllDrives)
```
    Whether the requesting application supports both My Drives and shared drives.
  - isSupportsAllDrives
```
public boolean isSupportsAllDrives()
```
    Convenience method that returns only Boolean.TRUE or Boolean.FALSE.
    Boolean properties can have four possible values: null, Data.NULL_BOOLEAN, Boolean.TRUE or Boolean.FALSE.
    
    This method returns Boolean.TRUE if the default of the property is Boolean.TRUE and it is null or Data.NULL_BOOLEAN. Boolean.FALSE is returned if the default of the property is Boolean.FALSE and it is null or Data.NULL_BOOLEAN.
    
    Whether the requesting application supports both My Drives and shared drives.
  - getSupportsTeamDrives
```
public Boolean getSupportsTeamDrives()
```
    Deprecated: Use `supportsAllDrives` instead. [default: false]
  - setSupportsTeamDrives
```
public Drive.Files.Create setSupportsTeamDrives(Boolean supportsTeamDrives)
```
    Deprecated: Use `supportsAllDrives` instead.
  - isSupportsTeamDrives
```
public boolean isSupportsTeamDrives()
```
    Convenience method that returns only Boolean.TRUE or Boolean.FALSE.
    Boolean properties can have four possible values: null, Data.NULL_BOOLEAN, Boolean.TRUE or Boolean.FALSE.
    
    This method returns Boolean.TRUE if the default of the property is Boolean.TRUE and it is null or Data.NULL_BOOLEAN. Boolean.FALSE is returned if the default of the property is Boolean.FALSE and it is null or Data.NULL_BOOLEAN.
    
    Deprecated: Use `supportsAllDrives` instead.
  - getUseContentAsIndexableText
```
public Boolean getUseContentAsIndexableText()
```
    Whether to use the uploaded content as indexable text. [default: false]
  - setUseContentAsIndexableText
```
public Drive.Files.Create setUseContentAsIndexableText(Boolean useContentAsIndexableText)
```
    Whether to use the uploaded content as indexable text.
  - isUseContentAsIndexableText
```
public boolean isUseContentAsIndexableText()
```
    Convenience method that returns only Boolean.TRUE or Boolean.FALSE.
    Boolean properties can have four possible values: null, Data.NULL_BOOLEAN, Boolean.TRUE or Boolean.FALSE.
    
    This method returns Boolean.TRUE if the default of the property is Boolean.TRUE and it is null or Data.NULL_BOOLEAN. Boolean.FALSE is returned if the default of the property is Boolean.FALSE and it is null or Data.NULL_BOOLEAN.
    
    Whether to use the uploaded content as indexable text.
  - set
```
public Drive.Files.Create set(String parameterName,
                              Object value)
```
    Overrides:
    
    set in class DriveRequest<File>

Class Drive.Files.Create

Nested Class Summary

Nested classes/interfaces inherited from class com.google.api.client.util.GenericData

Nested classes/interfaces inherited from class java.util.AbstractMap

Nested classes/interfaces inherited from interface java.util.Map

Field Summary

Fields inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest

Constructor Summary

Method Summary

Methods inherited from class com.google.api.services.drive.DriveRequest

Methods inherited from class com.google.api.client.googleapis.services.json.AbstractGoogleJsonClientRequest

Methods inherited from class com.google.api.client.googleapis.services.AbstractGoogleClientRequest

Methods inherited from class com.google.api.client.util.GenericData

Methods inherited from class java.util.AbstractMap

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Constructor Detail

Create

Create

Method Detail

set$Xgafv

setAccessToken

setAlt

setCallback

setFields

setKey

setOauthToken

setPrettyPrint

setQuotaUser

setUploadType

setUploadProtocol

getEnforceSingleParent

setEnforceSingleParent

isEnforceSingleParent

getIgnoreDefaultVisibility

setIgnoreDefaultVisibility

isIgnoreDefaultVisibility

getIncludeLabels

setIncludeLabels

getIncludePermissionsForView

setIncludePermissionsForView

getKeepRevisionForever

setKeepRevisionForever

isKeepRevisionForever

getOcrLanguage

setOcrLanguage

getSupportsAllDrives

setSupportsAllDrives

isSupportsAllDrives

getSupportsTeamDrives

setSupportsTeamDrives

isSupportsTeamDrives

getUseContentAsIndexableText

setUseContentAsIndexableText

isUseContentAsIndexableText

set