Se actualizó este documento.
La traducción en español no está disponible todavía.

Actualización del documento en inglés: 18 abr. 2022
Actualización del documento en español: 15 jun. 2021

Tags

Represents a collection of IG Media objects in which an IG User has been tagged by another Instagram user.

Creating

This operation is not supported.

Reading

GET /{ig-user-id}/tags

Returns a list of IG Media objects in which an IG User has been tagged by another Instagram user.

Limitations

Private IG Media objects will not be returned.

Requirements

Type	Description
Access Tokens	User
Features	Not applicable.
Permissions	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` If the token is from a User whose Page role was granted via the Business Manager, one of the following permissions is also required: `ads_management`, `business_management`, or `pages_read_engagement`.
Tasks	The app user must be able to perform appropriate Tasks on the Page based on the Permissions requested by the app.

Request Syntax

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

Query String Parameters

Include the following query string parameters to augment the request.

Key	Value
`access_token` Required String	The app user's Instagram User Access Token.
`fields` Comma-separated list	A comma-separated list of Fields and Edges you want included in the response. If omitted, default fields will be returned.

Fields

Use the fields query string parameter to specify fields you want included on any returned IG Media objects.

Llamadas a la versión 10.0 y anteriores hasta el 7 de septiembre de 2021: el campo like_count en un contenido multimedia de Instagram devuelve 0 si el propietario del contenido multimedia tiene ahí conteos de Me gusta ocultos.

Llamadas a la versión 11.0 y posteriores y todas las versiones desde el 7 de septiembre de 2021: si se consulta de forma indirecta un contenido multimedia de IG a través de otro punto de conexión o una expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia tiene ahí conteos de Me gusta ocultos. Solicitar de manera directa el contenido multimedia de IG (algo que solo el propietario del contenido multimedia de IG puede hacer) devolverá el conteo real de Me gusta, incluso si se ocultaron estos conteos.

Edges

Use the fields query string parameter to specify Edges you want included on any returned IG Media objects.

Response

A JSON-formatted object containing IG Media objects.

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

Pagination

This edge supports cursor-based pagination so the response will include before and after cursors if the response contains multiple pages of data. Unlike standard cursor-based pagination, however, the response will not include previous or next fields, so you will have to use the before and after cursors to construct previous and next query strings manually in order to page through the returned data set.

Sample Request

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

Sample Response

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

Updating

This operation is not supported.

Deleting

This operation is not supported.