Version 8.0

API Graph

Publiée le 4 août 2020 | Disponible jusqu’au 1er novembre 2022 | Publication de blog

Tokens d’accès

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis le 2 novembre 2020.

• GET /token_deprecation_check

Albums

Points de terminaison rétablis

S’applique à toutes les versions.

• GET /{album-id}/likes

Configuration de l’application

Types d’application

Cette modification concerne toutes les versions.

Les applications nouvellement créées peuvent désormais choisir un type d’app : Entreprise, Jeux vidéo ou Aucun. Cela simplifie l’interface Contrôle app en supprimant les autorisations et fonctionnalités inappropriées en fonction du type choisi. En outre, les applications dotées du type Entreprise utilisent un nouveau mécanisme d’autorisation, n’ont plus recours aux modes et ont accès à une nouvelle fonctionnalité. Pour plus d’informations, reportez-vous à l’entrée du changelog relative aux applications d’entreprise.

Applications Business

Les applications dotées du type Entreprise utilisent un nouveau mécanisme d’autorisation appelé niveaux d’accès. Les niveaux d’accès remplacent la fonctionnalité fournie par le mode développement et par le mode en ligne, qui ont été supprimés pour les applications d’entreprise. Les niveaux d’accès simplifient le processus Contrôle app et le rendent plus intuitif. En outre, une nouvelle fonctionnalité Accès au profil utilisateur par les ressources professionnelles a été publiée. Elle permet aux applications d’entreprise de lire un ensemble restreint de champs d’utilisateur publics. Ces modifications sont décrites en détail ci-dessous.

Niveaux d’accès

S’applique à toutes les versions.

Les niveaux d’accès désignent un nouveau mécanisme d’autorisation de l’API Graph conçu pour les applications d’entreprise qui s’applique aux autorisations et fonctionnalités de manière individuelle. L’accès standard permet uniquement d’accéder aux données détenues par les utilisateurs qui disposent d’un rôle sur l’application ou d’un rôle dans une entreprise ayant revendiqué l’application. L’accès avancé permet d’accéder aux données appartenant à tout utilisateur de l’application, mais nécessite le processus Contrôle app. L’accès standard est automatiquement accordé aux applications d’entreprise pour toutes les autorisations et fonctionnalités disponibles pour ce type d’application.

Suppression du mode développement et du mode en ligne

S’applique à toutes les versions.

Le mode développement et le mode en ligne ont été supprimés pour les applications d’entreprise. Ces modes ont été remplacés par les niveaux d’accès, qui offrent les mêmes fonctionnalités et un surcroît de polyvalence. En effet, puisque les applications d’entreprise disposent d’un accès standard pour toutes les autorisations et fonctionnalités disponibles, tous les utilisateurs qui disposent d’un rôle sur l’application ou d’un rôle dans une entreprise ayant revendiqué l’app peuvent accorder à l’application n’importe quelle autorisation disponible à tout moment. Cela élimine la nécessité de recourir au processus Contrôle app ou d’alterner entre les modes au cours du développement.

Nouvelle fonctionnalité Accès au profil utilisateur par les ressources professionnelles

S’applique à toutes les versions.

La nouvelle fonctionnalité Accès au profil utilisateur par les ressources professionnelles permet aux applications d’entreprise de lire un ensemble restreint de champs publics sur un utilisateur, à condition que cet utilisateur ait interagi avec des ressources qui appartiennent à une entreprise ayant revendiqué l’application. Pour obtenir la liste des champs utilisateur lisibles, reportez-vous à la référence concernant la fonctionnalité Accès au profil utilisateur par les ressources professionnelles.

Commentaires

Points de terminaison rétablis

S’applique à toutes les versions.

• GET /{comment-id}/likes

Appareils

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis le 2 novembre 2020.

• POST /device/share

Groupes

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{group-id}/posts

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis le 2 novembre 2020.

• GET /{group-post-id}/likes

Instagram

Nouveau point de terminaison oEmbed Instagram

S’applique à toutes les versions.

Un nouveau point de terminaison GET /instagram_oembed a été introduit. Il offre les mêmes fonctionnalités que les points de terminaison oEmbed existants d’Instagram, qui sont obsolètes depuis le 24 octobre 2020. Ce nouveau point de terminaison nécessite un token d’accès. Vous aurez donc besoin d’un compte de développeur Facebook et d’une app enregistrée pour y accéder. Pour obtenir des instructions d’utilisation et des informations complémentaires, reportez-vous au document concernant oEmbed Instagram.

Évènements marquants

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{life-event-id}
• GET /{life-events-id}/photos

Liens

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{link-id}/reactions

Vidéos en direct

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{live-video-id}/likes

