Contenido multimedia de Instagram

Representa un álbum, una foto o un video (un video subido, en vivo, un reel o una historia) de Instagram.

Introducción al siguiente campo:

• legacy_instagram_media_id

No se admiten los siguientes campos de punto de conexión para los anuncios de Instagram de la API de marketing:

• filter_name
• location
• location_name
• latitude
• longitude

Creación

No se admite esta operación.

Lectura

GET /<IG_MEDIA_ID>

Obtiene campos y perímetros en el contenido multimedia de Instagram.

Requisitos

Limitaciones

• Campos como comments_count y like_count devuelven la interacción solo en el contenido multimedia objetivo de Instagram y no incluyen datos de otras plataformas. Por ejemplo, comments_count devuelve el número de comentarios de una foto, pero no los comentarios de los anuncios que contienen esa foto. Usa total_comments_count y total_like_count para obtener recuentos totales que incluyan interacciones del contenido multimedia del anuncio promocionado. Se puede incluir el recuento de publicaciones cruzadas de Facebook si el usuario de la sesión puede acceder a esas publicaciones.
• Los comentarios no incluyen el símbolo @ a menos que el usuario de la app también pueda realizar tareas equivalentes a las del administrador en la app.
• Algunos campos, como permalink, no se pueden usar en fotos dentro de álbumes (objetos secundarios).
• El contenido multimedia de Instagram de videos en vivo solo puede leerse durante la transmisión.
• Esta API devuelve solo datos de contenido multimedia que pertenecen a cuentas profesionales de Instagram. No se puede usar para obtener datos de contenido multimedia de cuentas personales de Instagram.
• Los campos reposts_count, saved_count, shares_count, total_like_count, total_comments_count y total_views_count no están disponibles para el contenido multimedia de secuencia secundario y solo se devuelven para objetos multimedia de primer nivel. El propietario del contenido multimedia puede desactivar la visualización de los Me gusta, los comentarios, las reproducciones, los reposts y las veces que se compartió. En estos casos, no se devuelven los campos correspondientes.

Sintaxis de la solicitud

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Parámetros de ruta

Parámetros de la cadena de consulta

Campos

Se pueden leer los campos públicos mediante la expansión de campos.

Perímetros

Se pueden devolver los perímetros públicos si se usa la expansión de campos.

Ejemplo de cURL

Ejemplo de solicitud

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

Ejemplo de 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 multimedia de Instagram.

Limitaciones

No se admite el contenido multimedia de Instagram de video en vivo.

Sintaxis de la solicitud

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Parámetros de ruta

Parámetros de la cadena de consulta

Ejemplo de cURL

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "success": true
}

Eliminación

DELETE /<IG_MEDIA_ID>

Eliminar contenido multimedia de Instagram.

Requisitos

Limitaciones

Esta API solo admite la API de Instagram con inicio de sesión con Facebook. Se admiten publicaciones que no son de anuncios, historias, reels y álbumes de secuencia completos. Para eliminar contenido multimedia dentro de álbumes de secuencia, se debe eliminar todo el álbum de secuencia. Para ello, se debe especificar el identificador de contenido multimedia del contenedor de secuencia. No es posible eliminar individualmente el contenido multimedia de una secuencia.

Sintaxis de la solicitud

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Parámetros de ruta

Parámetros de la cadena de consulta

Ejemplo de cURL

Ejemplo de solicitud

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

Ejemplo de respuesta (satisfactoria)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Ejemplo de respuesta (error, tipo de contenido multimedia no admitido)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}