public class Api
extends java.lang.Object
| Modifier and Type | Class and Description |
|---|---|
static class |
Api.HttpMethod |
| Modifier and Type | Field and Description |
|---|---|
Cloudinary |
cloudinary |
static java.util.Map<java.lang.Integer,java.lang.Class<? extends java.lang.Exception>> |
CLOUDINARY_API_ERROR_CLASSES |
| Constructor and Description |
|---|
Api(Cloudinary cloudinary,
AbstractApiStrategy strategy) |
| Modifier and Type | Method and Description |
|---|---|
ApiResponse |
addMetadataField(MetadataField field)
Add a new metadata field definition
|
ApiResponse |
addMetadataRule(MetadataRule rule,
java.util.Map options) |
ApiResponse |
analyze(java.lang.String inputType,
java.lang.String analysisType,
java.lang.String uri,
java.util.Map options) |
protected ApiResponse |
callApi(Api.HttpMethod method,
java.lang.Iterable<java.lang.String> uri,
java.util.Map<java.lang.String,? extends java.lang.Object> params,
java.util.Map options) |
ApiResponse |
configuration(java.util.Map options) |
protected java.lang.String |
createApiUrl(java.lang.Iterable<java.lang.String> uri,
java.util.Map options) |
ApiResponse |
createFolder(java.lang.String folderName,
java.util.Map options) |
ApiResponse |
createStreamingProfile(java.lang.String name,
java.lang.String displayName,
java.util.List<java.util.Map> representations) |
ApiResponse |
createStreamingProfile(java.lang.String name,
java.lang.String displayName,
java.util.List<java.util.Map> representations,
java.util.Map options)
Create a new streaming profile
|
ApiResponse |
createTransformation(java.lang.String name,
java.lang.String definition,
java.util.Map options) |
ApiResponse |
createUploadMapping(java.lang.String name,
java.util.Map options) |
ApiResponse |
createUploadPreset(java.util.Map options) |
ApiResponse |
deleteAllResources(java.util.Map options) |
ApiResponse |
deleteBackedUpAssets(java.lang.String assetId,
java.lang.String[] versionIds,
java.util.Map options) |
ApiResponse |
deleteDatasourceEntries(java.lang.String fieldExternalId,
java.util.List<java.lang.String> entriesExternalId)
Delete data source entries for a given field
|
ApiResponse |
deleteDerivedByTransformation(java.lang.Iterable<java.lang.String> publicIds,
java.util.List<Transformation> transformations,
java.util.Map options) |
ApiResponse |
deleteDerivedResources(java.lang.Iterable<java.lang.String> derivedResourceIds,
java.util.Map options) |
ApiResponse |
deleteFolder(java.lang.String folder,
java.util.Map options)
Delete a folder (must be empty).
|
ApiResponse |
deleteMetadataField(java.lang.String fieldExternalId)
Delete a field definition.
|
ApiResponse |
deleteMetadataRule(java.lang.String externalId,
java.util.Map options) |
ApiResponse |
deleteResources(java.lang.Iterable<java.lang.String> publicIds,
java.util.Map options) |
ApiResponse |
deleteResourcesByPrefix(java.lang.String prefix,
java.util.Map options) |
ApiResponse |
deleteResourcesByTag(java.lang.String tag,
java.util.Map options) |
ApiResponse |
deleteStreamingProfile(java.lang.String name) |
ApiResponse |
deleteStreamingProfile(java.lang.String name,
java.util.Map options)
Delete a streaming profile information.
|
ApiResponse |
deleteTransformation(java.lang.String transformation,
java.util.Map options) |
ApiResponse |
deleteUploadMapping(java.lang.String name,
java.util.Map options) |
ApiResponse |
deleteUploadPreset(java.lang.String name,
java.util.Map options) |
protected java.lang.String |
getAuthorizationHeaderValue(java.lang.String apiKey,
java.lang.String apiSecret,
java.lang.String oauthToken) |
AbstractApiStrategy |
getStrategy() |
ApiResponse |
getStreamingProfile(java.lang.String name) |
ApiResponse |
getStreamingProfile(java.lang.String name,
java.util.Map options)
Get a streaming profile information
|
ApiResponse |
listMetadataFields()
List all the metadata field definitions (structure, not values)
|
ApiResponse |
listMetadataRules(java.util.Map options) |
ApiResponse |
listStreamingProfiles() |
ApiResponse |
listStreamingProfiles(java.util.Map options)
List Streaming profiles
|
ApiResponse |
metadataFieldByFieldId(java.lang.String fieldExternalId)
Get a metadata field definition by id
|
ApiResponse |
ping(java.util.Map options) |
ApiResponse |
publishByIds(java.lang.Iterable<java.lang.String> publicIds,
java.util.Map options) |
ApiResponse |
publishByPrefix(java.lang.String prefix,
java.util.Map options) |
ApiResponse |
publishByTag(java.lang.String tag,
java.util.Map options) |
ApiResponse |
renameFolder(java.lang.String path,
java.lang.String toPath,
java.util.Map options) |
ApiResponse |
reorderMetadataFields(java.lang.String orderBy,
java.lang.String direction,
java.util.Map options)
Reorders metadata fields.
|
ApiResponse |
resource(java.lang.String public_id,
java.util.Map options) |
ApiResponse |
resourceByAssetID(java.lang.String assetId,
java.util.Map options) |
ApiResponse |
resources(java.util.Map options) |
ApiResponse |
resourcesByAssetFolder(java.lang.String assetFolder,
java.util.Map options) |
ApiResponse |
resourcesByAssetIDs(java.lang.Iterable<java.lang.String> assetIds,
java.util.Map options) |
ApiResponse |
resourcesByContext(java.lang.String key,
java.util.Map options) |
ApiResponse |
resourcesByContext(java.lang.String key,
java.lang.String value,
java.util.Map options) |
ApiResponse |
resourcesByIds(java.lang.Iterable<java.lang.String> publicIds,
java.util.Map options) |
ApiResponse |
resourcesByModeration(java.lang.String kind,
java.lang.String status,
java.util.Map options) |
ApiResponse |
resourcesByTag(java.lang.String tag,
java.util.Map options) |
ApiResponse |
resourceTypes(java.util.Map options) |
ApiResponse |
restore(java.lang.Iterable<java.lang.String> publicIds,
java.util.Map options) |
ApiResponse |
restoreDatasourceEntries(java.lang.String fieldExternalId,
java.util.List<java.lang.String> entriesExternalId)
Restore deleted data source entries for a given field
|
ApiResponse |
rootFolders(java.util.Map options) |
ApiResponse |
subFolders(java.lang.String ofFolderPath,
java.util.Map options) |
ApiResponse |
tags(java.util.Map options) |
ApiResponse |
transformation(java.lang.String transformation,
java.util.Map options) |
ApiResponse |
transformations(java.util.Map options) |
ApiResponse |
update(java.lang.String public_id,
java.util.Map options) |
ApiResponse |
updateMetadataField(java.lang.String fieldExternalId,
MetadataField field)
Update the definitions of a single metadata field.
|
ApiResponse |
updateMetadataFieldDatasource(java.lang.String fieldExternalId,
java.util.List<MetadataDataSource.Entry> entries)
Update the datasource entries for a given field
|
ApiResponse |
updateMetadataRule(java.lang.String externalId,
MetadataRule rule,
java.util.Map options) |
ApiResponse |
updateResourcesAccessModeByIds(java.lang.String accessMode,
java.lang.Iterable<java.lang.String> publicIds,
java.util.Map options)
Update access mode of one or more resources by publicIds
|
ApiResponse |
updateResourcesAccessModeByPrefix(java.lang.String accessMode,
java.lang.String prefix,
java.util.Map options)
Update access mode of one or more resources by prefix
|
ApiResponse |
updateResourcesAccessModeByTag(java.lang.String accessMode,
java.lang.String tag,
java.util.Map options)
Update access mode of one or more resources by tag
|
ApiResponse |
updateStreamingProfile(java.lang.String name,
java.lang.String displayName,
java.util.List<java.util.Map> representations) |
ApiResponse |
updateStreamingProfile(java.lang.String name,
java.lang.String displayName,
java.util.List<java.util.Map> representations,
java.util.Map options)
Create a new streaming profile
|
ApiResponse |
updateTransformation(java.lang.String transformation,
java.util.Map updates,
java.util.Map options) |
ApiResponse |
updateUploadMapping(java.lang.String name,
java.util.Map options) |
ApiResponse |
updateUploadPreset(java.lang.String name,
java.util.Map options) |
ApiResponse |
uploadMapping(java.lang.String name,
java.util.Map options) |
ApiResponse |
uploadMappings(java.util.Map options) |
ApiResponse |
uploadPreset(java.lang.String name,
java.util.Map options) |
ApiResponse |
uploadPresets(java.util.Map options) |
ApiResponse |
usage(java.util.Map options) |
protected void |
validateAuthorization(java.lang.String apiKey,
java.lang.String apiSecret,
java.lang.String oauthToken) |
ApiResponse |
visualSearch(java.util.Map options) |
public static final java.util.Map<java.lang.Integer,java.lang.Class<? extends java.lang.Exception>> CLOUDINARY_API_ERROR_CLASSES
public final Cloudinary cloudinary
public Api(Cloudinary cloudinary, AbstractApiStrategy strategy)
public AbstractApiStrategy getStrategy()
protected ApiResponse callApi(Api.HttpMethod method, java.lang.Iterable<java.lang.String> uri, java.util.Map<java.lang.String,? extends java.lang.Object> params, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse ping(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse usage(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse configuration(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourceTypes(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resources(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse visualSearch(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourcesByTag(java.lang.String tag, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourcesByContext(java.lang.String key, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourcesByContext(java.lang.String key, java.lang.String value, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourceByAssetID(java.lang.String assetId, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourcesByAssetIDs(java.lang.Iterable<java.lang.String> assetIds, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourcesByAssetFolder(java.lang.String assetFolder, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourcesByIds(java.lang.Iterable<java.lang.String> publicIds, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resourcesByModeration(java.lang.String kind, java.lang.String status, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse resource(java.lang.String public_id, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse update(java.lang.String public_id, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteResources(java.lang.Iterable<java.lang.String> publicIds, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteDerivedByTransformation(java.lang.Iterable<java.lang.String> publicIds, java.util.List<Transformation> transformations, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteResourcesByPrefix(java.lang.String prefix, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteResourcesByTag(java.lang.String tag, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteAllResources(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteDerivedResources(java.lang.Iterable<java.lang.String> derivedResourceIds, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse tags(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse transformations(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse transformation(java.lang.String transformation, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteTransformation(java.lang.String transformation, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse updateTransformation(java.lang.String transformation, java.util.Map updates, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse createTransformation(java.lang.String name, java.lang.String definition, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse uploadPresets(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse uploadPreset(java.lang.String name, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteUploadPreset(java.lang.String name, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse updateUploadPreset(java.lang.String name, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse createUploadPreset(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse rootFolders(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse subFolders(java.lang.String ofFolderPath, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse createFolder(java.lang.String folderName, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse restore(java.lang.Iterable<java.lang.String> publicIds, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse uploadMappings(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse uploadMapping(java.lang.String name, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteUploadMapping(java.lang.String name, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse updateUploadMapping(java.lang.String name, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse createUploadMapping(java.lang.String name, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse publishByPrefix(java.lang.String prefix, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse publishByTag(java.lang.String tag, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse publishByIds(java.lang.Iterable<java.lang.String> publicIds, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse createStreamingProfile(java.lang.String name, java.lang.String displayName, java.util.List<java.util.Map> representations, java.util.Map options) throws java.lang.Exception
name - the of the profiledisplayName - the display name of the profilerepresentations - a collection of Maps with a transformation keyoptions - additional optionsjava.lang.Exception - an exceptionpublic ApiResponse createStreamingProfile(java.lang.String name, java.lang.String displayName, java.util.List<java.util.Map> representations) throws java.lang.Exception
java.lang.ExceptioncreateStreamingProfile(String, String, List, Map)public ApiResponse getStreamingProfile(java.lang.String name, java.util.Map options) throws java.lang.Exception
name - the name of the profile to fetchoptions - additional optionsjava.lang.Exception - an exceptionpublic ApiResponse getStreamingProfile(java.lang.String name) throws java.lang.Exception
java.lang.ExceptiongetStreamingProfile(String, Map)public ApiResponse listStreamingProfiles(java.util.Map options) throws java.lang.Exception
options - additional optionsjava.lang.Exception - an exceptionpublic ApiResponse listStreamingProfiles() throws java.lang.Exception
java.lang.ExceptionlistStreamingProfiles(Map)public ApiResponse deleteStreamingProfile(java.lang.String name, java.util.Map options) throws java.lang.Exception
name - the name of the profile to deleteoptions - additional optionsjava.lang.Exception - an exceptionpublic ApiResponse deleteStreamingProfile(java.lang.String name) throws java.lang.Exception
java.lang.ExceptiondeleteStreamingProfile(String, Map)public ApiResponse updateStreamingProfile(java.lang.String name, java.lang.String displayName, java.util.List<java.util.Map> representations, java.util.Map options) throws java.lang.Exception
name - the of the profiledisplayName - the display name of the profilerepresentations - a collection of Maps with a transformation keyoptions - additional optionsjava.lang.Exception - an exceptionpublic ApiResponse updateStreamingProfile(java.lang.String name, java.lang.String displayName, java.util.List<java.util.Map> representations) throws java.lang.Exception
java.lang.ExceptionupdateStreamingProfile(String, String, List, Map)public ApiResponse updateResourcesAccessModeByPrefix(java.lang.String accessMode, java.lang.String prefix, java.util.Map options) throws java.lang.Exception
accessMode - The new access mode, "public" or "authenticated"prefix - The prefix by which to filter applicable resourcesoptions - additional options
ApiException - an API exceptionjava.lang.Exceptionpublic ApiResponse updateResourcesAccessModeByTag(java.lang.String accessMode, java.lang.String tag, java.util.Map options) throws java.lang.Exception
accessMode - The new access mode, "public" or "authenticated"tag - The tag by which to filter applicable resourcesoptions - additional options
ApiException - an API exceptionjava.lang.Exceptionpublic ApiResponse deleteFolder(java.lang.String folder, java.util.Map options) throws java.lang.Exception
folder - The full path of the folder to deleteoptions - additional options.java.lang.Exception - When the folder isn't empty or doesn't exist.public ApiResponse updateResourcesAccessModeByIds(java.lang.String accessMode, java.lang.Iterable<java.lang.String> publicIds, java.util.Map options) throws java.lang.Exception
accessMode - The new access mode, "public" or "authenticated"publicIds - A list of public ids of resources to be updatedoptions - additional options
ApiException - an API exceptionjava.lang.Exceptionpublic ApiResponse addMetadataField(MetadataField field) throws java.lang.Exception
field - The field to add.java.lang.Exceptionpublic ApiResponse listMetadataFields() throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse metadataFieldByFieldId(java.lang.String fieldExternalId) throws java.lang.Exception
fieldExternalId - The id of the field to retrievejava.lang.Exceptionpublic ApiResponse updateMetadataField(java.lang.String fieldExternalId, MetadataField field) throws java.lang.Exception
fieldExternalId - The id of the field to updatefield - The field definitionjava.lang.Exceptionpublic ApiResponse updateMetadataFieldDatasource(java.lang.String fieldExternalId, java.util.List<MetadataDataSource.Entry> entries) throws java.lang.Exception
fieldExternalId - The id of the field to updateentries - A list of datasource entries. Existing entries (according to entry id) will be updated,
new entries will be added.java.lang.Exceptionpublic ApiResponse deleteDatasourceEntries(java.lang.String fieldExternalId, java.util.List<java.lang.String> entriesExternalId) throws java.lang.Exception
fieldExternalId - The id of the field to updateentriesExternalId - The ids of all the entries to delete from the data sourcejava.lang.Exceptionpublic ApiResponse restoreDatasourceEntries(java.lang.String fieldExternalId, java.util.List<java.lang.String> entriesExternalId) throws java.lang.Exception
fieldExternalId - The id of the field to operateentriesExternalId - The ids of all the entries to restore from the data sourcejava.lang.Exceptionpublic ApiResponse deleteMetadataField(java.lang.String fieldExternalId) throws java.lang.Exception
fieldExternalId - The id of the field to deletejava.lang.Exceptionpublic ApiResponse reorderMetadataFields(java.lang.String orderBy, java.lang.String direction, java.util.Map options) throws java.lang.Exception
orderBy - Criteria for the order (one of the fields 'label', 'external_id', 'created_at')direction - Optional (gets either asc or desc)options - Additional optionsjava.lang.Exceptionpublic ApiResponse listMetadataRules(java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse addMetadataRule(MetadataRule rule, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse updateMetadataRule(java.lang.String externalId, MetadataRule rule, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteMetadataRule(java.lang.String externalId, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse analyze(java.lang.String inputType, java.lang.String analysisType, java.lang.String uri, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse renameFolder(java.lang.String path, java.lang.String toPath, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionpublic ApiResponse deleteBackedUpAssets(java.lang.String assetId, java.lang.String[] versionIds, java.util.Map options) throws java.lang.Exception
java.lang.Exceptionprotected void validateAuthorization(java.lang.String apiKey,
java.lang.String apiSecret,
java.lang.String oauthToken)
protected java.lang.String getAuthorizationHeaderValue(java.lang.String apiKey,
java.lang.String apiSecret,
java.lang.String oauthToken)
protected java.lang.String createApiUrl(java.lang.Iterable<java.lang.String> uri,
java.util.Map options)