Mídia

Representa uma imagem, um vídeo ou um álbum.

Criação

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

Leitura

GET /{media-id}

Obtenha campos e bordas de uma imagem, um vídeo ou um álbum.

Requisitos

Tipo	Requisito
Tokens de acesso	Usuário do Instagram
Permissões	`instagram_graph_user_media`

Sintaxe da solicitação

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

Parâmetros da string de consulta

Inclua o parâmetro da string de consulta a seguir para ampliar a solicitação.

Chave	Valor
`access_token` Obrigatório. String	O token de acesso do usuário do Instagram do usuário do app.
`fields` Lista separada por vírgulas	Uma lista separada por vírgulas dos campos e bordas que devem ser retornados. Se omitida, os campos-padrão serão retornados.

Campos

Use o parâmetro de string de consulta fields para solicitar os seguintes campos em uma mídia.

Nome do campo	Descrição
`caption`	O texto na legenda da mídia. Não retornável para mídias em álbuns.
`id`	O ID da mídia.
`is_shared_to_feed`	Somente para Reels. `true` indica que o reel pode aparecer nas abas Feed e Reels. `false` indica que o reel pode aparecer apenas na aba Reels. Nenhum desses valores garante que o reel aparecerá na aba Reels, porque ele pode não cumprir os requisitos de qualificação ou não ser selecionado pelo algoritmo. Consulte os critérios de qualificação nas especificações de reel.
`media_type`	O tipo de mídia. Pode ser `IMAGE`, `VIDEO` ou `CAROUSEL_ALBUM`.
`media_url`	A URL da mídia.
`permalink`	A URL permanente da mídia. Será omitida se a mídia contiver material protegido por direitos autorais ou tiver sido sinalizada como violação desses direitos.
`thumbnail_url`	A URL da imagem em miniatura da mídia. Disponível somente em mídias de `VIDEO`.
`timestamp`	A data de publicação da mídia no formato ISO 8601.
`username`	O nome de usuário do proprietário da mídia.

Bordas

Você pode solicitar as bordas a seguir como parâmetros de caminho ou usar o parâmetro de string de consulta fields.

Borda	Descrição
`children`	Obtenha a lista de mídias do álbum. Disponível somente em mídias de `CAROUSEL_ALBUM`.

Resposta

Um objeto formatado por JSON contendo os campos e as bordas solicitadas e padrão.

{
  "{field}":"{value}",
  ...
}

Exemplo de cURL

Solicitação

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Resposta

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Atualização

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

Exclusão

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