Tags

Représente un ensemble d’objets IG Media dans lequel un utilisateur IG a été identifié par un autre utilisateur Instagram.

Création

Cette opération n’est pas prise en charge.

Lecture

GET /{ig-user-id}/tags

Renvoie une liste d’objets IG Media dans laquelle un utilisateur IG a été identifié par un autre utilisateur Instagram.

Limites

Les objets IG Media privés ne sont pas renvoyés.

Conditions requises

Type	Description
Tokens d’accès	Utilisateur·ice
Fonctionnalités	Non applicable
Autorisations	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` `pages_show_list` Si le token émane d’un utilisateur dont le rôle sur la Page a été attribué par le biais du compte Business Manager, l’une des autorisations suivantes est également requise : `ads_management`, `business_management` ou `pages_read_engagement`.
Tâches	L’utilisateur de l’app doit pouvoir effectuer les tâches appropriées sur la Page en fonction des autorisations demandées par l’app.

Syntaxe de la requête

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

Paramètres de chaîne de requête

Inclure les paramètres de chaîne de requête suivants pour augmenter la demande.

Clé	Valeur
`access_token` Obligatoire Chaîne	Token d’accès pour utilisateur Instagram de l’utilisateur de l’application.
`fields` Liste d’éléments séparés par une virgule	Liste de champs et d’arêtes (séparés par des virgules) que vous souhaitez inclure dans la réponse. En cas d’omission, les champs par défaut sont renvoyés.

Champs

Utilisez le paramètre de chaîne de requête fields afin de spécifier les champs que vous souhaitez inclure sur les objets IG Media renvoyés.

Appels des versions 10.0 et antérieures jusqu’au 7 septembre 2021 : le champ like_count associé à un contenu multimédia Instagram renvoie la valeur 0 si le propriétaire du contenu a choisi de masquer les mentions J’aime pour ce contenu.

Appels des versions 11.0 et ultérieures à partir du 7 septembre 2021 : si vous interrogez un contenu multimédia Instagram de manière indirecte par le biais d’un autre point de terminaison ou élargissement de champ, le champ like_count sera omis des réponses de l’API si le propriétaire du contenu multimédia a masqué les mentions J’aime pour ce contenu. Si vous interrogez le contenu multimédia Instagram de manière directe, c’est-à-dire par l’intermédiaire de son propriétaire, le nombre réel de mentions J’aime sera renvoyé, même si le propriétaire a masqué les mentions J’aime pour ce contenu.

Arêtes

Utilisez le paramètre de chaîne de requête fields afin de spécifier les arêtes que vous souhaitez inclure sur les objets IG Media renvoyés.

Réponse

Objet au format JSON contenant les objets IG Media.

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

Pagination

Cette arête prenant en charge la pagination en fonction de curseurs, la réponse inclura les curseurs before et after si la réponse contient plusieurs pages de données. Toutefois, à la différence de la pagination en fonction de curseurs standard, la réponse n’inclura pas les champs previous ou next, vous devrez donc utiliser les curseurs before et after pour construire les chaînes de requête previous et next manuellement afin de parcourir les pages de l’ensemble de données renvoyé.

Exemple de requête

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

Exemple de réponse

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

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.