API Graph pour Instagram

Limite de publication de contenu de l’utilisateur·ice Instagram

Représente l’utilisation actuelle de publication de contenu d’un·e utilisateur·ice Instragram.

Création

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

Lecture

GET /{ig-user-id}/content_publishing_limit

Fournit le nombre de fois où un·e utilisateur·ice Instagram a publié un Conteneur Instagram au cours d’une période donnée. Consultez le guide de publication de contenu pour en savoir plus sur cette fonctionnalité.

Conditions requises

TypeCondition requise

Tokens d’accès

Utilisateur·ice

Autorisations

instagram_basic
instagram_content_publish
pages_read_engagement


Si un rôle a été attribué à l’utilisateur·ice de l’application via Business Manager sur la Page connectée à l’utilisateur·ice Instagram cible, 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/v9.0/{ig-user-id}/content_publishing_limit
  ?fields={fields}
  &since={since}
  &access_token={access-token}

Paramètres de chaîne de requête

Espace réservé Description de la valeur

{access-token}
Chaîne
Obligatoire

Token d’accès de l’utilisateur·ice de l’application.

{fields}
Liste d’éléments séparés par une virgule

Liste de champs séparés par une virgule que vous souhaitez voir renvoyer. En cas d’oubli, le champ quota_usage sera renvoyé par défaut.

{since}
Horodatage Unix

Horodatage Unix de moins de 24 heures.

Champs

Champ Description de la valeur

config
Objet

Renvoie les valeurs suivantes :

  • quota_total : nombre maximal de Conteneurs Instagram que l’utilisateur·ice de l’application peut publier au cours de la période quota_duration (actuellement 50).
  • quota_duration : période en secondes par rapport à laquelle le quota_total est calculé (actuellement 86400 secondes ou 24 heures).

quota_usage
Liste d’éléments séparés par une virgule

Nombre de fois où l’utilisateur·ice de l’application a publié un Conteneur Instagram depuis l’heure spécifiée dans le paramètre de chaîne de requête since. Si le paramètre since est omis, cette valeur correspondra au nombre de fois que l’utilisateur·ice de l’application a publié un conteneur au cours des dernières 24 heures. Ce champ est renvoyé par défaut si le paramètre de chaîne de requête fields est omis de la requête.

Exemple de requête

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914/content_publishing_limit?fields=quota_usage,rate_limit_settings&since=1609969714&access_token=IGQVJ...'

Exemple de réponse

{
  "data": [
    {
      "quota_usage": 2,
      "config": {
        "quota_total": 50,
        "quota_duration": 86400
      }
    }
  ]
}

Mise à jour

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

Suppression

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