Push API \ Upload a video to a Facebook group PHP SDK
Push API Resources
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 in order to upload a new video to a Facebook group:
POST
/push/identities/<identity_token>/facebook/group/video.json
The <identity_token>
is obtained whenever one of your users connects using his Facebook account.
In order to use this endpoint the permission Publish To Group must be enabled in the Facebook settings in your OneAll account and the user must have granted this permission when he logged in with Facebook. You can use our Pull API to retrieve the groups of an identity.
POST
data to include in the request
{ "request": { "push": { "group": { "id": "#id#", "url": "#url#", "title": "#title#", "description": "#description#", "create_post": #create_post# } } } }
Key | Description |
---|---|
*
#id#integer
|
The identifier of the group to upload the video to. Example: 4563453 |
*
#url#string
|
The URL of the video to upload. The allowed formats are 3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, gif, m2ts, m4v, mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod, ts, vob, and wmv. Example: http://www.sample-videos.com/video/mp4/720/big_buck_bunny_720p_1mb.mp4 |
#title#string
|
The title of the video to share. Example: Hello World! |
#description#string
|
The description of the video to share. Example: http://www.oneall.com/ |
#create_post#boolean, default true
|
If set to true , the video is uploaded and displayed in a new post on the timeline of the group.If set to false , the video is uploaded but no post is being created. In this case you can use
the returned video_id to attach the video to a new post.
Example: false |
Result: the code returned by the API
Resultset Example
{ "response": { "request": { "date": "Wed, 24 Apr 2019 10:42:49 +0200", "resource": "/push/identities/95681432-e02d-4a0b-ac6a-5c59d0e1fdfd/facebook/group/video.json", "status": { "flag": "success", "code": 200, "info": "Your request has been processed successfully" } }, "result": { "data": { "provider": "facebook", "object": "video", "video_id": "269915607225320", "video_location": "https://www.facebook.com/269915607225320" } } } }