Sometimes, third-party API documentation, such as Facebook, LinkedIn, etc., does not clearly or promptly reflect metric deprecation schedules. To detect this issue faster and receive a prompt solution, I’ll share a recent example our team experienced. In this particular case, Facebook did not provide adequate alerts about metric deprecations, causing the sources to break. However, by reviewing the error message, we were able to quickly identify the issue and report it to the support team for faster resolution.
Error Message Example:
“message”: "All extraction requests failed (1). The extraction is configured to require at least one successful request. (request_policy="atLeastOne"). First unsuccessful request: {"status":"400 Bad Request","body":"{\"error\":{\"message\":\"(#100) Starting from version 21+, the following metrics are no longer supported for time series: email_contacts, profile_views, text_message_clicks, website_clicks, get_directions_clicks, phone_call_clicks. Instead, please refer to the documentation at https:\\/\\/developers.facebook.com\\/docs\\/instagram-api\\/reference\\/ig-user\\/insights for a list of supported metrics.\"}}"
As you can see, the error message provides the reason for the issue, lists the deprecated metrics, and includes a link to the updated documentation.
Steps to Fix the Issue
1. Review the Error Message
Analyze the error message carefully to understand the cause of the issue and identify the deprecated metrics.
2.Communicate with the Support Team
Report the issue to the support team, providing all relevant details, including the error message, for a faster resolution.