Contenedor de Instagram

Representa un contenedor de archivos multimedia para realizar una publicación de Instagram. En la guía Publicación de contenido, puedes consultar todos los pasos necesarios para realizar la publicación.

Creación

Esta operación no es compatible.

Lectura

GET /{instagram-container-id}

Obtiene los campos y perímetros de un contenedor de IG.

Requisitos

TipoDescripción

Identificadores de acceso

Usuario

Permisos

instagram_basic
instagram_content_publish
pages_read_engagement


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


ads_management
business_management

Sintaxis de la solicitud

GET https://graph.facebook.com/{instagram-container-id}
  ?fields={fields}
  &access_token={access-token}

Parámetros de la cadena de consulta

ParámetroValor

access_token
Cadena
obligatoria

Identificador de acceso del usuario de la aplicación.

fields
Lista de valores separados por comas

Lista de valores separados por comas de los campos y perímetros que quieres que se devuelvan. Si se omite, se devolverán los campos predeterminados.

Campos

Nombre del campoDescripción

copyright_check_status

Se usa para determinar si un vídeo subido infringe los derechos de autor. Los pares de clave y valor devueltos incluyen lo siguiente:

  • matches_found establecido en uno de los valores siguientes:
    • true: el vídeo infringe los derechos de autor.
    • false: el vídeo no infringe los derechos de autor.
  • status establecido en uno de los valores siguientes:
    • 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.

id

Identificador del contenedor de Instagram, representado en los ejemplos de código como {instagram-container-id}.

status

Estado de publicación. Si el valor de status_code es ERROR, en este campo se mostrará un subcódigo de error.

status_code

Estado de publicación del contenedor. Valores posibles:


  • EXPIRED: el contenedor no se ha publicado en 24 horas y ha caducado.
  • ERROR: el contenedor no ha completado el proceso de publicación.
  • FINISHED: el contenedor y su objeto de contenido multimedia están listos para publicarse.
  • IN_PROGRESS: el contenedor sigue en el proceso de publicación.
  • PUBLISHED: el objeto de contenido multimedia del contenedor se ha publicado.

Perímetros

No hay perímetros en este nodo.

Respuesta

Objeto con formato JSON que contiene los campos solicitados y predeterminados.

{
  "{field}":"{value}",
  ...
}

Ejemplo de solicitud

curl -X GET \
  'https://graph.facebook.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

Ejemplo de respuesta

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

Actualización

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.