API Graph pour Instagram

Collaborateur·ices

Représente une liste d’utilisateur·ices qui sont ajoutés en tant que collaborateur·ices à un objet IG Media.

Création

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

Lecture

Obtenez une liste d’utilisateur·ices Instagram en tant que collaborateur·ices IG Media, ainsi que leur statut d’invitation.

GET /{ig-media-id}

Limites

  • Jusqu’à trois comptes Instagram peuvent être ajoutés en tant que collaborateur·ices
  • Seul·es les utilisateur·ices Instagram ayant activé les tags de collaborateur·ice seront renvoyés dans la réponse
  • Images de flux, reels et carrousels sont pris en charge pour les tags de collaborateur·ices, mais pas les stories

Conditions requises

TypeDescription

Tokens d’accès

Utilisateur·ice ; l’utilisateur·ice doit avoir créé l’objet IG Media

Autorisations

instagram_basic
pages_read_engagement
pages_show_list


Si un rôle sur la Page a été attribué à l’utilisateur ou l’utilisatrice de l’application via Business Manager, vous aurez également besoin de l’un des éléments suivants :


ads_management
business_management

Syntaxe de la requête

GET https://graph.facebook.com/{appi-version}/{ig-media-id}/collaborators

Exemple de réponse

{
  "data": [
    {
      "id": "90010775360791",
      "username": "realtest1",
      "invite_status": "Accpeted"
    },
    {
      "id": "17841449208283139",
      "username": "realtest2",
      "invite_status": "Pending"
    },
    {
      "id": "90011117049518",
      "username": "realtest3",
      "invite_status": "Declined"
    }
  ]
}

Paramètres du chemin

Espace réservéValeur

{api-version}

Version de l’API.

{ig-user-id}

Obligatoire. Identifiant de l’utilisateur·ice Instagram.

Paramètres de chaîne de requête

CléEspace réservéValeur

access_token

{access-token}

Obligatoire. Token d’accès Utilisateur de l’utilisateur ou utilisatrice de l’application.

Champs de réponse

Nom du champDescription

id

ID d’application spécifique du compte Instagram du collaborateur ou de la collaboratrice potentiel·le

invite_status

Statut de l’invitation envoyée à un collaborateur ou une collaboratrice potentiel·le. Valeurs possibles :

  • Accepted
  • Declined
  • Pending

username

Nom d’utilisateur·ice du profil Instagram du collaborateur ou de la collaboratrice potentiel·le

Mise à jour

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

Suppression

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