Plateforme Instagram

Collaborateurs et collaboratrices

Représente une liste d’utilisateurs et utilisatrices qui sont ajouté·es en tant que collaborateurs ou collaboratrices à un objet IG Media.

Disponible pour l’API Instagram avec Facebook Login.

Création

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

Lecture

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

GET /<IG_MEDIA_ID>

Limites

  • Jusqu’à cinq comptes Instagram peuvent être ajoutés en tant que collaborateurs ou collaboratrices
  • Seul·es les utilisateurs et utilisatrices 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

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
ads_read

Syntaxe de la requête

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>/collaborators&<USER_ACCESS_TOKEN>

Exemple de réponse

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

Paramètres du chemin

Espace réservéValeur

<API_VERSION>

Version de l’API.

<IG_MEDIA_ID>

Obligatoire. ID du contenu multimédia Instagram de l’utilisateur ou utilisatrice de votre application.

Paramètres de la chaîne de requête

CléEspace réservéValeur

access_token

<USER_ACCESS_TOKEN>

Obligatoire. Token d’accès utilisateur·ice de l’utilisateur ou utilisatrice de votre 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
  • 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.