Contentunit WSDL
A contentunit modelThis service is stateful.
Examples +
- tagging
- tagging
addtop
Deprecated 2011-01-01
This method will be removed in upcoming releases.
Use save() to persist a new entity
Description
Saves changes made to the Contentunit
int add()
Return Values
int | The ID of the Contentunit (unique) |
addChanneltop
Description
Add a channel to this contentunit
boolean addChannel(int $channel)
Parameters
int | $channel | The channel to add |
Return Values
boolean |
addDefaultContentunitCoststop
Description
Add a default Cost for the Contentunit
boolean addDefaultContentunitCosts(string $costtype, string $incomes_or_costs, double $value)
Parameters
string | $costtype | |
string | $incomes_or_costs | |
double | $value |
Return Values
boolean |
addLearningTagAttributetop
Description
Only internal attributes are allowed to be added to existing contentunits.
boolean addLearningTagAttribute(string $name, string $value)
Parameters
string | $name | |
string | $value |
Return Values
boolean | True on success, otherwise false |
assignTaggingPeculiaritytop
Description
Assign a tagging peculiarity to the contentunit
boolean assignTaggingPeculiarity(int $peculiarity)
Parameters
int | $peculiarity | The peculiarity |
Return Values
boolean |
buildLearningTagContentunittop
Description
Replaces the service state with a new, unsaved contentunit with default values applied from the configuration.
Further changes can be still made before saving the contentunit.
Requires admin rights.
boolean buildLearningTagContentunit(LearningTagContentunitBuilderConfiguration $configuration)
Parameters
LearningTagContentunitBuilderConfiguration | $configuration |
Return Values
boolean | True on success, otherwise false |
clearObjectDatatop
Description
Clears the current object state.
This method will unload possibly loaded objects. Unsaved changes will be lost.
boolean clearObjectData()
Return Values
boolean |
doComplexCalltop
Description
Execute a complex call.
For further information read the API-User documentation.
string doComplexCall(string $xmlstr)
Parameters
string | $xmlstr | XML of Complex Statements |
Return Values
string | The output produced by the statements |
edittop
Deprecated 2011-01-01
This method will be removed in upcoming releases.
Use save() to persist changes made to an entity
Description
Saves changes made to the Contentunit
boolean edit()
Return Values
boolean | TRUE on succes, FALSE on fail |
editDefaultContentunitCoststop
Description
Edit default the contentunitcosts
boolean editDefaultContentunitCosts(string $costtype, string $incomes_or_costs, double $value)
Parameters
string | $costtype | |
string | $incomes_or_costs | |
double | $value |
Return Values
boolean |
enableTcfParameterstop
Description
Enables TCF(GDPR) parameters for subsequent requests.
boolean enableTcfParameters()
Return Values
boolean | True on success, otherwise false |
findIdsByChannelIdtop
Description
Returns an IntegerList of ids of contentunits that belongs to the given channel.
IntegerList findIdsByChannelId(int $channel_id)
Parameters
int | $channel_id |
Return Values
IntegerList | containing the ids of contentunits |
getAllowedCodeTypestop
Description
Get a list of valid code types
string getAllowedCodeTypes()
Return Values
string |
getAllowedTagTypestop
Description
Get a list of valid tag types
string getAllowedTagTypes()
Return Values
string |
getAllowedTypestop
Description
Get a list of valid types
string getAllowedTypes()
Return Values
string |
getAssignedTaggingPeculiaritiestop
Description
Gets the assigned tagging peculiarities
string getAssignedTaggingPeculiarities()
Return Values
string |
getCapacityByTimetop
Description
Get the capacity of a contentunit in the given time range if the ContentUnit is not available 0 is returned
int getCapacityByTime(string $startdate, string $enddate)
Parameters
string | $startdate | |
string | $enddate |
Return Values
int |
getChannelstop
Description
Get the channels of this contentunit
string getChannels()
Return Values
string |
getClickstop
Description
Get the number of clicks in the given time range
int getClicks(string $start, string $end)
Parameters
string | $start | For an unlimited clickval set $start and $end to null |
string | $end | For an unlimited clickval set $start and $end to null |
Return Values
int |
getCodeTypetop
Description
Get the codetype of the contentunit
string getCodeType()
Return Values
string |
getContentunitcoststop
Description
Contentunit cost entry
string getContentunitcosts()
Return Values
string |
getContentunitgroupIdtop
Description
Get the contentunitgroupId of the contentunit
int getContentunitgroupId()
Return Values
int |
getDefaultContentUnitCoststop
Description
Contentunit cost entry
string getDefaultContentUnitCosts(string $costtype, string $incomes_or_costs)
Parameters
string | $costtype | |
string | $incomes_or_costs |
Return Values
string |
getEffectiveTaggingPeculiaritiestop
Description
Gets the effective assigned tagging peculiarities (active, also inherited)
string getEffectiveTaggingPeculiarities()
Return Values
string |
getExclusiveCampaignstop
Description
Returns all exclusive campaigns of contentunit
Returns the first websitefilter id associated with this contentunit's website if the contentunit has no filter assigned to itself.
Returns NULL otherwise.
string getExclusiveCampaigns()
Return Values
string |
getExternalIdtop
Description
Get the externalId of the contentunit
string getExternalId()
Return Values
string |
getHeighttop
Description
Get the height of the contentunit
int getHeight()
Return Values
int |
getIdtop
Description
Get the id of the contentunit
int getId()
Return Values
int |
getLearningTagAttributestop
Description
LearningTagAttributeList getLearningTagAttributes()
Return Values
LearningTagAttributeList |
getNametop
Description
Get the name of the contentunit
string getName()
Return Values
string |
getNetworktop
Description
Returns the current network id
int getNetwork()
Return Values
int | Network ID |
getNetworkIdtop
Description
Returns the network id of the contentunit
int getNetworkId()
Return Values
int |
getTagTypetop
Description
Get the tagtype of the contentunit
string getTagType()
Return Values
string |
getTimerangeReporttop
Description
Get the quickreport for a specifed time range
string getTimerangeReport(string $start, string $end)
Parameters
string | $start | |
string | $end |
Return Values
string |
getToHeighttop
Description
Get the maximum height of the contentunit
int getToHeight()
Return Values
int |
getToWidthtop
Description
Get the maximum width of the contentunit
int getToWidth()
Return Values
int |
getTokentop
Description
Gets the session token. Can be used for single-sign-on.
string getToken()
Return Values
string |
getTypetop
Description
Get the type of the contentunit
string getType()
Return Values
string |
getUpdatedAttop
Description
Get the updated at datetime
string getUpdatedAt()
Return Values
string |
getViewstop
Description
Get the number of views in the given time range
int getViews(string $start, string $end)
Parameters
string | $start | For an unlimited viewval set $start and $end to null |
string | $end | For an unlimited viewval set $start and $end to null |
Return Values
int |
getWebsiteIdtop
Description
Get the websiteId of the contentunit
int getWebsiteId()
Return Values
int |
getWebsiteTagtop
Description
Return the websitetag code for a contentunit
string getWebsiteTag()
Return Values
string |
getWidthtop
Description
Get the width of the contentunit
int getWidth()
Return Values
int |
hasChanneltop
Description
Check if a channel is assigned to this contentunit
boolean hasChannel(int $channel)
Parameters
int | $channel | The channel to check |
Return Values
boolean |
hasTaggingBlockertop
Description
Determines whether the contentunit has a tagging blocker
boolean hasTaggingBlocker()
Return Values
boolean |
isActivetop
Description
Return the active flag of the contentunit
boolean isActive()
Return Values
boolean |
isRontop
Description
Return the ron flag of the contentunit
boolean isRon()
Return Values
boolean |
isSsltop
Description
Return the ssl flag of the contentunit
boolean isSsl()
Return Values
boolean |
isTaggingPecuiliarityAssignedtop
Description
Determines whether the given tagging peculiarity is assigned to the contentunit
boolean isTaggingPecuiliarityAssigned(int $peculiarity)
Parameters
int | $peculiarity | The peculiarity |
Return Values
boolean |
loadtop
Description
Load a contentunit
boolean load(int $id)
Parameters
int | $id | The contentunit id to load |
Return Values
boolean | True on success, otherwise false |
logintop
Description
Initializes a new session with given information
boolean login(string $user, string $pass, int $network)
Parameters
string | $user | Username |
string | $pass | Password |
int | $network | $network Network ID |
Return Values
boolean | true on success, false on fail |
loginSmartPhonetop
Deprecated 2014-12-22
This method will be removed in upcoming releases.
Was only useful for the mobile app, which is not supported anymore.
Description
Login method
boolean loginSmartPhone(string $user, string $pass, int $network, string $client)
Parameters
string | $user | Username |
string | $pass | Password |
int | $network | $network Network ID |
string | $client | Client token e.g. "apn" token of iPhone |
Return Values
boolean | TRUE on success, FALSE on fail |
logouttop
Description
Destroys the active session, logging out the user.
boolean logout()
Return Values
boolean | true on success, false on fail |
removetop
Description
Delete the contentunit and remove contentunitfilter
boolean remove()
Return Values
boolean | true on success |
removeByIdtop
Description
Removes a ContentunitModel with the given id
boolean removeById(int $id)
Parameters
int | $id | ID of object to remove. |
Return Values
boolean |
removeChanneltop
Description
Remove a channel from this contentunit
boolean removeChannel(int $channel)
Parameters
int | $channel | The channel to remove |
Return Values
boolean |
removeDefaultContentUnitCoststop
Description
Remove a contentunit cost entry
boolean removeDefaultContentUnitCosts(string $costtype, string $incomes_or_costs)
Parameters
string | $costtype | |
string | $incomes_or_costs |
Return Values
boolean |
removeLearningTagAttributetop
Description
Only internal attributes are allowed to be removed from existing contentunits.
boolean removeLearningTagAttribute(string $name, string $value)
Parameters
string | $name | |
string | $value |
Return Values
boolean | True on success, otherwise false |
savetop
Description
Persists current object state
boolean save()
Return Values
boolean |
setActivetop
Description
Activate or deactivate the contentunit
boolean setActive(boolean $active)
Parameters
boolean | $active | The new active flag |
Return Values
boolean | true on success, false on error |
setCodeTypetop
Description
Set the codetype of the contentunit
The value can be on of ['javascript', 'iframe'].
boolean setCodeType(string $code_type)
Parameters
string | $code_type | The codetype for this contentunit |
Return Values
boolean | true on success, false on error |
setContentunitgroupIdtop
Description
Set the contentunitgroupId of the contentunit
boolean setContentunitgroupId(int $contentunitgroup_id)
Parameters
int | $contentunitgroup_id | The contentunitgroupId for this contentunit. |
Return Values
boolean | true on success, false on error |
setExternalIdtop
Description
Set the externalId of the contentunit
boolean setExternalId(string $external_id)
Parameters
string | $external_id | The externalId for this contentunit |
Return Values
boolean | true on success, false on error |
setHeighttop
Description
Set the height of the contentunit
boolean setHeight(int $height)
Parameters
int | $height | The height for this contentunit. |
Return Values
boolean | true on success, false on error |
setNametop
Description
Set the name of the contentunit
boolean setName(string $name)
Parameters
string | $name | The name for this contentunit |
Return Values
boolean | true on success, false on error |
setRontop
Description
Set the contentunit to run of network (ron)
boolean setRon(boolean $ron)
Parameters
boolean | $ron | The new ron flag |
Return Values
boolean | true on success, false on error |
setSsltop
Description
Set the contentunit to use or use not ssl for its delivery
boolean setSsl(boolean $ssl)
Parameters
boolean | $ssl | The new ssl flag |
Return Values
boolean | true on success, false on error |
setTagTypetop
Description
Set the tagtype of the contentunit
The value can be on of ['websitetag', 'websiteredirect', 'campaignredirect', 'click'].
boolean setTagType(string $tag_type)
Parameters
string | $tag_type | The tagtype for this contentunit. |
Return Values
boolean | true on success, false on error |
setTaggingBlockertop
Description
Sets tagging blocker on the contentunit
boolean setTaggingBlocker()
Return Values
boolean |
setToHeighttop
Description
Set the maximum height of the contentunit
boolean setToHeight(int $height)
Parameters
int | $height | The maximum height for this contentunit. |
Return Values
boolean | true on success, false on error |
setToWidthtop
Description
Set the width of the contentunit
boolean setToWidth(int $width)
Parameters
int | $width | The maximum width for this contentunit. |
Return Values
boolean | true on success, false on error |
setTypetop
Description
Set the type of the contentunit
The value can be on of ['fix', 'poplayer', 'dynamic', 'mobile'].
boolean setType(string $type)
Parameters
string | $type | The type for this contentunit |
Return Values
boolean | true on success, false on error |
setWebsiteIdtop
Description
Set the websiteId of the contentunit
boolean setWebsiteId(int $website_id)
Parameters
int | $website_id | The websiteId for this contentunit. |
Return Values
boolean | true on success, false on error |
setWidthtop
Description
Set the width of the contentunit
boolean setWidth(int $width)
Parameters
int | $width | The width for this contentunit. |
Return Values
boolean | true on success, false on error |
unassignTaggingPeculiaritytop
Description
Unassign a tagging peculiarity from a the contentunit
boolean unassignTaggingPeculiarity(int $peculiarity)
Parameters
int | $peculiarity | The peculiarity |
Return Values
boolean |
unsetTaggingBlockertop
Description
Unset tagging blocker from the contentunit
boolean unsetTaggingBlocker()
Return Values
boolean |
validatetop
Description
Validates the object and returns an error stack.
string validate()
Return Values
string |
IntegerListtop
Definition
IntegerList for SoapServices.
You may want to use this to pass a list of integers (e.g. ids) as
parameter in you soap service.
- - Array <int> $integers
-
optional
The integers
LearningTagAttributetop
Definition
- - string $name
-
required
- - string $value
-
required
LearningTagAttributeListtop
Definition
LearningTagContentunitBuilderConfigurationtop
Definition
- - int $candidateId
-
required
See LearningTagCandidateService::getCandidates() for a list of valid candidates.
- - boolean $autoCreateExternalAttributes
-
optional
- - boolean $buildContentunitGroups
-
optional