Contenido multimedia de usuario de Instagram

Representa una colección de los objetos de contenido multimedia de Instagram de un usuario de Instagram.

Creación

POST /{ig-user-id}/media

• Crea un contenedor de Instagram de un reel, una historia, una secuencia o una imagen para usar en el proceso de publicación. En la guía Publicación de contenido, puedes consultar todos los pasos necesarios para realizar la publicación.

Limitaciones

Limitaciones generales

• Los contenedores caducan al cabo de 24 horas.
• Si la página conectada a la cuenta profesional de Instagram de destino requiere autorización de publicación en páginas (PPA), se deberá completar dicha autorización, ya que, de lo contrario, se producirá un error en la solicitud.
• Si la página conectada a la cuenta profesional de Instagram de destino requiere autenticación en dos pasos, el usuario de Facebook también debe haber completado dicho proceso; de lo contrario, se producirá un error en la solicitud.
• No se admite la publicación en Instagram TV.

Limitaciones de reels

• Los reels no pueden aparecer en secuencias de álbum.
• La configuración de privacidad de la cuenta se respeta tras la publicación. Por ejemplo, si la opción Permitir remix está activada, los reels publicados tendrán activado el remix tras su publicación. No obstante, el remix se puede desactivar manualmente en los reels publicados a través de la aplicación de Instagram.
• El etiquetado de música solo está disponible para audio original.

Limitaciones de las historias

• Las historias caducan al cabo de 24 horas.
• Admiten la URL del vídeo o de Reels, pero no ambas.
• No se admite la publicación de stickers (es decir, enlaces, votaciones o ubicaciones).

Requisitos

Especificaciones de imagen

• Formato: JPEG.
• Tamaño del archivo: 8 MB como máximo.
• Relación de aspecto: debe estar en el intervalo de 4:5 a 1,91:1.
• Ancho mínimo: 320 (se aumentará hasta el valor mínimo en caso necesario).
• Ancho máximo: 1440 (se reducirá hasta el valor máximo en caso necesario).
• Alto: varía en función del ancho y la relación de aspecto.
• Espacio de color: sRGB. Si se usan otros espacios de color en las imágenes, se convertirán al tipo sRGB.

Especificaciones de reels

Las siguientes especificaciones se aplican a los reels:

• Contenedor: MOV o MP4 (MPEG-4 Parte 14), sin listas de edición, encabezado moov atom en la parte frontal del archivo.
• Códec de audio: AAC, frecuencia de muestreo máxima de 48 kHz, 1 o 2 canales (mono o estéreo).
• Códec de vídeo: HEVC o H264, escaneo progresivo, GOP cerrado, submuestreo de crominancia 4:2:0.
• Velocidad de fotogramas: 23-60 FPS.
• Tamaño de la foto:

  • Número máximo de columnas (píxeles horizontales): 1920
  • La relación de aspecto debe ser de entre 0,01:1 y 10:1, pero se recomienda que sea de 9:16 para evitar recortes y espacios en blanco.
• Velocidad de bits del vídeo: VBR, 25 Mbps como máximo.
• Velocidad de bits del audio: 128 kbps.
• Duración: 15 minutos como máximo y 3 segundos como mínimo.
• Tamaño del archivo: 1 GB como máximo.

Las siguientes especificaciones se aplican a la foto de portada de los reels:

• Formato: JPEG.
• Tamaño del archivo: 8 MB como máximo.
• Espacio de color: sRGB. Si se usan otros espacios de color en las imágenes, estos se convertirán al tipo sRGB.
• Relación de aspecto: recomendamos 9:16 para evitar recortes o espacios en blanco. Si la relación de aspecto de la imagen original no es 9:16, recortamos la imagen y usamos el rectángulo de 9:16 del centro como foto de portada del reel. Si compartes un reel en tu sección de noticias, recortamos la imagen y usamos el cuadrado de 1:1 del centro como foto de portada de tu publicación en la sección de noticias.

Especificaciones de las imágenes de las historias

• Formato: JPEG.
• Tamaño del archivo: 8 MB como máximo.
• Relación de aspecto: recomendamos 9:16 para evitar recortes o espacios en blanco.
• Espacio de color: sRGB. Si se usan otros espacios de color en las imágenes, estos se convertirán al tipo sRGB.

Especificaciones de los vídeos de las historias

• Contenedor: MOV o MP4 (MPEG-4 Parte 14), sin listas de edición, encabezado moov atom en la parte frontal del archivo.
• Códec de audio: AAC, frecuencia de muestreo máxima de 48 kHz, 1 o 2 canales (mono o estéreo).
• Códec de vídeo: HEVC o H264, escaneo progresivo, GOP cerrado, submuestreo de crominancia 4:2:0.
• Velocidad de fotogramas: 23-60 FPS.
• Tamaño de la foto:

  • Número máximo de columnas (píxeles horizontales): 1920
  • La relación de aspecto debe ser de entre 0,01:1 y 10:1, pero se recomienda que sea de 9:16 para evitar recortes y espacios en blanco.
• Velocidad de bits del vídeo: VBR, 25 Mbps como máximo
• Velocidad de bits del audio: 128 kbps
• Duración: 60 segundos como máximo y 3 segundos como mínimo.
• Tamaño del archivo: 100 MB como máximo.

Sintaxis de la solicitud

Contenedores de imagen

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}

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

Contenedores de secuencia

Solo contenedores de secuencia. Para crear contenedores de elementos de secuencia, crea contenedores de imagen o vídeo en su lugar (los reels no se admiten). Consulta la sección Publicaciones de secuencias para ver todos los pasos de publicación.

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}

Contenedores de historias de imágenes

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

Contenedores de historias de vídeos

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 ruta

Parámetros de la cadena de consulta

Respuesta

Un objeto con formato JSON que contiene el identificador de un contenedor de Instagram que puedes utilizar para publicar el contenedor.

Las subidas de vídeos se realizan de forma asincrónica, por lo que la recepción del identificador de un contenedor no garantiza que la subida se haya completado correctamente. Para verificar que un vídeo se haya subido, solicita el campo status_code en el contenedor de Instagram. Si su valor es FINISHED, significa que el vídeo se ha subido correctamente.

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

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "id": "17889455560051444"
}

Lectura

GET /{ig-user-id}/media

Obtén todo el contenido multimedia de Instagram de un usuario de Instagram.

Limitaciones

• Devuelve un máximo de 10 000 elementos del contenido multimedia más reciente.
• No se admite el contenido multimedia de las historias de Instagram; en su lugar, puedes usar el extremo GET /{ig-user-id}/stories.

Requisitos

Paginación basada en el tiempo

Este extremo admite la paginación basada en el tiempo. Incluye los parámetros de la cadena de consulta since y until con la marca de tiempo Unix o los valores de datos strtotime para definir un intervalo de tiempo.

Ejemplo de solicitud

GET graph.facebook.com/17841405822304914/media 

Ejemplo de respuesta

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

Actualización

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.