Plataforma de Instagram

Contenido multimedia de Instagram

Representa un álbum, una foto o un vídeo (subido, en directo, creado con la aplicación Instagram TV, reel o historia) de Instagram.

Creación

Esta operación no es compatible.

Lectura

GET /{ig-media-id}

Obtiene los campos y perímetros del contenido multimedia de Instagram.

Limitaciones

  • Los campos que devuelven valores agregados no incluyen datos procedentes de anuncios. Por ejemplo, comments_count cuenta los comentarios de una foto, pero no los de los anuncios que la incluyen.
  • Los textos no incluyen el símbolo @ a menos que el usuario de la aplicación también pueda realizar tareas de administración equivalentes en la aplicación.
  • Algunos campos, como permalink, no se pueden utilizar en fotos de álbumes (elementos dependientes).
  • El contenido multimedia de Instagram TV debe compartirse en Instagram en el momento de la publicación (las opciones Publicar una vista previa o Compartir vista previa en la sección de noticias deben estar activadas) para que sea accesible mediante la API.
  • El contenido multimedia de Instagram de vídeo en directo solo se puede leer mientras se transmite.

Requisitos

TipoDescripción

Identificadores de acceso

Usuario.

Permisos

instagram_basic
pages_read_engagement
pages_show_list


Si se ha concedido un rol en la página al usuario de la aplicación mediante Business Manager, también necesitas uno de los permisos siguientes:


ads_management
business_management

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posiciónValor

{api-version}

Versión de la API.

{ig-media-id}

Obligatorio. Identificador del contenido multimedia de Instagram.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

{access-token}

Obligatorio.Identificador de acceso del usuario de la aplicación.

fields

{fields}

Lista separada por comas de los campos que quieres que se devuelvan.

Campos

Campos públicos que se pueden leer mediante la expansión de campos.

CampoDescripción

caption
Público

Texto. Excluye los elementos dependientes del álbum. Se excluye el símbolo @ a menos que el usuario de la aplicación pueda realizar tareas de administración equivalentes en la página de Facebook conectada a la cuenta de Instagram utilizada para crear el texto.

comments_count
Público

Recuento de comentarios del contenido multimedia. Excluye los comentarios del contenido multimedia de los elementos dependientes del álbum, así como el texto de dicho contenido. Incluye las respuestas a los comentarios.

copyright_check_information.status

Devuelve los objetos status y matches_found.

Objetos “status”Descripción

status

  • completed: el proceso de detección ha finalizado.
  • error: se ha producido un error durante el proceso de detección.
  • in_progress: el proceso de detección está en curso.
  • not_started: el proceso de detección no ha empezado.

matches_found

Establece el objeto en uno de los siguientes valores:

  • false si el vídeo no infringe los derechos de autor.
  • true si el vídeo infringe los derechos de autor.

Si un vídeo infringe los derechos de autor, se devuelve copyright_matches con una matriz de objetos sobre el material con derechos de autor, el momento en que se produce la infracción en el vídeo y las acciones que se deben tomar para mitigar la infracción.

Objetos “copyright_matches”Descripción

author

Autor del vídeo con derechos de autor.

content_title

Nombre del vídeo con derechos de autor.

matched_segments

Matriz de objetos con los siguientes pares de clave-valor: * duration_in_seconds (número de segundos durante los que el contenido infringe los derechos de autor) * segment_type (AUDIO o VIDEO) * start_time_in_seconds (establecido en la hora de inicio del vídeo).

owner_copyright_policy

Entre los objetos devueltos se incluyen los siguientes:

  • name: nombre de la política de los propietarios de los derechos de autor.

  • actions: matriz de objetos action con los pasos de mitigación seguidos según se definen en la política del propietario de los derechos de autor. Se pueden incluir diferentes pasos de mitigación para diferentes ubicaciones.

    • action: acción de mitigación llevada a cabo en relación con la infracción de los derechos de autor del vídeo. Se pueden seguir diferentes pasos de mitigación para diferentes países. Puede ser uno de los siguientes valores:
      • BLOCK: el vídeo se ha bloqueado para las audiencias que se indican en la matriz geos.
      • MUTE: el vídeo se ha silenciado para las audiencias que se indican en la matriz geos.

id
Público

Identificador del contenido multimedia.

ig_id
Público

