package gapi-ocaml

  1. Overview
  2. Docs
Legend:
Library
Module
Module type
Parameter
Class
Class type
module Corpus : sig ... end
val copy : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?enforceSingleParent:bool -> ?ignoreDefaultVisibility:bool -> ?keepRevisionForever:bool -> ?supportsAllDrives:bool -> ?supportsTeamDrives:bool -> ?ocrLanguage:string -> fileId:string -> GapiDriveV3Model.File.t -> GapiConversation.Session.t -> GapiDriveV3Model.File.t * GapiConversation.Session.t

Creates a copy of a file and applies any requested updates with patch semantics.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter enforceSingleParent

    Set to true to opt in to API behavior that aims for all items to have exactly one parent. This parameter will only take effect if the item is not in a shared drive. Requests that specify more than one parent will fail.

  • parameter 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.

  • parameter 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.

  • parameter supportsAllDrives

    Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.

  • parameter supportsTeamDrives

    Deprecated use supportsAllDrives instead.

  • parameter ocrLanguage

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

  • parameter fileId

    The ID of the file.

val create : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?media_source:GapiMediaResource.t -> ?enforceSingleParent:bool -> ?ignoreDefaultVisibility:bool -> ?keepRevisionForever:bool -> ?supportsAllDrives:bool -> ?supportsTeamDrives:bool -> ?useContentAsIndexableText:bool -> ?ocrLanguage:string -> GapiDriveV3Model.File.t -> GapiConversation.Session.t -> GapiDriveV3Model.File.t * GapiConversation.Session.t

Creates a new file.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter enforceSingleParent

    Set to true to opt in to API behavior that aims for all items to have exactly one parent. This parameter will only take effect if the item is not in a shared drive. Requests that specify more than one parent will fail.

  • parameter 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.

  • parameter 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.

  • parameter supportsAllDrives

    Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.

  • parameter supportsTeamDrives

    Deprecated use supportsAllDrives instead.

  • parameter useContentAsIndexableText

    Whether to use the uploaded content as indexable text.

  • parameter ocrLanguage

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

val delete : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?supportsAllDrives:bool -> ?supportsTeamDrives:bool -> fileId:string -> GapiConversation.Session.t -> unit * GapiConversation.Session.t

Permanently deletes a file owned by the user without moving it to the trash. If the file belongs to a shared drive the user must be an organizer on the parent. If the target is a folder, all descendants owned by the user are also deleted.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter supportsAllDrives

    Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.

  • parameter supportsTeamDrives

    Deprecated use supportsAllDrives instead.

  • parameter fileId

    The ID of the file.

val emptyTrash : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> GapiConversation.Session.t -> unit * GapiConversation.Session.t

Permanently deletes all of the user's trashed files.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

val export : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?media_download:GapiMediaResource.download -> fileId:string -> mimeType:string -> GapiConversation.Session.t -> unit * GapiConversation.Session.t

Exports a Google Doc to the requested MIME type and returns the exported content. Please note that the exported content is limited to 10MB.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter fileId

    The ID of the file.

  • parameter mimeType

    The MIME type of the format requested for this export.

val generateIds : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?count:int -> ?space:string -> GapiConversation.Session.t -> GapiDriveV3Model.GeneratedIds.t * GapiConversation.Session.t

Generates a set of file IDs which can be provided in create or copy requests.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter count

    The number of IDs to return.

  • parameter space

    The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'.

val get : ?base_url:string -> ?etag:string -> ?std_params:GapiService.StandardParameters.t -> ?media_download:GapiMediaResource.download -> ?acknowledgeAbuse:bool -> ?supportsAllDrives:bool -> ?supportsTeamDrives:bool -> fileId:string -> GapiConversation.Session.t -> GapiDriveV3Model.File.t * GapiConversation.Session.t

Gets a file's metadata or content by ID.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter etag

    Optional ETag.

  • parameter std_params

    Optional standard parameters.

  • parameter acknowledgeAbuse

    Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.

  • parameter supportsAllDrives

    Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.

  • parameter supportsTeamDrives

    Deprecated use supportsAllDrives instead.

  • parameter fileId

    The ID of the file.

