Versão Graph API

Esta borda ficou obsoleta e não pode mais ser usada.

Vídeos de eventos /{event-id}/videos

Use o ponto de extremidade para publicar vídeos em um evento. Para excluir ou atualizar um vídeo existente, use o nó /{video-id}.

Criação

Para postar um vídeo em um evento, envie uma solicitação POST à borda /{event-id}/videos em graph-video.facebook.com.

POST /v26.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
}];

Limitações

  • Os vídeos precisam estar codificados como multipart/form-data.
  • Ao carregar um vídeo com uma solicitação HTTP com várias partes ou fornecer um URL para o vídeo, não ultrapasse os limites de 1 GB de tamanho e 20 minutos de duração.
  • Os vídeos para carregamento retomável podem ter até 1,75 GB e 45 minutos de duração.

Formatos compatíveis

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.

Permissões

A permissão pubish_actions foi removida em 24 de abril de 2018. Para ver mais informações, consulte Alterações fora de ciclo. Para você oferecer aos usuários do app um modo de compartilhar conteúdo no Facebook, use nossos produtos de compartilhamento.

Para usar esse ponto de extremidade, é necessário um token de acesso do usuário com permissão publish_actions.

Campos

Nome Descrição Tipo

id

O ID do alvo onde o vídeo será publicado.

numeric string

title

O título do vídeo.

string

description

A descrição do vídeo, usada como mensagem de status de acompanhamento em qualquer story do feed. Este parâmetro não pode ter menções a outras Páginas do Facebook com a seguinte sintaxe:

@[page-id]

Por exemplo: a descrição a seguir mencionaria a página do Facebook Developers inline.

Test message @[19292868552] tag

O uso do recurso está sujeito à análise, mas ao usar Páginas administradas por você (na chamada de API e na menção) e um app que você tenha desenvolvido, é possível fazer um teste antes da análise.

string

source

O vídeo, codificado como dados de formulário. Este campo é obrigatório.

multipart/form-data

file_url

O URL acessível de um arquivo de vídeo. Não pode ser usado com upload_phase.

string

thumb

Os dados brutos da miniatura de vídeo a serem carregados e associados ao vídeo.

image

upload_phase

Tipo de solicitação de carregamento em partes.

enum{start, transfer, finish}

file_size

O tamanho do arquivo de vídeo em bytes.

unsigned int32

start_offset

A posição do byte de início da parte do arquivo.

unsigned int32

video_file_chunk

A parte do arquivo de vídeo, codificada como dados de formulário. Este campo é obrigatório na fase de carregamento transfer.

multipart/form-data

upload_session_id

O ID da sessão de carregamento em partes.

numeric string

Resposta

Caso a operação seja bem-sucedida:

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,
}

Leitura

Não é possível ler os vídeos carregados em um evento usando esta borda.

Atualização

Não é possível fazer atualizações usando essa borda.

Exclusão

Não é possível excluir com essa borda.