API Graph

Version 2.5

API Graph | API Marketing

API Graph v2.5

Publiée le 7 octobre 2015 | Disponible jusqu’au 12 avril 2018

Cette version est arrivée à expiration le 12 avril 2018. Veuillez utiliser l’outil de mise à niveau de l’API pour mettre à niveau vos applications avant cette date. En savoir plus sur la mise à niveau de vos applications dans le guide de mise à niveau.

Nouvelles fonctionnalités

Pages

  • Autorisations

    • GET {user_id}/accounts requiert maintenant manage_pages ou pages_show_list ; ce dernier est une nouvelle autorisation dans la version 2.5.
    • POST {page_id}/call_to_actions et POST/DELETE {call-to-action-id} nécessitent la nouvelle autorisation pages_manage_cta introduite dans la version 2.5.

  • Gestion des call-to-action : les Pages peuvent désormais gérer les call-to-action sur une Page :

    • GET page/call_to_actions ou GET {call-to-action-id} pour lire un call-to-action.
    • POST page/call_to_actions pour ajouter un call-to-action à une page.
    • POST {call-to-action-id} pour le mettre à jour.
    • DELETE {call-to-action-id} pour supprimer le call-to-action d’une Page.

  • Nœud de lieu : le champ suivant a été ajouté au nœud Place :

    • overall_rating : il indique la note moyenne attribuée à un lieu, calculée sur la base des avis publics.

Vidéos

  • Importation de vidéos : les paramètres suivants ont été ajoutés :

    • slideshow_spec : générez des vidéos diaporama en important des images.
    • secret : la vidéo publiée n’apparaîtra pas dans le fil d’actualité, ni dans le journal, ni dans les onglets Vidéos de la Page Facebook. Il sera également impossible de la rechercher. Une vidéo pourra être vue et partagée uniquement au moyen d’un lien permanent. Pour les utilisateur·ices de la Page uniquement.
    • social_actions : autorisez ou interdisez l’utilisation des actions sociales de Facebook, comme les mentions J’aime, les commentaires et le partage d’une vidéo masquée. Pour les utilisateur·ices de la Page uniquement.

  • Montage vidéo : les paramètres suivants ont été ajoutés :

    • publish_to_videos_tab : partagez des éléments vidéo publiquement dans l’onglet Vidéos de la Page, et non dans le fil d’actualité ni sur le journal.
    • publish_to_news_feed : partagez des éléments vidéo publiquement dans le fil d’actualité, sur le journal d’une Page et dans l’onglet Vidéos d’une Page.

Modifications

Pages

  • Point de terminaison des publications identifiées : GET /{page-id}/tagged inclura toutes les publications publiques dans lesquelles la Page a été identifiée. Un token d’accès de Page avec l’autorisation manage_pages est requis.

Publications

  • story_tags : ce paramètre renvoie désormais un tableau à la place d’un objet.

Utilisateur·ices

  • GET /{user-id}?fields=address renvoie une erreur : le champ address, qui était disponible dans les versions précédentes et renvoyait une valeur vide, renverra une erreur à compter de la version 2.5.

Webhooks (anciennement Mises à jour en temps réel)

  • Désactivation automatique des abonnements : désormais, nous désactivons automatiquement les abonnements Webhooks si l’URL de rappel ne fonctionne pas pendant 7 jours consécutifs. Vous pouvez les réactiver en envoyant une requête POST à /subscriptions. Cette modification ne s’applique pas aux abonnements de paiement.

  • Mise à jour des abonnements existants : les abonnements actuels Webhooks peuvent être modifiés via l’API /subscriptions. POST /subscriptions modifiera l’abonnement pour un sujet donné sans remplacer les champs existants. Vous pouvez supprimer des champs particuliers de votre abonnement en incluant un paramètre fields lorsque vous appelez DELETE /subscriptions.

Abandons

  • Aucun abandon.

Modifications importantes avec un préavis de 90 jours

Pages

  • Format URI des applications de l’onglet Page : le format URI des applications de l’onglet Page https://www.facebook.com/{vanity}?v={app_id} cessera de fonctionner 90 jours après le lancement de cette version. Veuillez utiliser https://www.facebook.com/{vanity}?sk={app_id} ou https://www.facebook.com/{vanity}/{app_id}.

Webhooks

  • Nouvelles mises à jour en temps réel uniquement par HTTPS : les nouveaux abonnements ne peuvent pas être créés avec une URL de rappel non HTTPS. Cela concerne les mises à jour User, Page, App et Payment.