Select the Contents of a Portfolio Folder

This page contains information about retrieving and selecting object contained within the Portfolio and associated subfolders of a given Marketing Cloud account.

Why Select the Contents of a Portfolio Folder

You can use the Retrieve call to return information about the object contained within the Portfolio or a subfolder and use it as part of other calls, including creating and sending email messages.

How to Select Contents of a Portfolio Folder

Use the sample code below as a model for your own call. Remember that the Portfolio contains folders; if a folder is not specified, all Portfolio items for the account are returned.

Sample .NET Code

string requestID;  
// Filter by the Folder/Category 
SimpleFilterPart sfp = new SimpleFilterPart();
sfp.Property = "CategoryID";
sfp.SimpleOperator = SimpleOperators.equals;
sfp.Value = new string[] { "6437" };
// Create the RetrieveRequest object
RetrieveRequest request = new RetrieveRequest();
request.ObjectType = "Portfolio";
request.Filter = sfp;
request.Properties = new string[] { "ObjectID", "CustomerKey", "Client.ID", "CategoryID", "FileName", "DisplayName", "Description", "TypeDescription", "IsUploaded", "IsActive", "FileSizeKB", "ThumbSizeKB", "FileWidthPX", "FileHeightPX", "FileURL", "ThumbURL", "CacheClearTime"};
// Execute the Retrieve
APIObject[] results;
string status = integrationFramework.Retrieve(request, out requestID, out results);
// Output the results
System.Text.StringBuilder sb = new System.Text.StringBuilder();
sb.Append("Portfolio Summary");
sb.AppendFormat("\nOverall result: {0}.  RequestID: {1}", status, requestID);
// Print out results for each retrieved object
for (int cntr = 0; cntr < results.Length; cntr++)
{
       sb.Append(string.Format("\n ---- Index {0}", cntr));
       Portfolio id = results[cntr] as Portfolio;
       sb.Append("\n CategoryID: " + id.CategoryID);
       sb.Append("\n DisplayName: " + id.DisplayName);
       sb.Append("\n FileHeightPX: " + id.FileHeightPX);
       sb.Append("\n FileName: " + id.FileName);
       sb.Append("\n FileURL: " + id.FileURL);
       sb.Append("\n FileWidthPX: " + id.FileWidthPX);
       sb.Append("\n IsUploaded: " + id.IsUploaded);
       sb.Append("\n IsActive: " + id.IsActive);
       sb.Append("\n ThumbSizeKB: " + id.ThumbSizeKB);
       sb.Append("\n ThumbURL: " + id.ThumbURL);
       sb.Append("\n TypeDescription: " + id.TypeDescription);
       sb.Append("\n");
}
Console.WriteLine(sb.ToString());

Output

Porfolio Summary Overall result: OK.  
RequestID: af2ff633-1a4d-4e42-98d4-1f36edcd1851 ---- Index 0 
CategoryID: 6437 
DisplayName: Gravatar_25 
FileHeightPX: 0 
FileName: Gravatar_25.jpg 
FileURL: m/1/Gravatar_25.jpg 
FileWidthPX: 0 
IsUploaded: False 
IsActive: True 
ThumbSizeKB: 0 
ThumbURL: m/1/thumb/jpg/Gravatar_25.jpg 
TypeDescription:   ---- Index 1 
CategoryID: 6437 
DisplayName: software 
FileHeightPX: 0 
FileName: software.gif 
FileURL: m/1/software.gif 
FileWidthPX: 0 
IsUploaded: False 
IsActive: True 
ThumbSizeKB: 0 
ThumbURL: m/1/thumb/gif/software.jpg 
TypeDescription:

Related Items

• REST API
• Retrieve Method