Utilisez le point de terminaison GET /{live-video-id}/reactions pour obtenir des mentions « J’aime » pour une vidéo en direct.

Paramètre save_vod

S’applique aux versions 8.0 et supérieures. Toutes les autres versions sont concernées depuis le 2 novembre 2020.

Le paramètre save_vod est obsolète pour les arêtes suivantes :

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Plateforme Messenger

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

Contrôle app

S’applique à toutes les versions.

Le processus Contrôle app pour Messenger a été déplacé de Produits > Messenger > Paramètres vers Contrôle app dans l’espace app. Pour demander les autorisations propres à Messenger, pages_messaging, pages_user_gender, pages_user_locale et pages_user_timezone, accédez à Contrôle app > Autorisations et fonctionnalités. Pour en savoir plus, reportez-vous à la documentation sur Contrôle app pour Messenger.

Arête Messenger Profile

S’applique aux versions 8.0 et supérieures.

Le type de menu persistant imbriqué est devenu obsolète pour POST /{page-id}/messenger_profile.

Nouvelle fonctionnalité : Messenger pour les boutiques

S’applique aux versions 8.0 et supérieures.

Prise en charge des envois et des réceptions de produits sur Messenger pour les boutiques. Cela inclut le modèle de produit utilisable pour l’envoi de produits dans des messages, les webhooks des messages associés à un modèle de produit et des messages provenant de la page de détails d’un produit des Boutiques Facebook, ainsi que les webhooks echo pour les messages associés à des produits.

• GET /{message_id}/access_requests
• POST {page_id}/message
• message_echo Webhook
• messages Webhook

Offres natives

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis le 2 novembre 2020.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

Pages

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

Publication de Page

Ces éléments ne sont plus pris en charge dans aucune des versions.

Le format ID de commentaire de publication de Page, {page-id}_{post_id}_{comment-id}, est désormais obsolète. Utilisez le format {pagepost-id}_{comment-id} à la place.

Photos

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans aucune des versions.

• GET /{photo-id}/sharedposts

Lieux

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{place-information-id} (voir Corrections)

Publications

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis le 2 novembre 2020.

• GET /{post-id}/likes

Utilisez le point de terminaison GET /post/reactions pour obtenir des mentions « J’aime » pour une publication.

Recherche

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis le 2 novembre 2020.

• GET /search?type=place
• GET /search?type=audience_interest

Paramètres de sécurité

Champs obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis novembre 2020.

• secure_browsing

Social Plugins

Points de terminaison oEmbed Facebook

Cette modification s’applique à toutes les versions depuis le 24 octobre 2020.

Les points de terminaison oEmbed Facebook, qui permettent aux applications de récupérer le code d’intégration HTML pour les publications et vidéos Facebook publiques, sont devenus obsolètes le 24 octobre 2020. Trois nouveaux points de terminaison ont été introduits et fournissent les mêmes fonctionnalités que les points de terminaison qu’ils remplacent :

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

Ces nouveaux points de terminaison nécessitent un token d’accès, et les requêtes seront soumises à un plafond. Pour obtenir des détails d’utilisation et des informations complémentaires, reportez-vous à la documentation concernant les nouveaux points de terminaison oEmbed.

Utilisateur·ices

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{user-id}/taggable_friends

Champs obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis novembre 2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Ces éléments ne sont plus pris en charge dans aucune des versions.

• can_review_measurement_request
• is_famedeeplinkinguser

Réautorisation

Cette modification concerne toutes les versions.

Depuis le 24 octobre 2020, les champs suivants nécessitent une réautorisation d’accès aux données après 90 jours d’inactivité :

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

Image de l’utilisateur

Concerne toutes les versions à partir du 24 octobre 2020.

À compter du 24 octobre 2020, le point de terminaison GET /{user-id}/picture (GET /{user-id}?fields=picture) nécessite un ID utilisateur spécifique à une application (ASID) pour les requêtes sans token. Si vous interrogez l’utilisateur sans ASID, vous devez inclure un token d’accès d’app, client ou utilisateur dans la requête. Pour plus d’informations, reportez-vous à la référence concernant l’image utilisateur.

Questions vidéo

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures. Ils ne sont plus pris en charge dans aucune des versions depuis le 2 novembre 2020.

• GET /{company-id}/access_requests
• GET /access_requests

API Marketing

Publiée le 4 août 2020 | Disponible jusqu’au 4 mai 2021 | Publication de blog

Comptes publicitaires

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

Autorisations

S’applique aux versions 8.0 et supérieures. Toutes les autres versions sont concernées depuis le 2 novembre 2020.

