// We pass suggested new linked content items back to the client by adding their ids to the
// client object before returning it. It's the client's responsibility to check the linked
// content item ids it passed in with those that came back, and to present appropriate
// UI for processing the suggestions. Note that we shouldn't add the suggestions directly
// to contentEntity! This will persist them to the datastore prematurely.
BaseContentItem ret = contentEntity.toClientObject();
if (newLinkedContentItemSuggestions != null) {
ret.addAllLinkedContentItemIds(newLinkedContentItemSuggestions);
}