Update API \ Update a section of a YouTube channel
Update API Resources
Resource/URI | PUT | DELETE |
---|---|---|
Facebook · Page Post
/update/identities/<identity_token>/facebook/page/<pageid>/post/<postid>.json
|
Update Page Post | Delete Page Post |
Facebook · Page Picture
/update/identities/<identity_token>/facebook/page/<pageid>/picture/<pictureid>.json
|
- | Delete Page Picture |
Facebook · Page Video
/update/identities/<identity_token>/facebook/page/<pageid>/video/<videoid>.json
|
- | Delete Page Video |
Pinterest · Pin
/update/identities/<identity_token>/pinterest/pin/<pinid>.json
|
Delete Pin | |
Twitter · Tweet
/update/identities/<identity_token>/twitter/post/<postid>.json
|
- | Delete Tweet |
YouTube · Channel Section
/update/identities/<identity_token>/youtube/channel/section/<channel_sectionid>.json
|
Update Channel Section | Delete Channel Section |
YouTube · Playlist
/update/identities/<identity_token>/youtube/playlist/<playlistid>.json
|
Update Playlist | Delete Playlist |
YouTube · Playlist Video
/update/identities/<identity_token>/youtube/playlist/<playlistid>/video/<videoid>.json
|
- | Delete Playlist Video |
Workflow
Request: the code to send to the API
Send an API request to the following endpoint to update a section of a YouTube channel:
PUT
/update/identities/<identity_token>/youtube/channel/section/<section_id>.json
The <identity_token>
is obtained whenever one of your users connects with YouTube.
The <section_id>
must be part of the channel sections
that the identity is currently configured to be an administrator of.
In order to use this endpoint the permissions Manage Videos, Manage Account and Account Access must be enabled in the YouTube settings in your OneAll account .
PUT
data to include in the request
{ "request": { "update": { "channel": { "section": { "type": "#type#", "style": "#style#", "title": "#title#", "position": "#position#", "defaultLanguage": "#defaultLanguage#", "playlists": "#playlists#", "channels": "#channels#" } } } } }
Key | Description |
---|---|
*#style# | The format in which the channel section displays. Valid values for this property are: horizontalRow or verticalList. |
*#type# |
The channel section's type. Valid values for this property are:
|
#position# |
The section's position on the channel page. Example: 2 |
If #type# value is multiplePlaylists or singlePlaylist. | |
#playlists# |
A list of one or more playlist IDs that are featured in a channel section. Must be an array. Example: ['PL7XDADAjKDBStctnz5ncrUeRUA_WynnO'] |
#title# | The section's title. |
#defaultLanguage# |
The language of the text in the section. Example: FR |
If #type# value is multipleChannels. | |
#channels# | A list of one or more channel IDs that are featured in a channel section. Must be an array. |
Result: the code returned by the API
The API either returns a HTTP status code 200
if the section was updates successfully
or an appropriate message body with further details on the error that occured.
Resultset Example
{ "response": { "request": { "date": "Wed, 24 Feb 2020 11:17:54 +0100", "resource": "/update/identities/555052e9-1c89-42eb-ad05-38e2dd2020db/youtube/channel/section/UC165251RKqRC0gQkqS0RVg.LeXS151u_pbM.json", "status": { "flag": "success", "code": 200, "info": "The section has successfully been updated." } } } }