Les applications nécessitent des autorisations granulaires pour accéder aux champs d’entreprise d’un compte publicitaire. Les autorisations doivent être accordées pour un objet d’entreprise spécifique.

Règles de personnalisation des ressources

Validation

S’applique aux versions 8.0 et supérieures.

Toutes les publicités utilisant asset_feed_spec doivent contenir au moins deux règles de personnalisation de cible. Si votre contenu publicitaire utilise asset_feed_spec et comporte moins de deux règles, vous ne pourrez pas créer cette publicité.

Cette modification concerne la personnalisation des éléments de placement, les publicités multilingues et la personnalisation des éléments de segment.

Personnalisation des éléments de segment

S’applique aux versions 8.0 et supérieures. Toutes les autres versions sont concernées depuis le 2 novembre 2020.

Tous les cas d’utilisation non liés à la géolocalisation sont désormais obsolètes pour les utilisateurs de la personnalisation des éléments de segment. Du fait de cette modification, toutes les règles de ciblage doivent intégrer des informations de géolocalisation à leur spécification de personnalisation. La règle par défaut fait exception. Elle n’a pas besoin d’inclure de géolocalisation.

Enchères

Stratégie d’enchère du coût cible

S’applique aux versions 8.0 et supérieures.

La stratégie d’enchère TARGET_COST est obsolète. Pour continuer à contrôler les coûts, nous vous recommandons d’utiliser les enchères de plafond de coût. Consultez toutes les stratégies d’enchères disponibles.

Business Manager

Points de terminaison obsolètes

Ces éléments ne sont plus pris en charge dans les versions 8.0 et supérieures.

• GET{system-user-id}/updated_by

Réintroduction des points de terminaison d’accords de partage

Concerne toutes les versions.

Les points de terminaison suivants ont été réintroduits :

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

Ces deux points de terminaison avaient précédemment été abandonnés avec le lancement de l’API Graph V6.0.

Canevas

Points de terminaison obsolètes

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

API Catalog

Autorisations

S’applique aux versions 8.0 et supérieures. Toutes les autres versions sont concernées depuis le 31 janvier 2021.

Vous n’avez plus besoin de l’autorisation ads_management pour accéder aux points de terminaison de catalogue produits. À l’avenir, vous devrez disposer de l’autorisation catalog_management pour appeler ces points de terminaison. Les développeurs qui ont eu accès aux points de terminaison de catalogue via ads_management au cours des 90 derniers jours ont été automatiquement migrés vers les autorisations catalog_management avant le 14 août 2020.

Entre cette date et le 28 février 2021, les développeurs utilisant des versions antérieures de l’API étaient toujours en mesure d’appeler les points de terminaison de catalogue produits avec l’autorisation ads_management. Si vous utilisez la version 8.0, vous devrez disposer de l’autorisation catalog_management.

Après la date limite de février, l’autorisation catalog_management n’est plus associée à ads_management. Par conséquent, les utilisateurs doivent explicitement accorder l’autorisation catalog_management à votre application.

Authentification

S’applique aux versions 8.0 et supérieures. Toutes les autres versions sont concernées depuis le 2 novembre 2020.

[MIS À JOUR] Les points de terminaison suivants de l’API Catalog respectent désormais les paramètres professionnels d’authentification à deux facteurs. Toutes les applications appelant ces points de terminaison obtiendront un message d’erreur si l’entreprise qui possède le catalogue requiert une authentification à deux facteurs pour l’utilisateur actuel de l’application, et que celui-ci ne s’est pas authentifié avec cette méthode.

Lorsque l’utilisateur actuel de l’application dispose d’un accès au catalogue par le biais d’une entreprise partenaire, nous respectons les exigences d’authentification de l’outil Business Manager du partenaire. Les utilisateurs système n’ont pas besoin de s’authentifier par le biais de deux facteurs.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

Rapports

Abandons

S’applique aux versions 8.0 et supérieures.

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

Ciblage

Abandon

S’applique aux versions 8.0 et supérieures.

• GET /search?type=adzipcode

Corrections

• 28 septembre 2020 — Mise à jour de l’entrée d’authentification de l’API Catalog pour plus de clarté.
• 23 octobre 2020 — Mise à jour de l’entrée de l’API Catalog :

  • Nous avons prolongé la période pendant laquelle les développeurs utilisant des versions antérieures de l’API seront encore en mesure d’appeler les points de terminaison de catalogue produits avec l’autorisation ads_management. La nouvelle date limite était fixée au 28 février 2021.
  • Nous avons ajouté des clarifications concernant l’authentification des utilisateurs système.
• 17 mai 2021 — Changement d’abandon de point de terminaison de GET /{place-id} à GET /{place-information-id}. GET /{place-id} n’a pas été abandonné.