val list : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?includeItemsFromAllDrives:bool -> ?includeTeamDriveItems:bool -> ?pageSize:int -> ?spaces:string -> ?supportsAllDrives:bool -> ?supportsTeamDrives:bool -> ?corpora:string -> ?corpus:Corpus.t -> ?driveId:string -> ?orderBy:string -> ?pageToken:string -> ?q:string -> ?teamDriveId:string -> GapiConversation.Session.t -> GapiDriveV3Model.FileList.t * GapiConversation.Session.t

Lists or searches files.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter includeItemsFromAllDrives

    Deprecated - Whether both My Drive and shared drive items should be included in results. This parameter will only be effective until June 1, 2020. Afterwards shared drive items will be included in the results.

  • parameter includeTeamDriveItems

    Deprecated use includeItemsFromAllDrives instead.

  • parameter pageSize

    The maximum number of files to return per page. Partial or empty result pages are possible even before the end of the files list has been reached.

  • parameter spaces

    A comma-separated list of spaces to query within the corpus. Supported values are 'drive', 'appDataFolder' and 'photos'.

  • parameter supportsAllDrives

    Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.

  • parameter supportsTeamDrives

    Deprecated use supportsAllDrives instead.

  • parameter corpora

    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.

  • parameter corpus

    The source of files to list. Deprecated: use 'corpora' instead.

  • parameter driveId

    ID of the shared drive to search.

  • parameter orderBy

    A comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts ascending by default, but may be reversed with the 'desc' modifier. Example usage: ?orderBy=folder,modifiedTime desc,name. Please note that there is a current limitation for users with approximately one million files in which the requested sort order is ignored.

  • parameter pageToken

    The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.

  • parameter q

    A query for filtering the file results. See the "Search for Files" guide for supported syntax.

  • parameter teamDriveId

    Deprecated use driveId instead.

val update : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?media_source:GapiMediaResource.t -> ?enforceSingleParent:bool -> ?keepRevisionForever:bool -> ?supportsAllDrives:bool -> ?supportsTeamDrives:bool -> ?useContentAsIndexableText:bool -> ?addParents:string -> ?ocrLanguage:string -> ?removeParents:string -> fileId:string -> GapiDriveV3Model.File.t -> GapiConversation.Session.t -> GapiDriveV3Model.File.t * GapiConversation.Session.t

Updates a file's metadata and/or content with patch semantics.

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter enforceSingleParent

    Set to true to opt in to API behavior that aims for all items to have exactly one parent. This parameter will only take effect if the item is not in a shared drive. If the item's owner makes a request to add a single parent, the item will be removed from all current folders and placed in the requested folder. Other requests that increase the number of parents will fail, except when the canAddMyDriveParent file capability is true and a single parent is being added.

  • parameter 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.

  • parameter supportsAllDrives

    Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.

  • parameter supportsTeamDrives

    Deprecated use supportsAllDrives instead.

  • parameter useContentAsIndexableText

    Whether to use the uploaded content as indexable text.

  • parameter addParents

    A comma-separated list of parent IDs to add.

  • parameter ocrLanguage

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

  • parameter removeParents

    A comma-separated list of parent IDs to remove.

  • parameter fileId

    The ID of the file.

val watch : ?base_url:string -> ?std_params:GapiService.StandardParameters.t -> ?media_download:GapiMediaResource.download -> ?acknowledgeAbuse:bool -> ?supportsAllDrives:bool -> ?supportsTeamDrives:bool -> fileId:string -> GapiDriveV3Model.Channel.t -> GapiConversation.Session.t -> GapiDriveV3Model.Channel.t * GapiConversation.Session.t

Subscribes to changes to a file

  • parameter base_url

    Service endpoint base URL (defaults to "https://www.googleapis.com/drive/v3/").

  • parameter std_params

    Optional standard parameters.

  • parameter acknowledgeAbuse

    Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.

  • parameter supportsAllDrives

    Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.

  • parameter supportsTeamDrives

    Deprecated use supportsAllDrives instead.

  • parameter fileId

    The ID of the file.