Contenido multimedia de un usuario de IG

Representa una colección de objetos multimedia de IG en historias de un usuario de IG.

Creación

POST /{ig-user-id}/media

• Crea un contenedor de IG de imagen, video, secuencia, historia o reel para usar en el proceso de publicación. Consulta la guía sobre publicación de contenido si deseas conocer los pasos para realizar una publicación.

Limitaciones

Limitaciones generales

• Los contenedores caducan después de 24 horas.
• Si la página conectada a la cuenta profesional de Instagram objetivo requiere una autorización de publicación en páginas (PPA), deberá realizarse dicha autorización, o la solicitud no se procesará.
• Si la página conectada a la cuenta de profesional de Instagram objetivo requiere autenticación en dos pasos, el usuario de Facebook también debe haber realizado la autenticación en dos pasos. De lo contrario, la solicitud no se procesará.
• No se admiten publicaciones en Instagram TV.

Limitaciones de reels

• Los reels no pueden aparecer en secuencias de álbumes.
• Se debe respetar la configuración de privacidad de la cuenta en el momento de la publicación. Por ejemplo, si está activada la opción Permitir remixar, los reels publicados tendrán la función de remix activada en el momento de la publicación, pero, en los reels publicados, esta función se puede desactivar manualmente desde la app de Instagram.
• El etiquetado musical solo está disponible para audio original.

Limitaciones de historias

• Las historias caducan después de 24 horas.
• Son compatibles con URL de video o de reels, pero no con ambas.
• No se admite la publicación de stickers (es decir, enlaces, encuestas, ubicaciones).

Requisitos

Especificaciones relacionadas con las imágenes

• Formato: JPEG
• Tamaño de archivo: 8 MB como máximo
• Relación de aspecto: debe estar dentro del rango de 4:5 a 1,91:1
• Ancho mínimo: 320 (se ampliará al mínimo, si es necesario)
• Ancho máximo: 1.440 (se reducirá al máximo, si es necesario)
• Altura: varía en función de la anchura y de la relación de aspecto
• Color Space: sRGB Las imágenes que utilizan otros espacios de colores se convertirán a sRGB

Especificaciones de Reels

Las siguientes son especificaciones correspondientes a Reels:

• Contenedor: MOV o MP4 (MPEG-4 Parte 14), sin listas de edición, átomo de moov en la cabecera 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 video: HEVC o H264, escaneo progresivo, GOP cerrado, submuestreo de croma 4:2:0
• Velocidad de fotogramas: 23-60 FPS
• Tamaño de la imagen:

  • Máximo de columnas (píxeles horizontales): 1.920
  • La relación de aspecto obligatoria es de 0,01:1 a 10:1, pero recomendamos una de 9:16 para evitar recortes o espacios en blanco
• Tasa de bits de video: VBR, 25 Mbps como máximo
• Tasa de bits de audio: 128 kbps
• Duración: 15 minutos máximo, 3 segundos mínimo
• Tamaño del archivo: 1 GB máximo

Las siguientes son especificaciones relacionadas con la foto de portada de Reels:

• Formato: JPEG
• Tamaño de archivo: 8 MB como máximo
• Espacio de color: sRGB. Las imágenes que utilizan otros espacios de colores se convertirán a sRGB.
• Relación de aspecto: recomendamos usar 9:16 para evitar recortes o espacios en blanco Si la relación de aspecto de la imagen original no es de 9:16, la recortamos y usamos el recorte de rectángulo central de 9:16 como foto de portada del reel. Si compartes un reel en tu feed, recortamos la imagen y usamos el cuadrado central de 1:1 como foto de portada de la publicación del feed.

Especificaciones de las imágenes de las historias

• Formato: JPEG
• Tamaño de archivo: 8 MB como máximo
• Relación de aspecto: recomendamos usar 9:16 para evitar recortes o espacios en blanco
• Espacio de color: sRGB Las imágenes que utilizan otros espacios de colores se convertirán a sRGB

Especificaciones de los videos de las historias

• Contenedor: MOV o MP4 (MPEG-4 Parte 14), sin listas de edición, átomo de moov en la cabecera 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 video: HEVC o H264, escaneo progresivo, GOP cerrado, submuestreo de croma 4:2:0
• Velocidad de fotogramas: 23-60 FPS
• Tamaño de la imagen:

  • Máximo de columnas (píxeles horizontales): 1.920
  • La relación de aspecto obligatoria es de 0,01:1 a 10:1, pero recomendamos una de 9:16 para evitar recortes o espacios en blanco
• Tasa de bits de video: VBR, 25 Mbps como máximo
• Tasa de bits de audio: 128 kbps
• Duración: 60 segundos máximo, 3 segundos mínimo
• Tamaño del archivo: 100 MB como máximo

Sintaxis de la solicitud

Contenedores de imágenes

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 Reels

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 secuencias

Solo contenedores de secuencias. Para crear contenedores de elementos de secuencias, crea contenedores de imágenes o videos (no se admiten los reels). Consulta Publicaciones por secuencia para conocer 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 con 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 con videos

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 incluye un identificador de contenedor de IG que puedes usar para publicar el contenedor.

Las cargas de los videos son asincrónicas. Por este motivo, recibir un identificador del contenedor no garantiza que la carga sea correcta. Para verificar que se cargó el video, solicita el campo status_code en el contenedor de IG. Si su valor es FINISHED, el video se cargó satisfactoriamente.

{
  "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 IG de un usuario de IG.

Limitaciones

• Devuelve el contenido multimedia más reciente, hasta un máximo de 10.000 objetos.
• No se admite el contenido multimedia de historias de IG. Deberás usar el punto de conexión GET /{ig-user-id}/stories.

Requisitos

Paginación basada en el tiempo

Este punto de conexión admite la paginación basada en el tiempo. Para definir el rango de tiempo, incluye los parámetros de cadena de consulta since y until y asígnales valores que sean marcas de tiempo UNIX o datos strtotime.

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

No se admite esta operación.

Eliminación

No se admite esta operación.