Graph API do Instagram

Mídia ao vivo do usuário do Instagram

Representa uma coleção de mídia do Instagram de vídeo ao vivo em um usuário da plataforma.

Criação

Esta operação não é compatível.

Leitura

GET /{ig-user-id}/live_media

Obtenha uma coleção de mídia do Instagram de vídeo ao vivo em um usuário da plataforma.

Limitações

Só será retornada a mídia do Instagram de vídeo ao vivo em transmissão no momento da solicitação.

Paginação com base no tempo

Esse ponto de extremidade é compatível com a paginação com base no tempo. Inclua os parâmetros da string de consulta since e until com registro de data e hora do Unix ou valores de dados strtotime para definir um intervalo de tempo.

Requisitos

TipoRequisito

Tokens de acesso

Usuário

Permissões

instagram_basic
instagram_read_engagement
pages_read_engagement


Caso uma função tenha sido concedida ao usuário do app por meio do Gerenciador de Negócios na Página conectada ao usuário direcionado do Instagram, você precisará obter uma das seguintes permissões:


ads_management
business_management

Sintaxe da solicitação

GET https://graph.facebook.com/{api-version}/{ig-user-id}/live_media
  ?access_token={access-token}

Parâmetros de caminho

Espaço reservadoValor

{api-version}
String

A versão da API.

{ig-user-id}
Obrigatório
String

O ID do usuário no escopo do app.

Parâmetros da string de consulta

ChaveValor

access_token
Obrigatório.
String

O token de acesso do usuário do app.

fields
Lista separada por vírgulas

Lista separada por vírgulas dos campos de mídia do Instagram que você quer retornar para cada mídia do Instagram ao vivo no conjunto de resultados.

since
Registro de data e hora

Um registro de data e hora do Unix ou um valor de dados strtotime que aponta para o início do intervalo de dados baseados em tempo. Veja mais sobre paginação baseada em tempo.

until
Registro de data e hora

Um registro de data e hora do Unix ou um valor de dados strtotime que aponta para o final do intervalo de dados baseados em tempo. Veja mais sobre paginação baseada em tempo.

Resposta

Um objeto formatado por JSON contendo os dados solicitados.

{
  "data": [],
  "paging": {}
}

Conteúdos de resposta

PropriedadeValor

data

Uma matriz de mídia do Instagram de um usuário da plataforma.

paging

Um objeto com cursores de paginação e URLs de recuperação para o conjunto de dados seguinte/anterior.

Exemplo de cURL

Solicitação

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914/live_media?fields=id,media_type,media_product_type,owner,username,comments&access_token=IGQVJ...'

Resposta

{
   "id":"90010498116233",
   "media_type":"BROADCAST",
   "media_product_type":"LIVE",
   "owner":{
      "id":"17841405822304914"
   },
   "username":"jayposiris",
   "comments":{
      "data":[
        {
            "hidden": false,
            "id": "17907364514064687",
            "like_count": 0,
            "media": {
                "id": "17892642502701087"
            },
            "text": "@jayposiris",
            "timestamp": "2021-08-17T21:23:07+0000",
            "username": "bztest0316_11",
            "from": {
                "id": "5895605157123796",
                "username": "bztest0316_11"
            }
        }
      ]
   }
}

Atualização

Esta operação não é compatível.

Exclusão

Esta operação não é compatível.