Version 10.0

API Graph

Publiée le 23 février 2021 | Disponible jusqu’au 8 juin 2023 | Publication de blog

Applications Business

Niveaux d’accès

S’applique à toutes les applications créées après le 16 février 2021.

Toutes les apps de type Entreprise créées après le 16 février 2021 disposeront automatiquement d’un accès standard aux autorisations email et public_profile.

S’applique à toutes les applications existantes créées après le 16 février 2021.

Toutes les apps de type Entreprise créées avant le 16 février 2021 disposeront automatiquement d’un accès avancé aux autorisations email et public_profile. Les apps qui n’utilisent pas les autorisations email et public_profile seront rétrogradées à l’accès standard pour ces deux autorisations.

Les apps de type Entreprise peuvent passer à l’accès avancé pour les autorisations email et public_profile sans avoir à passer le Contrôle app.

Groupes

S’applique aux versions 10.0 et supérieures. Toutes les autres versions seront concernées à partir du 25 mai 2021.

• Pour s’aligner sur les autres règles de conservation des données de Facebook, l’API Groups inclura uniquement les données créées au cours des 90 derniers jours. Les données fournies dépendront du niveau d’accès ou du mode de votre application et de votre rôle au sein de celle-ci.
• L’API Groups utilisera désormais un système d’accès d’API à deux niveaux, standard et privilégié, à la place des modes développeur et en ligne. Le niveau d’accès standard permet uniquement de récupérer les données des utilisateurs ayant un rôle dans votre application, tandis que le niveau d’accès privilégié vous permet de récupérer les données de tous les utilisateurs du groupe dans lequel l’application est installée.

Pages

Point de terminaison rétabli

S’applique aux versions 10.0 et supérieures. Toutes les autres versions seront concernées à partir du 25 mai 2021.

Le point de terminaison DELETE /{page-id}/tabs qui avait été abandonné dans la version 8.0 a été rétabli dans la version 10.0 et sera rétabli dans toutes les versions le 25 mai 2021.

Partage des menaces

Suppression des données expirées

Toutes les autres versions seront concernées à partir du 25 mai 2021.

Les données ajoutées à ThreatExchange avec une valeur expire_time différente de zéro seront supprimées de façon permanente à l’heure d’expiration indiquée. Si vous souhaitez supprimer des données qui ne sont plus valides, définissez le champ expired_on sur l’heure actuelle afin qu’elles soient immédiatement supprimées.

Par ailleurs, tous les ThreatDescriptors non Facebook sont supprimés de façon permanente à la date d’expiration paramétrée par le créateur. Si votre application comporte des ThreatDescriptors expirés que vous ne souhaitez pas perdre, vous devez repousser la date d’expiration ou la définir sur « 0 » pour que ces données n’expirent jamais.

URL

S’applique aux versions 10.0 et supérieures. Toutes les autres versions seront concernées à partir du 25 mai 2021.

Interactions

• Pour des raisons de confidentialité, le résultat renvoyé par une requête GET /?id={url}/engagement peut ne pas correspondre au résultat brut.
• Le nombre de requêtes concernant le champ GET /?id={url}/engagement de la même URL est limité à dix par heure.

API Marketing

Publiée le 23 février 2021 | Disponible jusqu’au 4 octobre 2021 | Publication de blog

Compte publicitaire

Modifications de champ

S’applique aux versions 10.0 et supérieures. Toutes les autres versions seront concernées à partir du 25 mai 2021.

Le champ agency_client_declaration du nœud AdAccount requiert désormais les droits d’administrateur pour tout type d’opération.

API Ads Insights

Mise à jour du paramètre date_preset

S’applique aux versions 10.0 et supérieures.

• Le paramètre lifetime (date_preset=lifetime) est désactivé et remplacé par date_preset=maximum, qui permet de récupérer jusqu’à 37 mois de données. L’API renverra une erreur lorsque les requêtes contiendront des plages de dates dépassant la période de 37 mois.
• Pour les versions 9.0 et antérieures, cette fonctionnalité restera inchangée jusqu’au 25 mai 2021. Après cette date, date_preset=maximum sera déployé et tous les appels lifetime auront une valeur par défaut de maximum. La réponse ne contiendra donc que 37 mois de données.

Business

Diminution des restrictions dʼaccès pour les points de terminaison

S’applique aux versions 10.0 et supérieures.

Dans la version 9.0, l’accès aux points de terminaison ci-dessous était restreint. L’accès a été rétabli pour toutes les applications, mais elles ne peuvent désormais cibler que les entreprises (ou filiales de ces entreprises) qui les ont réclamées :

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

Ciblage

Ciblage des connexions

Toutes les versions seront concernées à partir du 24 mai 2021.

Les points de terminaison suivants n’incluront plus le ciblage des connexions lors de la création ou de la modification d’une campagne publicitaire :

• POST /<ad_account_id>/adsets
• POST /<adset_id>

Ces modifications ne s’appliqueront pas aux campagnes en cours.

Audiences similaires

Les paramètres location_spec et country ne seront plus disponibles lors de la création d’audiences similaires. La zone géographique concernée par une audience similaire correspondra au pays figurant dans la spécification de ciblage de la campagne.

Compte tenu de cette modification, l’impact sur les campagnes existantes sera nul. Ce critère n’aura une incidence que sur les campagnes nouvelles et modifiées.

Les points de terminaison et les champs suivants sont concernés :

• POST /<ad_account_id>/customaudiences
• POST /<ad_account_id>/adsets
• POST /<ad_account_id>/adaccounts?adaccounts=<SHARED_TO_AD_ACCOUNT_ID>
• GET /<ad_account_id>/reachestimate
• GET /<ad_account_id>/delivery_estimate
• GET /<ad_account_id>?fields=approximate_count
• GET /<ad_account_id>?fields=delivery_status
• GET /<ad_account_id>?fields=operation_status

Consultez Audiences similaires : modifications à venir concernant les audiences similaires pour en savoir plus sur ces mises à jour.