WHO
Microsoft Advertising 레거시 SOAP API(SOAP 직접 HTTP 호출 또는 구버전 Bing Ads SDK: .NET／Java 13.0.22 미만, Python bingads 패키지, PHP microsoft/bingads)로 입찰·리포트·계정 자동화를 운영하는 애드테크 엔지니어, 대행사 엔지니어, 사내 그로스／마케팅／데이터 엔지니어 — 아직 REST／새 msads SDK로 전환을 마치지 못한 팀.
MsAdsSoap · 대기 명단
1/31 전에 Microsoft Advertising SOAP API에서 옮기세요 — 어떤 SDK로 올릴지, 어떤 REST 경로로 갈지, 무엇을 다시 테스트할지 파악
새 API 기능·개선은 REST 전용. 기존 SOAP 연동은 계속 작동.
SOAP API 완전 지원 종료(full deprecation).
시간이 더 필요하다면: 복잡한 연동은 Microsoft Advertising 지원팀 또는 계정 팀에 연장 마이그레이션 계획을 요청할 수 있습니다.
날짜는 Microsoft Learn「Migrate to REST API」와 Microsoft Advertising 공식 블로그(2026년 4월 1일) 기준. Microsoft는 API 액세스 영향을 피하려면 2026년 10월 1일 전 이전을 권장.
10월 1일부터 새 API 기능은 REST 전용 — 기존 SOAP 연동은 2027년 1월 31일 SOAP 완전 지원 종료까지 계속 작동합니다. 4가지 질문에 답하세요 — SOAP 직접 호출인지 구버전 SDK인지(어떤 언어), REST 전용 새 기능이 필요한지, REST나 msads를 시도했는지, 연동이 얼마나 복잡한지. 타임라인 리스크, SDK 업그레이드 또는 REST 매핑 단계, 회귀 체크리스트를 받으세요. developer token, OAuth 토큰, client secret, 계정 ID, 코드를 붙여 넣지 마세요.
독립 도구. Microsoft와 제휴 또는 보증 관계 없음 · 시장 검증 페이지 · 무료 대기 명단 · Microsoft Advertising에 연결하지 않음
문제
두 가지 날짜: 10/1 · 1/31
Microsoft Learn과 Microsoft Advertising 공식 블로그에 따르면 API는 레거시 SOAP에서 REST로 두 단계에 걸쳐 전환됩니다. 2026년 10월 1일부터 모든 새 API 기능·개선은 REST로만 제공되고, 기존 SOAP 연동은 전환 기간 동안 즉각적인 영향 없이 계속 작동합니다. 2027년 1월 31일 SOAP API는 완전 지원 종료됩니다. Microsoft는 API 액세스 영향을 피하려면 2026년 10월 1일 전 이전을 권장하며, 두 날짜 사이는 대부분 광고주의 Q4 성수기와 겹칩니다. 공식 가이드는 충실하지만 migrate, Python, PHP 가이드와 API 레퍼런스에 흩어져 있습니다.
Before
- migrate 페이지, Python／PHP 가이드, API 레퍼런스를 오가며 대조
- 두 날짜를 혼동해 당황하거나, 시간이 많다고 생각해 성수기를 넘김
- 2027년 2월에 입찰·리포트 작업 실패를 발견
After — MsAdsSoap와 함께
- 4문항으로 내 언어와 서비스에 해당하는 경로와 변경점만
- 10/1＝새 기능 REST 전용, 1/31＝SOAP 완전 종료를 명확히 구분하고 성수기 표시
- sandbox 회귀 목록＋서비스별 검증＋롤백 스위치로 1/31 전 전환
공식 타임라인(Microsoft Learn＋Microsoft Advertising 공식 블로그)
| 날짜 | 상태 | 변경 내용 |
|---|---|---|
| 2024년 | 출시 | REST API 출시(공식 블로그). |
| 2026년 4월 1일 | 발표 | 공식 블로그 「Evolving the Microsoft Advertising API platform」에서 REST 전환 발표. 기존 SOAP 연동에 즉각적인 영향 없음. |
| 2026년 10월 1일 | 새 기능 REST 전용 | 모든 새 Microsoft Advertising API 기능·개선은 REST API로만 제공. 기존 SOAP 연동은 전환 기간 동안 계속 작동. |
| 2027년 1월 31일 | SOAP 완전 지원 종료 | SOAP API 완전 지원 종료(full deprecation) 예정 — 최종 기한. |
Microsoft는 API 액세스 영향을 피하려면 2026년 10월 1일 전 이전을 권장합니다. 시간이 더 필요한 대규모·복잡한 연동은 Microsoft Advertising 지원팀 또는 계정 팀에 연장 마이그레이션 계획을 요청할 수 있습니다(연장 기간 비공개). 릴리스 노트는 대규모 개발을 성수기 밖에서 마치라고 권장합니다 — 10/1~1/31은 대부분 광고주의 연말 성수기와 겹칩니다.
솔루션
MsAdsSoap가 하는 일
아직 SOAP／구버전 SDK를 쓰는 광고 자동화 팀을 위한 Microsoft Advertising SOAP → REST 전환 준비 의사결정 레이어: 연동 방식 × 언어 × 새 기능 필요 여부 × 진행 상황 × 복잡도 → 타임라인 리스크＋경로＋매핑＋회귀 체크리스트. Microsoft Learn 대체재도, API 커넥터도 아니며 Microsoft와 제휴 관계가 없습니다.
PROBLEM
2026년 10월 1일부터 모든 새 API 기능·개선은 REST 전용(기존 SOAP 연동은 전환 기간 동안 계속 작동, 즉각적인 영향 없음). 2027년 1월 31일 SOAP API 완전 지원 종료. 경로는 언어별로 다릅니다 — .NET／Java는 SDK를 최신 버전으로, Python／PHP는 새 msads 패키지로(import／namespace, enum, 예외, 인증 헤더 모두 변경), SDK 없음은 REST URL＋JSON으로. 문서는 migrate, Python, PHP 가이드와 API 레퍼런스에 흩어져 있습니다.
SOLUTION
4문항에 답하면 개인별 타임라인 리스크, SDK 업그레이드 경로 또는 REST 매핑 단계, SOAP → REST 코드 변경 매핑표, 회귀 체크리스트를 제공합니다. developer token, OAuth 토큰, client secret, 계정／고객 ID, 소스 코드는 절대 요구하지 않으며, Microsoft Advertising 커넥터가 아닙니다.
RESULT
10/1이 나에게 단순한 '새 기능 게이트'인지 실제로 로드맵을 가로막는지, 1/31 전에 어떤 SDK로 올리고 어떤 REST 호출을 바꿔야 하는지 알고, Q4 성수기 전에 sandbox 회귀를 마칩니다. 2027년 2월에야 입찰·리포트 작업 실패를 발견하는 일은 없습니다.
언어별 SDK／REST 경로(Microsoft Learn 기준)
| 현재 구성 | 공식 경로 |
|---|---|
| .NET／Java, Bing Ads SDK 13.0.22 미만 | 최신 SDK로 업그레이드(2026년 8월 4일 릴리스 노트 기준 13.0.29)하고 사용하는 서비스를 하나씩 검증. |
Python, 모든 버전의 bingads 패키지 | msads(pip install msads)로 전환＋아래 변경 매핑표의 코드 변경. |
PHP, Composer microsoft/bingads | Composer microsoft/msads로 전환＋namespace·클래스 변경. |
| SDK 없음(SOAP 직접 호출) | REST API URL＋JSON 요청으로 이전(API 레퍼런스의 각 메서드에 REST URL과 예제 있음). Microsoft는 SDK 도입을 권장. |
.NET／Java 13.0.22 이상인가요? 13.0.22는 주로 Customer Management／Billing을 REST로 옮긴 릴리스이므로, 최신 SDK로 올리고 사용하는 모든 서비스를 검증하는 것이 안전합니다. Microsoft Learn에 .NET／Java 코드 수준 마이그레이션 가이드가 없으므로 세부 내용을 지어내지 않습니다.
기능
기능
제품 가설에 기반한 마케팅 포인트입니다. 수요 검증용이며 정식 사양에 대한 약속이 아닙니다.
타임라인 리스크
새 기능이 필요하다면? 10/1부터 REST 전용입니다. 아니라면 최종 기한은 2027년 1월 31일. 연동이 복잡하다면 연장 마이그레이션 계획을 검토. 각 날짜까지 남은 일수 표시.
언어별 SDK／REST 경로
.NET／Java 13.0.22 미만 → 최신 SDK로 업그레이드. Python bingads → msads. PHP microsoft/bingads → microsoft/msads. SDK 없음 → REST URL＋JSON.
SOAP → REST 변경 매핑
AuthenticationToken → Authorization: Bearer, import와 namespace, enum, 배열, WebFault／SoapFault → ApiException, REST 호스트.
서비스 점검
Campaign Management, Bulk, Reporting, Customer Management, Customer Billing, Ad Insight: 서비스별 호스트, SDK 클래스, 검증할 호출.
회귀 체크리스트
먼저 sandbox에서 테스트하고, 리포트와 bulk 출력을 비교하고, 입찰 변경·오류 처리·enum·토큰 갱신을 검증한 뒤 롤백 스위치와 함께 운영을 전환.
SOAP → REST 변경 매핑표(공식 가이드에 명시된 항목만)
| 항목 | SOAP／구버전 SDK | REST／msads |
|---|---|---|
| 인증 헤더(SDK 없음) | AuthenticationToken: {token} | Authorization: Bearer {token} |
| Python 의존성 | suds-jurko | urllib3／pydantic |
| Python 데이터 모델 import | bingads.v13 | openapi_client.models.campaign／customer／bulk／reporting |
| Python 배열 | ArrayOf*, response.CampaignIds['long'] | list, response.CampaignIds |
| Python 호출 | 위치 인수／suds factory; suds_options, set_elements_to_none() | _request= 키워드 인수; model 직접 생성(factory는 호환 레이어로 유지); suds_options와 set_elements_to_none() 제거 |
| Python enum／플래그 enum | 기존 대소문자; 공백 구분 문자열 | 모두 대문자; 비트 연산 | |
| Python 예외 | WebFault | ApiException(openapi_client.exceptions) |
| PHP 실행 환경 | ext-soap | PHP ^7.4 || ^8.0, ext-soap 불필요, guzzle 사용 |
| PHP namespace | Microsoft\BingAds\ | Microsoft\MsAds\Rest\ |
| PHP 클라이언트 | ServiceClient | CampaignManagementServiceApi 등 *ServiceApi 클래스(async 메서드 제공) |
| PHP 계정 컨텍스트 | 헤더 | AccountId／CustomerId를 AuthorizationData에 설정; 토큰 갱신 후 refreshAuthorizationData() 호출 |
| PHP 스타일／예외 | SoapVar; SoapFault | 메서드 camelCase, getter／setter, enum UPPER_SNAKE, SoapVar 제거; ApiException |
| 호스트 | SOAP 서비스 엔드포인트 | campaign.api. / bulk.api. / reporting.api. / clientcenter.api. / adinsight.api.bingads.microsoft.com(sandbox: *.api.sandbox.bingads.microsoft.com) |
Python msads도 ServiceClient와 authorization은 bingads.*에서 import합니다 — import bingads가 보여도 구 패키지라는 뜻은 아니니 설치된 패키지를 확인하세요. Python BulkServiceManager／ReportingServiceManager 인터페이스는 그대로입니다. .NET／Java는 코드 수준 매핑이 공개되지 않았으므로 최신 SDK로 올리고 서비스별로 검증합니다.
서비스 점검 — 서비스별 REST 호스트와 PHP 클래스
| 서비스 | REST 호스트(운영) | PHP msads 클래스 |
|---|---|---|
| Campaign Management | campaign.api.bingads.microsoft.com | CampaignManagementServiceApi |
| Bulk | bulk.api.bingads.microsoft.com | BulkServiceApi |
| Reporting | reporting.api.bingads.microsoft.com | ReportingServiceApi |
| Customer Management | clientcenter.api.bingads.microsoft.com | CustomerManagementServiceApi |
| Customer Billing | clientcenter.api.bingads.microsoft.com | CustomerBillingServiceApi |
| Ad Insight | adinsight.api.bingads.microsoft.com | AdInsightServiceApi |
sandbox: *.api.sandbox.bingads.microsoft.com — 회귀 테스트는 먼저 여기서. 공식 client libraries 페이지에 따르면 PHP SDK에는 BulkServiceManager／ReportingServiceManager가 없으므로 다운로드／업로드 흐름을 직접 처리해야 합니다.
작동 방식
작동 방식
3단계. Microsoft Advertising 연결도, 토큰도 필요 없습니다.
- 1
4가지 질문에 답하기
SOAP 직접인가요, 구버전 SDK인가요? 언어는? 10/1 이후 새 기능 필요? REST나 msads 시도? 연동 복잡도는?
- 2
타임라인 리스크와 경로 확인
10/1 새 기능 게이트 vs 1/31 최종 기한을 개인별로 평가하고, 언어별 SDK 업그레이드 또는 REST 매핑 단계를 제시. 모두 Microsoft Learn 링크 포함.
- 3
변경·재테스트·전환
SOAP → REST 변경 매핑표, 서비스 점검, sandbox 회귀 체크리스트 — 토큰·시크릿·계정 ID·코드 불필요.
사용 사례
이런 팀에
이런 상황이 익숙하다면 대기 명단에 등록해 검증을 도와주세요.
자체 입찰 엔진(Python bingads)
매시간 입찰가 변경. msads 마이그레이션 목록(import, _request=, enum, 예외)과 sandbox 입찰 회귀 테스트가 필요 — 성수기 전에 완료.
대행사 멀티 클라이언트 리포트 파이프라인(구버전 .NET SDK 13.0.x)
Reporting＋Bulk 스케줄. SDK가 13.0.22 미만인지 확인하고, 최신 버전으로 올리고, 서비스별로 리포트 출력 일치 검증.
PHP 계정 관리 백오피스
Customer Management＋Billing. namespace와 *ServiceApi 매핑, AuthorizationData에 AccountId／CustomerId 설정 필요.
SDK 없는 SOAP 직접 연동(Go／Node／Ruby 등)
REST 호스트, Authorization: Bearer 헤더, JSON 요청이 필요하고, 공식 SDK 도입 여부도 판단.
10/1 이후 새 기능을 쓰려는 제품 팀
새 기능은 REST 전용이므로, 기존 SOAP 부분이 계속 작동하더라도 관련 서비스를 먼저 이전해야 합니다.
대규모 애드테크 플랫폼
서비스도 계정도 많음. 지원팀／계정 팀에 연장 마이그레이션 계획을 요청할지, 요청 전에 준비할 점검 목록을 판단.
공개 시그널
Microsoft 공개 시그널
Microsoft Learn 공식 문서와 Microsoft Advertising 공식 블로그만 — 추천 후기가 아닌 공개 시그널입니다. 고객 인용, 보증, 로고, 지어낸 수치는 없습니다.
- Microsoft Learn — REST API로 마이그레이션10/1부터 새 기능 REST 전용, 1/31 완전 지원 종료, 언어별 마이그레이션 경로, 연장 계획.
- Microsoft Advertising 공식 블로그 — Evolving the Microsoft Advertising API platform(2026년 4월 1일)REST 전환 발표, 기존 SOAP 즉각 영향 없음, 1/31 지원 종료.
- Microsoft Learn — Python SDK 마이그레이션: SOAP에서 REST로bingads → msads, import／enum／예외／헤더 변경, REST 호스트.
- Microsoft Learn — PHP SDK 마이그레이션: SOAP에서 REST로microsoft/bingads → microsoft/msads, namespace, *ServiceApi 클래스.
- Microsoft Learn — 릴리스 노트(Bing Ads API v13)SDK 13.0.29(2026년 8월 4일), 성수기 외 개발 권장.
자주 묻는 질문
자주 묻는 질문
MsAdsSoap는 Microsoft 공식 도구인가요?
아닙니다. 독립 도구이며 Microsoft와 제휴·보증 관계가 없습니다. 모든 정보는 Microsoft 공식 문서를 링크와 함께 인용합니다.
10월 1일에 SOAP 연동은 어떻게 되나요?
공식 문서에 따르면 기존 SOAP 연동은 전환 기간 동안 계속 작동합니다. 10/1부터 새 기능·개선은 REST로만 제공됩니다. SOAP는 2027년 1월 31일 완전 지원 종료됩니다. 다만 Microsoft는 영향을 피하려면 10/1 전 이전을 권장합니다.
Microsoft Learn과 뭐가 다른가요?
공식 문서는 언어별·페이지별로 모든 경우를 다룹니다. 우리는 연동 방식·언어·서비스·진행 상황에 맞춰 타임라인 리스크·경로·매핑·회귀 체크리스트를 제공합니다.
Microsoft Advertising 지원팀, 계정 팀, 컨설턴트와 뭐가 다른가요?
지원팀과 계정 팀은 계정과 연장 요청을 처리하고, 컨설턴트는 전체 마이그레이션 프로젝트를 수행합니다. MsAdsSoap는 가벼운 정적 셀프서비스 도구이며, 검증 기간 동안 대기 명단은 무료입니다.
.NET／Java SDK 13.0.22 이상이면 할 일이 없나요?
공식 지침은 13.0.22 미만이면 최신 버전으로 업그레이드하라는 것입니다(릴리스 노트 최신은 13.0.29). 13.0.22는 주로 Customer Management／Billing을 REST로 옮긴 릴리스이므로, 최신 버전으로 올리고 사용하는 모든 서비스를 검증하는 것이 안전합니다.
기한을 연장할 수 있나요?
Microsoft는 대규모·복잡한 연동으로 시간이 더 필요하면 Microsoft Advertising 지원팀 또는 계정 팀에 연장 마이그레이션 계획을 요청할 수 있다고 밝혔습니다. 연장 기간은 공개되지 않았으므로 약속하지 않습니다.
developer token, OAuth 토큰, client secret, 계정 ID, 코드를 요구하나요?
아닙니다. 요구하지 않고, 보유하지 않고, 저장하지 않습니다. Microsoft Advertising 계정에 연결하지 않습니다.
코드를 고치거나 이전 작업을 해 주나요?
아닙니다. MVP는 정적 설문＋경로＋매핑＋체크리스트＋대기 명단입니다.
Early Access는 언제인가요?
대기 명단에서 이메일로 순차 초대. 가짜 출시일을 만들지 않습니다.
MsAdsSoap는 독립 도구이며 Microsoft와 제휴 또는 보증 관계가 없습니다.
대기 명단
대기 명단 등록
업무용 이메일을 남기고 MsAdsSoap Early Access와 출시 소식을 받아 보세요. 이메일과 선택 체크박스／드롭다운만 있습니다 — 자유 입력란은 전혀 없습니다.
감사합니다 — MsAdsSoap 대기 명단에 등록되었습니다.
Early Access 초대와 출시 소식을 순차적으로 이메일로 보내 드립니다(출시일은 약속하지 않습니다). 확인 메일이 활성화된 경우 받은편지함을 확인하세요. 언제든 수신 거부할 수 있습니다.