FolderService provides operations for managing folders.
Folders contain a logical folder grouping of ads, creatives, or templates depending on the folder type. The creatives are placed in creative folders, ads are placed in ad folders, and templates are placed in template folders.
FolderService provides operations for retrieving, adding, copying, moving, deleting, and renaming folders.
To add a folder, use the addFolder operation and to add a list of folders, use the addFolders operation.
Add Zipped Creatives
To add creatives that are compressed (zipped format), use the addZippedCreatives operation. Once added, the zip file is treated like a creative folder.
Note: The ZIP file can contain different types of creative files; however, you cannot use a ZIP file to upload files in unsupported formats.
Copy Folders and Folder Contents
To copy a folder to another folder, use the copyFolder operation. You can copy a folder that contains files to create a second folder and set of files, and then assign a name to the copied folder that is unique at that folder level. You cannot copy a folder that already contains one or more subfolders.
To copy files in a folder to another folder, use the copyFolderContents operation.
To delete a folder, use the deleteFolder operation and to delete folders, use the deleteFolders operation. Before deleting a folder, you must empty the folder by moving or removing the files and folders within the folder.
Move Folders and Folder Contents
To move a folder to another folder, use the moveFolder operation. You can move an existing folder to a new location within the ad or creative library. You cannot move a folder into or below itself.
To move contents of a folder into another folder, use the moveFolderContents operation.
To update a folder, use the updateFolder operation and to update a list of folders, use the updateFolders operation.
- To retrieve a folder, use the getFolder operation and to retrieve multiple folders, use the getFolders operation.
- To retrieve the root folder for ads or creatives, use the getRootFolder operation.
- To retrieve the folders under a specific folder, use the getFoldersByParentID operation.
- To retrieve the items in a folder, use the getFolderItemsByFolderID operation.