DFP API v2201211 출시 발표
2012년 11월 30일 금요일
2012.11.29
Adam Rogal (DFP API Team)
원문참고: http://googleadsdeveloper.blogspot.com/2012/11/announcing-v201211-of-dfp-api.html
DFP API v201211을 출시했습니다. 이번 버전은 API 강화에 중점을 두어 개발자가 API 문제를 접하게 될 때 더욱 폭넓은 선택을 할 수 있도록 했습니다. 특히 정체 불명의 SERVER_ERROR를 피하고 새로운 기능으로 작업할 수 있는 신규 오브젝트를 상당수 추가하였습니다. 또한 새로운 creative 래퍼 서비스와 기타 소규모 기능들을 출시하였습니다. 해당 내용은 모두 릴리즈 노트에서 확인하실 수 있습니다.
에러 핸들링 개선
오늘부로 API에 추가된 두 가지 새로운 기능은 호출이 계획대로 실행되지 않을 때 예외를 처리하는 법을 더욱 용이하게 합니다. 첫 번째는 UnsupportedCreative 타입입니다. 일전에 이전 버전 API를 사용하여 새로운 creative를 가져오려고 했다면 “프로세싱 중에 오류 발생” 이라는 SERVER_ERROR, 또는 502 HTTP 오류 상태 코드를 받았을 것입니다. 이제 API가 해당 버전에서 정의되지 않은 creative를 가져오고 있는 것을 감지하면, UnsupportedCreative로 creative를 반화할 것입니다. 반환된 creative는 베이스 타입의 모든 필드와 지원되지 않는 creative 타입이 무엇이었는지 알려주게 됩니다.
두 번째 개선점은, 현존하는 모든 ApiError 타입에 새로운 enum UNKNOWN을 추가했습니다. UNKNOWN으로 ApiError를 받으면 해당 예외를 별도로 기록할 수 있게 됩니다 (try/catch 블락에서 에러를 검토). 그리고 해당 에러 내용을 포럼에 알려주시면 문제 발생의 원인을 찾아갈 수 있도록 도움을 드리겠습니다. 추후에 UNKNOWN을 더욱 많은 enum에 추가하여 API 버전이 실제 enum 값을 나타내지 못하면 심각한 장애 없이 오브젝트를 가능한 진행할 수 있도록 할 것입니다.
참고: UnsupportedCreative와 UNKNOWN enum 선택은 모든 API 버전에 추가되었습니다. 따라서 모든 버전과 서비스를 위한 WSDL이 변경되었습니다. 실패한 API 호출은 아마 아무 정보도 주지 않을 것입니다. 다만 새로운 변경사항들은 기존 버전에서 해당 변경 사항의 혜택을 받기 위하여 클라이언트 코드를 재생시키거나 클라이언트 라이브러리의 새로운 버전을 다운로드 할 수 있는 선택 사항을 제공하게 됩니다. v201211 이전 버전에서는 지원되지 않는 creative는 반환되는 대신에 필터링될 것입니다.
Deprecation 공지
지난 10월에 말씀 드렸듯, v201108, v201111, v201201는 더 이상 사용되지 않고 12월 10일에 중단될 예정입니다. 새 버전으로 업그레이드 하지 않으신 분은 이 기회에 업그레이드 하시길 바랍니다. 기타 구체적인 질문이 있으시면 포럼에 문의하시면 도와 드리겠습니다.
DFP 구글 개발자 라이브(GDL) 세션 예정
12월 5일에 GDL 세션을 개최하여 몇몇 DFP API 개발자들을 인터뷰하고 다른 개발자들을 위한 팁을 들어보는 시간을 가지려고 합니다..
Ads Developer Google+ page에 팔로잉 하세요. 조만간 훌륭한 팁을 소개할 예정입니다. 여러분의 요청 사항도 환영합니다.