Identificador del contenido multimedia de Instagram. Se usa con la API de Instagram heredada, que se ha retirado. En su lugar, puedes utilizar id.

is_comment_enabled

Indica si los comentarios están activados o desactivados. Excluye los elementos dependientes del álbum.

is_shared_to_feed
Público

Solo para los reels. Si se define como true, indica que el reel puede aparecer en las pestañas Noticias y Reels. Si se define como false, indica que el reel solo puede aparecer en la pestaña Reels.

Ninguno de los valores determina si el reel aparece realmente en la pestaña Reels, porque es posible que no cumpla con los requisitos de idoneidad o que nuestro algoritmo no lo seleccione. Consulta las especificaciones de los reels para ver los criterios de idoneidad.

like_count

Recuento de Me gusta del contenido multimedia, incluidas las respuestas a los comentarios. Excluye los Me gusta del contenido multimedia del elemento dependiente del álbum y los de las publicaciones promocionadas creadas a partir del contenido multimedia.


Si se consulta indirectamente a través de otro extremo o expansión de campo:


  • Llamadas de la versión 10.0 y anteriores: el valor es 0 si el propietario del contenido multimedia ha ocultado los recuentos de Me gusta.
  • Llamadas de la versión 11.0 y posteriores: el campo like_count se omite si el propietario del contenido multimedia ha ocultado los recuentos de Me gusta.

media_product_type
Público

Superficie en la que se publica el contenido multimedia. Puede ser AD, FEED, STORY o REELS.

media_type
Público

Tipo de contenido multimedia. Puede ser CAROUSEL_ALBUM, IMAGE o VIDEO.

media_url
Público

URL del contenido multimedia.

El campo media_url se omite de las respuestas si el contenido multimedia incluye material con copyright o se ha marcado por una infracción del copyright. Entre los ejemplos de material con copyright, se puede encontrar el audio de los reels.

owner
Público

Identificador del usuario de Instagram que creó el contenido multimedia. Solo se devuelve si el usuario de la aplicación que realiza la consulta también creó el contenido multimedia. En caso contrario, se devuelve el campo username.

permalink
Público

URL permanente del contenido multimedia.

shortcode
Público

Código corto del contenido multimedia.

thumbnail_url
Público

Dirección URL de la miniatura del contenido multimedia. Solo está disponible en contenido multimedia de tipo VIDEO.

timestamp
Público

Fecha de creación en formato ISO 8601 en UTC (el valor predeterminado es UTC ±00:00).

username
Público

Nombre de usuario de la persona que creó el contenido multimedia.

video_title
Público

Obsoleto. Se omite de la respuesta.

Perímetros

Perímetros públicos que se pueden devolver mediante la expansión de campos.

PerímetroDescripción

children
Público

Representa una colección de los objetos de contenido multimedia de Instagram del contenido multimedia de Instagram de un álbum.

collaborators

Representa una lista de los usuarios que se añaden como colaboradores en un objeto de contenido multimedia de Instagram.

comments

Representa una colección de comentarios de Instagram en un objeto de contenido multimedia de Instagram.

insights

Representa los resultados de interacción social de un objeto de contenido multimedia de Instagram.

Ejemplo de cURL

Solicitud

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

Respuesta

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Actualización

POST /{ig-media-id}

Activa o desactiva los comentarios en un objeto de contenido multimedia de Instagram.

Limitaciones

No se admite el contenido multimedia de Instagram de vídeo en directo.

Requisitos

TipoDescripción

Identificadores de acceso

Usuario.

Permisos

instagram_basic
instagram_manage_comments
pages_show_list


Si se ha concedido un rol en la página al usuario de la aplicación mediante Business Manager, también necesitas uno de los permisos siguientes:


ads_management
business_management

Sintaxis de la solicitud

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

Parámetros de ruta

Marcador de posiciónValor

{api-version}

Versión de la API.

{ig-media-id}

Obligatorio. Identificador del contenido multimedia de Instagram.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

{access-token}

Obligatorio.Identificador de acceso del usuario de la aplicación.

comment_enabled

{comment-enabled}

Obligatorio. Se define como true para activar los comentarios o como false para desactivarlos.

Ejemplo de cURL

Solicitud

curl -i -X POST \
 "https://graph.facebook.com/v19.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Respuesta

{
  "success": true
}

Eliminación

Esta operación no es compatible.