버전 자동 업그레이드를 지원하기 위한 마케팅 API 사용 중단과 관련하여 예정된 변경 사항
전반적인 API 경험을 더 원활하고 효율적인 방향으로 개선하고자 MAPI 버전 자동 업그레이드 기능이 출시될 예정임을 알려드립니다. 2024년 5월부터 Facebook에서는 버전 간에 영향을 받지 않는 마케팅 API 엔드포인트의 자동 버전 업그레이드 기능을 지원합니다. 즉, 사용 중단될 버전과 다음으로 사용 가능한 버전 간에 엔드포인트가 영향을 받지 않는 경우, Facebook 플랫폼은 요청 처리를 직접 거부하기보다 다음으로 사용 가능한 버전으로 호출을 자동으로 업그레이드합니다.
API 버전 관리는 API 변경 사항을 처리하는 데 흔히 사용되는 수단이며, 가장 일반적으로는 핵심 변경 사항을 제공하는 데 사용됩니다. 새로운 버전이 릴리스되면 이전 버전은 사용 중단됩니다. API가 사용 중단되는 동안, 앱이 사용 중단된 API 버전을 호출하는 경우 ‘(#2635) 광고 API의 사용 중단된 버전을 호출하고 있습니다. 최신 버전 vXXX(으)로 업데이트해 주세요’라는 오류를 수신합니다.
2024년 5월 14일에 v17.0이 사용 중단됩니다. v18.0 변경 사항에 따르면 영향을 받는 엔드포인트는 다음과 같습니다.
- POST /act_{ad-account-id}/reachfrequencypredictions
- GET /act_{ad-account-id}/reachestimate
- GET /act_{ad-account-id}/delivery_estimate
- POST /act_{ad-account-id}/adsets
- POST /{adset-id}
- POST /act_{ad-account-id}/saved_audiences
- POST /{saved-audience-id}
- POST /act_{ad-account-id}/credit_cards
2024년 5월 14일에 v17.0이 사용 중단된 후에 앱이 v17.0으로 POST /{adset-id} 호출을 보내는 경우, 다음으로 사용 가능한 버전인 v18.0의 영향을 받는 엔드포인트에 자동 업그레이드가 적용되지 않기 때문에 이 API 요청은 실패합니다.
v17.0이 사용 중단된 후에 앱이 v17.0으로 GET /{ad-account-id}/insights에 호출을 보내는 경우, Facebook 플랫폼이 다음으로 사용 가능한 버전인 v18.0으로 호출을 업그레이드합니다.
앱이 이미 v17.0보다 높은 버전으로 호출을 보내고 있는 경우, 버전 사용 중단 날짜와 관련하여 변경되는 사항은 없습니다.
버전 자동 업그레이드를 옵트아웃하려면 마케팅 API 앱 제품 카드 아래에서 설정 > 광고 API 버전 설정을 확인하여 이 기능을 비활성화하세요.
호출이 자동으로 업그레이드되었는지 확인하려면 API 응답 헤더에서 자세한 내용을 참조하세요.
- 알림 헤더 예시: ‘X-Ad-Api-Version-Warning:‘ v16.0이 사용 중단되었으므로 이 호출은 v17.0으로 자동 업그레이드되었습니다’
이 동작에 대한 자세한 내용은 마케팅 API 버전 관리를 참조하세요.
각 버전에서 영향을 받는 엔드포인트를 확인하려면 변경 사항을 참조하세요.
영향을 받는 엔드포인트
- 모든 MAPI 엔드포인트
개발자 문서 링크
기능에 대한 도움말 문서 링크
