Update API \ Update a section of a YouTube channel

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 Update Pin 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:
  • allPlaylists
  • completedEvents
  • likedPlaylists
  • likes
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
#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."
      }
    }
  }
}

User Contributed Notes