Version API du graphe

Cette arête a été abandonnée et ne peut plus être utilisée.

Vidéos d’évènements /{event-id}/videos

Utilisez ce point de terminaison pour publier des vidéos dans un évènement. Pour supprimer ou mettre à jour une vidéo existante, utilisez plutôt le nœud /{video-id}.

Création

Pour publier une vidéo dans un évènement, envoyez une requête POST à l’arête /{event-id}/videos sur graph-video.facebook.com.

POST /v21.0/{event-id}/videos HTTP/1.1
Host: graph-video.facebook.com

source=%7Bvideo-data%7D
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{event-id}/videos',
    array (
      'source' => '{video-data}',
    ),
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{event-id}/videos",
    "POST",
    {
        "source": "{video-data}"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
Bundle params = new Bundle();
params.putString("source", "{video-data}");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{event-id}/videos",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
NSDictionary *params = @{
  @"source": @"{video-data}",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{event-id}/videos"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Limites

  • Les vidéos doivent être encodées au format multipart/form-data.
  • Si vous importez une vidéo à l’aide d’une requête HTTP en plusieurs parties ou en fournissant une URL, cette vidéo ne doit pas dépasser 1 Go en taille et 20 minutes en durée.
  • Dans le cadre d’une importation avec reprise, la vidéo peut peser jusqu’à 1,75 Go et durer jusqu’à 45 minutes.

Formats pris en charge

3g2, 3gp, 3gpp, asf, avi, dat, divx, dv, f4v, flv, m2ts, m4v, mkv, mod, mov, mp4, mpe, mpeg, mpeg4, mpg, mts, nsv, ogm, ogv, qt, tod, ts, vob, wmv.

Autorisations

L’autorisation pubish_actions a été abandonnée le 24 avril 2018. Pour en savoir plus, consultez le Changelog des modifications importantes. Nous vous encourageons à utiliser nos produits Partage pour fournir un moyen de partager du contenu sur Facebook aux utilisateur·ices de votre application.

Ce point de terminaison nécessite un token d’accès d’utilisateur·ice associé à l’autorisation publish_actions.

Champs

Nom Description Type

id

ID de la cible sur laquelle la vidéo doit être publiée.

numeric string

title

Titre de la vidéo.

string

description

Description de la vidéo, utilisée comme message de statut associé dans les stories de fil. Ce paramètre peut contenir des mentions d’autres Pages Facebook grâce à la syntaxe suivante :

@[page-id]

Par exemple, la description suivante mentionnerait en ligne la Page Facebook Developers :

Test message @[19292868552] tag

L’utilisation de cette fonctionnalité est soumise à examen, mais vous pouvez la tester par vous-même au préalable si vous utilisez des Pages dont vous êtes admin (à la fois pour passer des appels d’API ou pour l’utiliser dans une mention) et une application dont vous êtes développeur.

string

source

Vidéo, encodée en tant que données de formulaire. Ce champ est obligatoire.

multipart/form-data

file_url

URL accessible d’un fichier vidéo. Ne peut pas être utilisé avec upload_phase.

string

thumb

Données brutes de la miniature à importer et associer à une vidéo.

image

upload_phase

Type de requête d’importation segmentée.

enum{start, transfer, finish}

file_size

Taille du fichier vidéo entier en octets.

unsigned int32

start_offset

Position de l’octet de début du segment de fichier.

unsigned int32

video_file_chunk

Segment de fichier vidéo encodé en tant que données de formulaire. Ce champ est obligatoire pendant la phase d’importation transfer.

multipart/form-data

upload_session_id

ID de la session d’importation segmentée.

numeric string

Réponse

En cas de réussite :

Struct {
  id: numeric string,
  upload_session_id: numeric string,
  video_id: numeric string,
  start_offset: numeric string,
  end_offset: numeric string,
  success: bool,
  skip_upload: bool,
}

Lecture

Vous ne pouvez pas lire les vidéos importées dans un évènement à l’aide de cette arête.

Mise à jour

Vous ne pouvez pas effectuer de mise à jour à l’aide de cette arête.

Suppression

Vous ne pouvez pas effectuer de suppression à l’aide de cette arête.