Etiquetas

Representa una colección de los objetos de contenido multimedia en los que un usuario de Instagram ha etiquetado a otro en la plataforma.

Creación

Esta operación no es compatible.

Lectura

GET /{ig-user-id}/tags

Devuelve una lista de los objetos de contenido multimedia en los que un usuario de Instagram ha etiquetado a otro en la plataforma.

Limitaciones

No se devolverán los objetos de contenido multimedia de Instagram privados.

Requisitos

Tipo	Descripción
Identificadores de acceso	Usuario
Funciones	No es aplicable.
Permisos	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` También se necesitará uno de los siguientes permisos si el identificador pertenece a un usuario cuyo rol de página se ha concedido a través de Business Manager: `ads_management`, `business_management` o `pages_read_engagement`.
Tareas	El usuario de la aplicación debe poder realizar tareas adecuadas en la página según los permisos que solicite la aplicación.

Sintaxis de la solicitud

GET https://graph.facebook.com/{ig-user-id}/tags
  ?fields={fields}
  &access_token={access-token}

Parámetros de la cadena de consulta

Incluye los siguientes parámetros de la cadena de consulta para ampliar la solicitud.

Clave	Valor
`access_token` Cadena obligatoria	Identificador de acceso de usuario de Instagram 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 incluir en la respuesta. Si se omite, se devolverán los campos predeterminados.

Campos

Usa el parámetro de la cadena de consulta fields para especificar los campos que quieres incluir en cualquier objeto de contenido multimedia de Instagram devuelto.

Llamadas de la versión 10.0 y anteriores hasta el 7 de septiembre de 2021: el campo like_count de un contenido multimedia de Instagram devolverá 0 si la persona propietaria ha ocultado el recuento de Me gusta de dicho contenido.

Llamadas de la versión 11.0 y posteriores a partir del 7 de septiembre de 2021: si consultas un contenido multimedia de Instagram indirectamente a través de otro extremo o expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia ha ocultado su recuento de Me gusta. Al consultar directamente el contenido multimedia de Instagram (solo puede hacerlo su propietario), se devolverá el recuento real de Me gusta, aunque se haya ocultado.

Perímetros

Usa el parámetro de la cadena de consulta fields para especificar los perímetros que quieres incluir en cualquier objeto de contenido multimedia de Instagram devuelto.

Respuesta

Objeto con formato JSON que contiene los objetos de contenido multimedia de Instagram.

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

Paginación

Este perímetro admite la paginación basada en cursores, de modo que la respuesta incluirá los cursores before y after si contiene varias páginas de datos. Sin embargo, a diferencia de la paginación basada en cursores estándar, la respuesta no incluirá los campos previous o next, por lo que deberás usar los cursores before y after para construir las cadenas de consulta previous y next manualmente a fin de examinar el conjunto de datos devuelto.

Ejemplo de solicitud

GET graph.facebook.com/17841405822304914/tags
    ?fields=id,username
    &access_token=EAADd...

Ejemplo de respuesta

{
  "data": [
    {
      "id": "18038...",
      "username": "keldo..."
    },
    {
      "id": "17930...",
      "username": "ashla..."
    },
    {
      "id": "17931...",
      "username": "jaypo..."
    }
  ]
}

Actualización

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.