camera.delete
Stay organized with collections
Save and categorize content based on your preferences.
Deletes a file given its URI. This command was modified in API level 2.
Parameters
- API level 1
- fileUri: URI of a file to delete. Manufacturers decide
whether to use absolute or relative URIs. Clients may treat this as an opaque
identifier.
- API level 2
- fileUrls: A list of absolute URLs for files to be deleted
from the camera, which were obtained previously, e.g. from
camera.listFiles
or camera.takePicture
commands. There are three special cases:
- The list only contains string “all”: delete all files in the camera.
- The list only contains string “image”: delete all images in the
camera.
- The list only contains string “video”: delete all videos in the
camera.
Results
- fileUrls: URLs of files that are not successfully deleted.
Please note this happens when all the URLs in fileUrls are valid but camera fails
to delete some of them. If any of the URLs is invalid, error code
invalidParameterValue
should be returned without deleting any file.
This was added in API level 2.
Errors
- missingParameter:
fileUri
not specified.
- invalidParameterName: The input parameter name is unrecognized.
- invalidParameterValue: The input parameter name is recognized,
but its value is invalid; for example, the
fileUri
doesn't
exist in API level 1 or any URL in fileUrls doesn't exist in API level 2.
Command I/O |
Command Input (API level 1) |
{
"parameters": {
"fileUri": "file URI"
}
} |
Command Output (API level 1) |
none |
Command Output (Error) (API level 1) |
{
"error": {
"code": "invalidParameterName",
"message": "Parameter XYZ is unrecognized."
}
} |
Command Input (API level 2) |
{
"parameters": {
"fileUrls": [
"url1",
"url2",
"url3",
...
"urln"
]
}
} |
Command Output (API level 2) |
{
"results": {
"fileUrls": [
"urln"
]
}
} |
Command Output (Error) (API level 2) |
{
"error": {
"code": "invalidParameterValue",
"message": "Parameter url3 doesn't exist."
}
} |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-09 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-10-09 UTC."],[[["\u003cp\u003eThe \u003ccode\u003edeleteFile\u003c/code\u003e command removes one or more files from the camera's storage.\u003c/p\u003e\n"],["\u003cp\u003eAPI level 1 uses \u003ccode\u003efileUri\u003c/code\u003e to specify a single file for deletion, while API level 2 uses \u003ccode\u003efileUrls\u003c/code\u003e to specify one or more files, or uses special values to delete all files, all images, or all videos.\u003c/p\u003e\n"],["\u003cp\u003eErrors are returned if parameters are missing, invalid, or if the specified files cannot be deleted.\u003c/p\u003e\n"],["\u003cp\u003eAPI level 2 introduced the \u003ccode\u003efileUrls\u003c/code\u003e parameter and the ability to return a list of unsuccessfully deleted files in the results.\u003c/p\u003e\n"]]],["This describes a command to delete files from a camera. In API level 1, it accepts a `fileUri` to delete a single file, where the URI's format is determined by the manufacturer. API level 2 was introduced to use the `fileUrls` parameter for multiple files, specified by absolute URLs. Special strings like \"all\", \"image\", or \"video\" delete all files, all images, or all videos. A list of `fileUrls` will return any files that did not delete correctly. Errors include invalid parameters or missing data.\n"],null,["# camera.delete\n\nDeletes a file given its URI. **This command was modified in API level 2.**\n\nParameters\n----------\n\n- **API level 1**\n - **fileUri:** URI of a file to delete. Manufacturers decide whether to use absolute or relative URIs. Clients may treat this as an opaque identifier.\n- **API level 2**\n - **fileUrls:** A list of absolute URLs for files to be deleted from the camera, which were obtained previously, e.g. from [camera.listFiles](/streetview/open-spherical-camera/reference/camera/listfiles) or [camera.takePicture](/streetview/open-spherical-camera/reference/camera/takepicture) commands. There are three special cases:\n - The list only contains string \"all\": delete all files in the camera.\n - The list only contains string \"image\": delete all images in the camera.\n - The list only contains string \"video\": delete all videos in the camera.\n\nResults\n-------\n\n- **fileUrls:** URLs of files that are not successfully deleted. Please note this happens when all the URLs in fileUrls are valid but camera fails to delete some of them. If any of the URLs is invalid, error code `invalidParameterValue` should be returned without deleting any file. **This was added in API level 2.**\n\nErrors\n------\n\n- **missingParameter:** `fileUri` not specified.\n- **invalidParameterName:** The input parameter name is unrecognized.\n- **invalidParameterValue:** The input parameter name is recognized, but its value is invalid; for example, the `fileUri` doesn't exist in API level 1 or any URL in fileUrls doesn't exist in API level 2.\n\n| Command I/O ----------- ||\n|------------------------------------------|----------------------------------------------------------------------------------------------------------|\n| **Command Input (API level 1)** | ```text { \"parameters\": { \"fileUri\": \"file URI\" } } ``` |\n| **Command Output (API level 1)** | ```text none ``` |\n| **Command Output (Error) (API level 1)** | ```text { \"error\": { \"code\": \"invalidParameterName\", \"message\": \"Parameter XYZ is unrecognized.\" } } ``` |\n| **Command Input (API level 2)** | ```text { \"parameters\": { \"fileUrls\": [ \"url1\", \"url2\", \"url3\", ... \"urln\" ] } } ``` |\n| **Command Output (API level 2)** | ```text { \"results\": { \"fileUrls\": [ \"urln\" ] } } ``` |\n| **Command Output (Error) (API level 2)** | ```text { \"error\": { \"code\": \"invalidParameterValue\", \"message\": \"Parameter url3 doesn't exist.\" } } ``` |"]]