Plataforma de Instagram

Contenedor de IG

Representa un contenedor de archivos multimedia para realizar una publicación en Instagram. Consulta la guía sobre publicación de contenido si deseas conocer los pasos que debes seguir para realizar una publicación.

Creación

No se admite esta operación.

Lectura

GET /{instagram-container-id}

Se usa para obtener campos y perímetros en un contenedor de IG.

Requisitos

TipoDescripción

Tokens de acceso

Usuario

Permisos

instagram_basic
instagram_content_publish
pages_read_engagement


Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página, también se necesitará uno de los siguientes elementos:


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
Cadenaobligatoria

Token de acceso del usuario de la app.

fields
Lista separada por comas

Lista separada por comas de los campos y los perímetros que quieres obtener. Si se omite, recibirás los campos predeterminados.

Campos

Nombre del campoDescripción

copyright_check_status

Se utiliza para determinar si un video subido infringe los derechos de autor. Entre los pares de clave-valor que se devuelven, se incluyen los siguientes:

  • matches_found configurado en uno de los siguientes:
    • true: el video infringe los derechos de autor.
    • false: el video no infringe los derechos de autor.
  • status configurado en uno de los siguientes:
    • completed: el proceso de detección finalizó.
    • error: se produjo 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 comenzó.

id

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

status

Estado de publicación. Si status_code es ERROR, este valor será un subcódigo de error.

status_code

El estado de publicación del contenedor. Valores posibles:


  • EXPIRED: el contenedor no se publicó en las 24 horas siguientes a su creación, por lo que caducó.
  • ERROR: el contenedor no completó el proceso de publicación.
  • FINISHED: el contenedor y su objeto multimedia están listos para la publicación.
  • IN_PROGRESS: el contenedor todavía está atravesando el proceso de publicación.
  • PUBLISHED: se publicó el objeto multimedia del contenedor.

Perímetros

No hay perímetros en este nodo.

Respuesta

Objeto con formato JSON que contiene campos predeterminados y solicitados.

{
  "{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

No se admite esta operación.

Eliminación

No se admite esta operación.