Contenedor de Instagram (IG)

Representa un contenedor de archivos multimedia para publicar un objeto multimedia en Instagram.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User user access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • ads_read

Creación

No se admite esta operación.

Lectura

GET <HOST_URL>/<IG_CONTAINER_ID>

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

Sintaxis de la solicitud

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parámetros de cadena de la 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 <IG_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 últimas 24 horas y 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.instagram.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.