Mídia de usuário do Instagram

Representa uma coleção de objetos de mídia em um usuário do Instagram.

Criação

POST /{ig-user-id}/media

• Gere um contêiner do Instagram de imagem, carrossel, story ou reel para usar no fluxo de criação de uma publicação. Consulte o guia Publicação de conteúdo para ver todas as etapas do processo.

Limitações

Limitações gerais

• Os contêineres expiram em 24 horas.
• Se a Página conectada à conta profissional do Instagram em questão necessitar de autorização para publicação na Página (PPA, pelas iniciais em inglês), o processo de PPA deverá ser concluído para que a solicitação seja bem-sucedida.
• Se a Página conectada à conta profissional do Instagram em questão exigir autenticação de dois fatores, o usuário do Facebook também precisará ter realizado a autenticação de dois fatores ou ocorrerá uma falha na solicitação.
• Não há compatibilidade com publicações no Instagram TV.

Limitações do Reels

• Os vídeos do Reels não podem aparecer em carrosséis de álbum.
• Ao fazer uma publicação, as configurações de privacidade da conta serão respeitadas. Por exemplo, se a opção Permitir remix estiver habilitada, os vídeos do Reels publicados terão o remix habilitado na publicação. No entanto, é possível desabilitar manualmente o remix no app Instagram.
• A marcação de música está disponível apenas para áudio original.

Limitações de story

• Os stories expiram em 24 horas.
• É possível usar uma URL de vídeo ou uma URL do Reels, mas não ambas.
• Não há compatibilidade com a publicação de figurinhas (ou seja, link, enquete e localização).

Requisitos

Especificações de imagem

• Formato: JPEG.
• Tamanho do arquivo: no máximo 8 MB.
• Taxa de proporção: entre 4:5 e 1,91:1.
• Largura mínima: 320 (se necessário, a foto será redimensionada para atender ao tamanho mínimo).
• Largura máxima: 1.440 (se necessário, a foto será redimensionada para atender ao tamanho máximo).
• Altura: varia conforme a largura e a taxa de proporção.
• Color Space: sRGB. As imagens que usarem outros espaços de cores serão convertidas para o sistema sRGB.

Especificações de reel

Estas são as especificações de Reels:

• Contêiner: MOV ou MP4 (MPEG-4 Part 14), sem listas de edição, atom moov na frente do arquivo.
• Codec de áudio: AAC, taxa de amostragem máxima de 48 kHz, 1 ou 2 canais (mono ou estéreo).
• Codec de vídeo: HEVC ou H.264, verificação progressiva, GOP fechado, chroma subsampling de 4:2:0.
• Taxa de quadros: de 23 a 60 FPS.
• Tamanho da foto:

  • Máximo de colunas (pixels horizontais): 1.920.
  • A taxa de proporção exigida é entre 0,01:1 e 10:1. No entanto, recomendamos a taxa de 9:16 para evitar cortes ou espaços em branco.
• Taxa de bits do vídeo: VBR máximo de 25 Mbps.
• Taxa de bits do áudio: 128 kbps.
• Duração: no máximo 15 minutos e no mínimo 3 segundos.
• Tamanho do arquivo: no máximo 1 GB.

Estas são as especificações de Reels para a foto de capa:

• Formato: JPEG.
• Tamanho do arquivo: no máximo 8 MB.
• Color Space: sRGB. As imagens que usarem outros espaços de cores serão convertidas para o sistema sRGB.
• Taxa de proporção: recomendamos 9:16 para evitar cortes ou espaços em branco. Se a taxa de proporção da imagem original não for 9:16, cortaremos a imagem e usaremos o retângulo do meio como capa do reel. Se você compartilhar um reel no feed, cortaremos a imagem e usaremos o quadrado do meio como capa da publicação no feed.

Especificações de imagens para story

• Formato: JPEG.
• Tamanho do arquivo: no máximo 8 MB.
• Taxa de proporção: recomendamos 9:16 para evitar cortes ou espaços em branco.
• Color Space: sRGB. As imagens que usarem outros espaços de cores serão convertidas para o sistema sRGB.

Especificações de vídeos para story

• Contêiner: MOV ou MP4 (MPEG-4 Part 14), sem listas de edição, atom moov na frente do arquivo.
• Codec de áudio: AAC, taxa de amostragem máxima de 48 kHz, 1 ou 2 canais (mono ou estéreo).
• Codec de vídeo: HEVC ou H.264, verificação progressiva, GOP fechado, chroma subsampling de 4:2:0.
• Taxa de quadros: de 23 a 60 FPS.
• Tamanho da foto:

  • Máximo de colunas (pixels horizontais): 1.920.
  • A taxa de proporção exigida é entre 0,1:1 e 10:1. No entanto, recomendamos a taxa de 9:16 para evitar cortes ou espaços em branco.
• Taxa de bits do vídeo: VBR máximo de 25 Mbps.
• Taxa de bits do áudio: 128 kbps.
• Duração: no máximo 60 segundos e no mínimo 3 segundos.
• Tamanho do arquivo: no máximo 100 MB.

Sintaxe da solicitação

Contêineres de imagem

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

Contêineres de reel

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

Contêineres de carrossel

Apenas contêineres de carrossel. Para gerar contêineres de item de carrossel, crie contêineres de imagem ou vídeo. Não há compatibilidade com Reels. Confira o processo para publicar carrosséis em Publicações em carrossel.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

Contêineres de story de imagem

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

Contêineres de story de vídeo

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

Parâmetros de caminho

Parâmetros da string de consulta

Resposta

Um objeto formatado em JSON que contém um ID do contêiner do Instagram, que pode ser usado para publicar o contêiner.

Como os carregamentos de vídeo são assíncronos, o recebimento do ID do contêiner não garante que o vídeo tenha sido efetivamente carregado. Para verificar se o processo foi bem-sucedido, solicite o campo status_code no contêiner do Instagram. O valor FINISHED indica que o vídeo foi carregado sem erros.

{
  "id":"{ig-container-id}"
}

Exemplo de solicitação

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

Exemplo de resposta

{
  "id": "17889455560051444"
}

Leitura

GET /{ig-user-id}/media

Obtenha todos os objetos de mídia em um usuário do Instagram.

Limitações

• Há um retorno máximo de 10.000 dos objetos de mídia mais recentes.
• A mídia de story do Instagram não é compatível. Em vez disso, use o ponto de extremidade GET /{ig-user-id}/stories.

Requisitos

Paginação com base no tempo

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

Exemplo de solicitação

GET graph.facebook.com/17841405822304914/media 

Exemplo de resposta

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

Atualização

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

Exclusão

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