Contenedor de Instagram (IG)

Representa un contenedor de archivos multimedia para publicar un objeto de contenido multimedia de 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

Esta operación no es compatible.

Lectura

GET <HOST_URL>/<IG_CONTAINER_ID>

Obtiene los campos y perímetros de 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 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 <IG_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.instagram.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.