Push API \ Add a section to a YouTube channel

Resource/URI POST
Facebook · Publish a post on a user's profile /push/identities/<identity_token>/facebook/post.json Publish User Post
Facebook · Upload a picture on behalf of a user /push/identities/<identity_token>/facebook/picture.json Upload User Picture
Facebook · Upload a video on behalf of a user /push/identities/<identity_token>/facebook/video.json Upload User Video
Facebook · Publish a post to a group the user is member of /push/identities/<identity_token>/facebook/group/post.json Publish Group Post
Facebook · Upload a picture to a group the user is member of /push/identities/<identity_token>/facebook/group/picture.json Upload Group Picture
Facebook · Upload a video to a group the user is member of /push/identities/<identity_token>/facebook/group/video.json Upload Group Video
Facebook · Publish a post on a page the user administers /push/identities/<identity_token>/facebook/page/post.json Publish Page Post
Facebook · Upload a picture on behalf of a page that the user administers /push/identities/<identity_token>/facebook/page/picture.json Upload Page Picture
Facebook · Upload a video on behalf of a page that the user administers /push/identities/<identity_token>/facebook/page/video.json Upload Page Video
LinkedIn · Publish a post on a user's profile /push/identities/<identity_token>/linkedin/post.json Publish User Post
LinkedIn · Publish a post on a company page the user administers /push/identities/<identity_token>/linkedin/company/post.json Publish Company Post
Pinterest · Publish a pin on behalf of a user /push/identities/<identity_token>/pinterest/board/<board_id>/pin.json Publish Pin
Pinterest · Publish a board on behalf of a user /push/identities/<identity_token>/pinterest/board.json Publish Board
Twitter · Publish a tweet on a user's timeline /push/identities/<identity_token>/twitter/post.json Publish Tweet
Twitter · Upload a picture on behalf of a user /push/identities/<identity_token>/twitter/picture.json Upload Picture
Twitter · Upload a video on behalf of a user /push/identities/<identity_token>/twitter/video.json Upload Video
YouTube · Publish a video on behalf of a user /push/identities/<identity_token>/youtube/video.json Upload Video
YouTube · Add a video to a playlist /push/identities/<identity_token>/youtube/playlist/<playlist_id>/video.json Add Video to Playlist
YouTube · Create a playlist on behalf of a user /push/identities/<identity_token>/youtube/playlist.json Create Playlist
YouTube · Add a section to a user's channel /push/identities/<identity_token>/youtube/channel/section.json Add Channel Section

Workflow

Request: the code to send to the API

Send an API request to the following endpoint to create a new section and add it to a YouTube channel:

POST /push/identities/<identity_token>/youtube/channel/section.json

The <identity_token> is obtained whenever one of your users connects using YouTube.

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 .

POST data to include in the request

{
	"request": {
		"push": {
			"channel_section": {
				"type": "#type#",
				"style": "#style#",
				"title": "#title#",
				"position": "#position#",
				"default_language": "#default_language#",
				"playlist_ids": [
					#playlist_ids#
				],
				"channel_ids": [
					#channel_ids#
				]
			}
		}          
	}
}
Key Description
*#style# The format in which the channel section displays. Valid values for this property are: horizontalRow, verticalList
*#type# The type of the channel section. 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
#title# The section's title.
Example: Hello World!
#default_language# The language of the text in the section.
Example: FR
#playlist_ids# One or more identifiers of playlists that are featured in the channel section.
Example: PL7XDADAjKDBStctnz5ncrUeRUA_WynnO
#channel_ids# One or more identifiers of channels to add the section to.
Example: UC0b0B1JzM58DwtP6UG5xVjg

Result: the code returned by the API

Resultset Example

        {
          "response": {
            "request": {
              "date": "Fri, 25 Jan 2018 12:00:53  0200",
              "resource": "/push/identities/12345678-ABCD-WXYZ-1234-ABCABCABCABC/youtube/playlist.json",
              "status": {
                "flag": "success",
                "code": 200,
                "info": "Your request has been processed successfully"
              }
            },
            "result": {
              "data": {
                    "provider" : "youtube",
                    "object" : "channel_section",
                    "channel_section_id" : "UC4o341551kqS0RVg.Zx4DA4xg9IM",
                    "channel_section_type" : "likedPlaylists",
                    "channel_section_style" : "horizontalRow",
                    "channel_section_position" : "2",
                    "channel_id" : "UC44151513VRKqRC0gQkqS0RVg"
              }
            }
          }
        }

User Contributed Notes