How long does dailymotion publishing take
We enforce some quotas on the Data API calls. Each graph object field and filter has its own data type, here are the different types available in the API. Please note that any of these can return either their advertised type or a null value if they have no associated data.
Any number, can be integer or floating point. Please use the international notation with a dot between the integer and decimal parts. A truth value. For input values, 0 , "false" and "no" all resolve to false and 1 , "true" and "yes" all resolve to true.
An unordered collection of any other scalar data type most likely strings or numbers. Elements are listed between square brackets and separated by commas. For inputting arrays, simply separate every element with commas.
Any other Data API object, which means that the returned value will be an identifier and that you can retrieve sub-fields of the corresponding object using the dot-notation.
For inputting object values, simply provide the identifier of the object. Flag is a special type reserved for simple boolean filters. When a filter is marked as a flag , it means that it doesn't take any specific value , its presence in the query string is the only thing that matters. You can still attach a value to them in your query string, but it won't have any effect and will be discarded.
Here are the three different ways of using them:. By default, your application can only access public API data like public video title, description, etc. In order to interact with someone's Dailymotion account, this user has to authorize your application. The OAuth 2. Access tokens are central in the protocol: those tokens, in the form of strings, are delivered by an authorization server at Dailymotion and they enable the client application to securely access protected data on behalf of the resource owner the end-user.
Hence, there is a series of back-and-forth exchanges between the client application , the resource owner and the authorization server in order to create an access token , which will be forwarded every time you perform requests to the resource server. The typical exchange is as follows:. With no scope provided, your application will only be able to interact with public data such as searching for a public video or requesting comments on a video.
If your application needs to read private data or change some user's associated data post a comment on behalf of someone, modify someone else's video title, etc , your application can request a larger permission scope.
How to request extended permissions is described in the Extended Permissions section. For more in depth information about the OAuth 2. For this, three canonical types of grant types exist given by resource owner to client application , depending on the scenario and technology used :. The web application profile is suitable for client applications capable of interacting with the end-user's user-agent typically a web browser and capable of receiving incoming requests from the authorization server capable of acting as an HTTP server.
Read the using an access token section for more details. See the requesting an access token from a refresh token section for more details. Note: We strongly advise you to use one of the official Dailymotion SDKs that abstract all of these exchanges for you and make this process easier.
The state parameter preserves a state object set by the client and makes it available in the client response. Mitigate CSRF attacks: The state parameter can be used to send a random value during the authentication redirection. Then the received value has to be validated after processing the response. To perform the validation, the state value has to be stored on the client application side and match with the state parameter received in the response. If it doesn't, you may be the target of an attack and should immediately stop the authentication process.
Redirect users: The state parameter can also be used to redirect the user to the protected page he intends to access after the authentication process. Get the Authorization by sending your unique key to Dailymotion line breaks are for display purposes only :. Retrieve the returned state value and compare it with the one you stored earlier. If the values match, then approve the authentication response and retrieve the rest of the application state like the redirectUrl , else deny it.
Note: The way you store the unique key and the URL depends on your application's type. It can be local storage in single-page, native apps or a cookie in a regular web application.
The state parameter doesn't guarantee the response or the request integrity. Keep in mind that they could be manipulated by malicious users. Native client applications are running as native code on the end-user's computer or device i. These client applications are often capable of interacting with or embedding the end-user's user-agent but are limited in how such interaction affects their end-user experience.
In many cases, native applications are incapable of receiving direct callback requests from the server e. Native client applications can prompt the end-user for their password credentials and use them directly to obtain an access token.
This method is discouraged since users will have to communicate their credentials directly to your client application. Additionally, users who created their account using their Facebook , Google or other third-party accounts won't be able to log-in into your application using this authentication method.
Please note that if you have no other choice but to use this method, you are not allowed to store the end-user credentials you obtained. Ask the end-user for his credentials which consist of a username and a password. Use the access token returned by the request above to make requests on behalf of the user.
We recommend using your access token until its end of validity, failing which you may run into a rate limiting issue. Some authorization methods provide you with a refresh token in addition to the access token.
Once an access token has expired, you can request another access token without the need to repeatedly ask anything to the end-user, but only if you are in possession of a refresh token. Note: One of the problems with OAuth 2 is that the specification doesn't offer any mechanism to upgrade the scope of an existing session on refresh.
See the extended permissions section for more information. As mentioned above, if you need to fetch private data associated to the user or you want to request permission to publish content on a user's behalf, you will need to request extended permissions.
To request extended permissions via OAuth 2. For example this authorization request asks for personal information and full video control line breaks are for display purposes only :.
Note: One of the problems with OAuth 2 is that the specification doesn't offer any mechanism to upgrade the scope of an existing session. There is more to it. Refer yourself to the full Data API reference for a complete list of the information your can access and the permissions needed to request them. Your application should always allow users to revoke authorization granted to your API key.
The user can also revoke your application from his profile on Dailymotion, but it's far less user-friendly than having a simple Logout from Dailymotion button in your interface. Dailymotion supports a non-standard display parameter to trigger different form factors for the authorization dialog that may be more appropriate for your application:.
For example, to trigger the dialog in a pop-up window, you would redirect the user to line breaks are for display purposes only :. Note: Even if you chose page or popup from a known mobile device, the mobile display will be chosen automatically. At high level, using OAuth 2. After you obtain the access token , you can perform authorized requests on behalf of this user by including it in all of your API requests using the Authorization HTTP header:.
You can also provide the access token directly as a query parameter, but this method is not recommended because it's unsafe and incompatible with some other API entry points like the Advanced API :. This request returns diverse information on the user authentified in your application: id, username, screename, extended permissions accepted, roles granted the application through which the token was created.
Some of them will only be available for reading, and some others for creation and edition too. A channel object represents a category of videos on Dailymotion formerly a channel , for example: shortfilms , videogames , news , etc. A player object holds several configuration properties Picture In Picture settings, aspect ratio A playlist object represents an ordered list of videos created by a user.
Videos in a playlist do not necessarily have anything in common. A subtitle object represents a file resource containing closed captioning for a given video.
A user object represents a Dailymotion user account. Users are at the foundation of every other graph objects, since most of them are created through —or owned by— users. Users also represent the main authentication vector to Dailymotion services. The video object is the foundation of Dailymotion' service. Videos are metadata containers wrapped around media streams and can be accessed either directly or through several connections through the Data API.
The following query-string parameters are valid on the whole API and can be provided along with any type of request. Some of them are strongly recommended if you want to enhance your end-user experience.
Change the country for the asset management. Changing this value will filter out content geo-blocked for the defined country and will affect the geo-blocking mechanism.
Additional call context for this request. Some resources of the API require that you provide contextual information along with your request in order to return relevant data. This is especially useful when the API cannot retrieve or guess this additional information by itself. Contextual information should only be provided when expressly needed by the resource you are trying to query. Values should be passed as an embedded and URL encoded query string, for example:? Filter out content and change media assets.
By default, the device is auto-detected based on the user-agent of the API consumer. Valid values are detect , web , mobile and iptv. Changing this value will filter out content not allowed on the defined device. By default, the family filter is turned on. Setting this parameter to false will stop filtering-out explicit content from searches and global contexts. You should always check the result's explicit field when applicable as some contexts may still return those contents.
You should also flag them in your UI to warn the user about the nature of the content. Change the default localization of the user. This will affect results language and content selection.
Note that changing the localization won't give access to geoblocked content of the corresponding location. By default, this option is turned on. Change the size ratio for all video thumbnails. By default, this option is set to original. Accepted values are original , widescreen and square. This endpoint enables to access information about the current authenticated user.
This relates to the user authenticated using an access token provided with the appropriate header or as a query-string parameter. By default, only a small number of default fields are returned, please refer to the complete field list below. For help on requesting more specific fields, see the fields selection section. By default, only a small number of fields marked as default are returned such as the object identifier , please refer to the complete field list below.
For help on requesting specific fields, see the fields selection section. You can also use You can then use filters if any to filter down the result set, see the filtering section for more information.
Here is the list of fields you can retrieve on every channel object. You can retrieve these using the fields query-string parameter on any graph object request. See the fields selection section for more information. Sample value: Everything about video-games! Here is the list of filters you can use to limit a result set of channel objects. You can use these by passing them as query-string parameters with your request. These deprecated filters were once part of the API reference but are no longer maintained.
Support is still available until the end of life date specified for each filter. Do not use any of these for a new project as they may disappear without warning. Use the localization global parameter instead. Connections through the data API are used to link objects with each others.
Here is the list of connections available through the channel object. List of the top users of this channel. This connection joins an object of type channel with a list of user objects. You can specify the list of fields from the user objects to be returned using the fields parameter.
Test it with the API Explorer. List of videos of this channel. This connection joins an object of type channel with a list of video objects. You can specify the list of fields from the video objects to be returned using the fields parameter.
This endpoint returns the same exact message which was given as a parameter. It can be used to test the availability and reactivity of the API. The table below lists all the parameters that can be provided when performing this request:. This endpoint allows anyone to retrieve a video upload URL, when you need to upload a video on Dailymotion's servers and don't want to upload it on your own server.
The languages endpoint is used to retrieve the list of ISO 2 or 3 letter codes associated with the language name, native name, localized name, and name as it could be displayed on Dailymotion. The list of fields returned is fixed and defined as followed. This call do not support the fields parameter. A locale is a set of parameters that defines a user's language, country, currency, etc.
In both cases, the list of fields returned is fixed and defined as follow since these calls do not support the fields parameter. You can also return informations on a specific locale by changing your request locale using the localization global parameter. This endpoint removes the right for the current API key to access the current user account the user authenticated by the current access token.
Once this method is called, all further requests with the same access token will fail and any previously obtained refresh token for this session will be invalidated. Even if publicly documented, you should not rely on beta object for production-ready code. If it sounds interesting, please get in touch with your content manager to be included in the beta program.
To create an object of type player , perform a POST request onthe connection available through the user graph object. If you do not receive any error empty result set , it means that the deletion was successful. Here is the list of fields you can retrieve on every player object. Owner of this player. You can retrieve sub-fields of this user object using the dot-notation e. Here is the list of fields you can retrieve on every playlist object.
Sample value: Check out the top 10 best goals of this year's championship! Sample value: Best goals of the championship. Author of this playlist. These deprecated fields were once part of the API reference but are no longer maintained. Support is still available until the end of life date specified for each field. Here is the list of filters you can use to limit a result set of playlist objects. Here is the list of connections available through the playlist object.
List of videos contained in this playlist in the order defined by its owner. This connection joins an object of type playlist with a list of video objects.
This will return a list containing only the connected video object or an empty list if it is not connected. Note that the order of the identifiers is saved. To create an object of type subtitle , perform a POST request onthe connection available through the video graph object.
If you host your own file, the file will be fetched and the subtitles URL will point to a local copy. Here is the list of fields you can retrieve on every subtitle object.
Here is the list of filters you can use to limit a result set of subtitle objects. You can also use one of the several connections available through the user and channel graph objects. You can then use filters if any to filter down the result set, see the filtering section for more information. Here is the list of fields you can retrieve on every user object.
Country of residence of this user. Allowed values are ISO alpha-2 country codes. True if the authenticated user is following this user. If no user is authenticated, it will always return false. Language used by this user.
Allowed values are ISO alpha-2 and alpha-3 language codes. Returns the various user limits like the maximum allowed duration and size per uploaded video etc.
This property can only be obtained for the currently logged in user. Identifier of this user's parent use parent. Returns True if this user is a partner. Total amount of net revenues in USD generated through the paid content in the last 7 sliding days.
Total amount of net revenues in USD generated through the video monetization in the last 7 sliding days. Total amount of net revenues in USD generated through the video monetization since the beginning.
Total amount of net revenues in USD generated through the website monetization in the last 7 sliding days. Total amount of net revenues in USD generated through the website monetization since the beginning. Use the partner and verified fields instead. Showcased video of this user. You can retrieve sub-fields of this video object using the dot-notation e.
Here is the list of filters you can use to limit a result set of user objects. The filters shortcut has been deprecated. From now on, if you need to use a simple boolean filter, either use the new flags system or look for an equivalent in the filters list e. Here is the list of connections available through the user object. List of this user's children. This connection joins an object of type user with a list of user objects.
This will return a list containing only the connected user object or an empty list if it is not connected.
List of videos featured by this user. This connection joins an object of type user with a list of video objects. List of this user's followers. List of users followed by this user. List of videos liked by the user. List of this user's parents. List of players created by this user beta This connection joins an object of type user with a list of player objects.
You can specify the list of fields from the player objects to be returned using the fields parameter. In return, you will receive a dict value containing the newly created object, including its identifier. List of user accounts related to this user through their parents. List of videos from the channels the user follow. List of videos uploaded by this user. List of watch later videos. These deprecated connections were once part of the API reference but are no longer maintained.
List of videos favorited by this user. List of users recommended to this user. You can also use one of the several connections available through the user , video , channel and playlist graph objects.
To create an object of type video , perform a POST request onthe connection available through the user graph object. Here is the list of fields you can retrieve on every video object. This can be used for targeting in liverail. Current live stream audience. Total live stream audience since stream creation. Audience meter URL to be used for this video. Channel of this video. You can retrieve sub-fields of this channel object using the dot-notation e.
Sample value: "64ff2fccff6cef46f2fa67ff8e". List of countries where this video is blocked by the claimer. A list of country codes ISO alpha-2 e. List of countries where this video is monetized by the claimer. List of countries where this video is tracked by the claimer. Country of this video declarative, may be null. Sample value: This is a sample description for my video. When this video status field is set to processing , this parameter indicates a number between 0 and corresponding to the percentage of encoding already completed.
When this value reaches , it's possible for the owner to play his video. For other statuses this parameter returns Date and time after which this video will be made private. This setting only affects the visibility of the video, it will still be available to anyone who knows how to access the video's private URL even after this date. Set to null recommended or a date after Jan 19th to reset this parameter. Note : Only verified partners are allowed to manage video availability and expiration dates.
Set this to false to disable this behavior. True if this video is explicit. Warning: It's not possible to remove this flag once set. URL of the filmstrip sprite of this video. Not available for short videos. List of countries where this video is or isn't accessible. A list of country codes ISO alpha-2 starting with the deny or allow default keyword to define if this is a black or a whitelist, e. On the other hand, ["deny", "us", "fr"] will deny access to this video in the US and France and allow it everywhere else.
An empty list [] or simply ["allow"] the default will revert the behavior to allow from everywhere. To set geoblocking on your videos, you have to be a Dailymotion partner. Geolocalization for this video. Result is an array with the longitude and latitude using point notation.
Longitude range is from Latitude range is from Sample value: True if this video is "Created for Kids" intends to target an audience under the age of Language of this video.
This value is declarative and corresponds to the user-declared spoken language of the video. URL to publish the live source stream on. The current logged in user need to own this video in order to retrieve this field. Please refer to the API global parameters list for more information about context. A one time usage URL to log a view on this video. This URL expires after a short period of time, thus you should request it at the last moment.
If the app encounters a key format it doesn't understand, it should skip it with a console warning. Delays can be separated by comas all delays apply or pipes first match win, others are ignored. It is not allowed to mix comas and pipes in the same rule. If not specified, default delay should be considered as "0s". The first recurrent trigger must occur after all the relevant delays have been triggered.
The video data has to be contained in a file field:. This API call will create the video on your account. The identifier of the newly created video will be returned in the response, in the response.
If you are an MCN with specific permissions set by your content manager, you can set your content provider id on videos. Once the video is created, it doesn't mean it is published. Set those fields, and toggle the published field to true to publish the video. Benefit from the best technology Use our leading and robust Player technology to deliver your content across all devices in one flawless streaming experience. Reach your audience everywhere Seamlessly integrate the Dailymotion Player and distribute your video content across all your properties and on every device.
Cross-device Compatibility. Customize the experience Let the Dailymotion Player reflect your unique brand identity and adapt its behavior to fit in any environment. Brand Customization. Engage your audiences Grab attention with our content recommendation features and keep them watching longer with the Player EndScreen and Dynamic Previews.
Content Recommendation. Our Monetization Solution. Boost the value of your videos Monetize your video content by accessing high-quality demand within a brand-safe environment. Video Monetization. Website Monetization. Our Live Streaming Features. Enhance your Live Streaming Experience Create, manage, and monetize high-quality live streams thanks to the scalable and free video Player solution. Our Analytics Tools. Perfect your performance Monitor and maximize your audience and ad revenue performance with our analytics tools and 3rd-party integrations.
0コメント