WOLFRAM

Wolfram Language & System Documentation Center

"Dropbox" (Service Connection)

Connect your Dropbox account to the Wolfram Language to read and write files in your Dropbox file directory.

Connecting & Authenticating

ServiceConnect["Dropbox"] creates a connection to the Dropbox API. If a previously saved connection can be found, it will be used; otherwise, a new authentication request will be launched.
Use DataConnectionObject to directly import files from "Dropbox".
Use of this connection requires internet access and a Dropbox account.

Requests

ServiceExecute["Dropbox","request",params] sends a request to the Dropbox API, using parameters params. The following give possible requests.

User Data

"UserData" — data about the authenticated user's account

Search

"FileSearch" — search file names within a directory

Parameters:
  • "Query"(required)query string
    "Path""/"directory to search

    • Uploading

    "Upload" — add or update the contents of a file

    "Put" — put a Wolfram Language expression in a file

    Parameters:
  • "File"(required for Upload)file path or File[...]
    "Expression"(required for Put)Wolfram Language expression
    "Path"(required)path in dropbox account
    "Mode""Add"write mode ("Add", "Overwrite" or "Update")
    "Autorename"Truerename if there is a name conflict

    • Downloading

    "Download" — download a file

    "Get" — get a Wolfram Language expression from a file

    "FileContents" — get the raw contents of a file as a byte array

    Parameters:
  • "Path"(required)path in dropbox account
    "Destination"$TemporaryDirectorypath to download the file

    • Files and Directories

    "FileNames" — list the files in a directory

    "FileData" — file metadata

    "DirectoryData" — directory metadata

    "DeleteFile" — delete a file

    "CreateDirectory" — create a directory

    "DeleteDirectory" — delete a directory

    Parameters:
  • "Path"(required)path in dropbox account
    "Recursive"Falsewhether to recursively list files in a directory

    • Examples

    open all close all

    Basic Examples  (2)

    Create a new connection to your Dropbox account:

    Wolfram Language code: dropbox = ServiceConnect["Dropbox"]

    Store a file:

    Wolfram Language code: dropbox["Upload", <|"Path" -> "/WolframData/test.csv", "File" -> "test.csv"|>]

    Retrieve the file and save it to the temporary folder:

    Wolfram Language code: dropbox["Download", "Path" -> "/WolframData/test.csv"]

    Store an expression:

    Wolfram Language code: expr = DSolve[y'[x] + y[x] == a Sin[x], y[x], x]
    Wolfram Language code: ServiceExecute["Dropbox", "Put", <|"Path" -> "/WolframData/rawexpr.txt", "Expression" -> expr|>]

    Get the expression:

    Wolfram Language code: fromDropbox = ServiceExecute["Dropbox", "Get", <|"Path" -> "/WolframData/rawexpr.txt"|>]

    The expression is returned as it is:

    Wolfram Language code: fromDropbox === expr

    Scope  (1)

    Create a plot to store in Dropbox:

    Wolfram Language code: sinplot = Plot[Sin[4 x], {x, -2 Pi, 2Pi}]

    Store the plot as an image:

    Wolfram Language code: ServiceExecute["Dropbox", "Put", <|"Path" -> "/WolframGraphics/sinplot.jpg", "Expression" -> sinplot, "Autorename" -> True|>]

    Verify that the file exists:

    Wolfram Language code: ServiceExecute["Dropbox", "FileNames", <|"Path" -> "/WolframGraphics"|>]

    Retrieve the metadata for the file:

    Wolfram Language code: ServiceExecute["Dropbox", "FileData", <|"Path" -> "/WolframGraphics/sinplot.jpg"|>]

    Get the plot from a file:

    Wolfram Language code: ServiceExecute["Dropbox", "Get", <|"Path" -> "/WolframGraphics/sinplot.jpg"|>]