지원 중단 발표됨

이 페이지에는 Display & Video 360 API의 API 버전 및 개별 기능의 지원 중단일 및 서비스 종료일이 나와 있습니다.

API의 지원 중단 및 지원 종료일도 Google Ads 개발자 블로그에서 발표됩니다.

버전 지원 중단

Display & Video 360 API 버전은 정기적으로 출시, 지원 중단, 지원 종료됩니다. 이러한 단계는 다음과 같이 정의됩니다.

• 출시: 버전이 알파 또는 베타 상태를 종료하고 안정적인 것으로 간주됩니다. 이 버전에는 기능 추가가 계속 출시될 수 있습니다.
• 지원 중단: 버전이 지원 중단되고 지원 종료 (지원 종료) 날짜가 공지됩니다. 사용자는 지원 종료일 전에 최신 버전으로 이전해야 합니다. 이 버전에는 더 이상 기능이 추가되지 않습니다.
• 지원 종료: 더 이상 지원되지 않는 버전입니다. 버전에 대한 요청은 오류를 반환합니다.

아래 표에는 기존의 모든 핵심 Display & Video 360 API 버전, 출시일, 지원 중단일 및 서비스 종료일(공지된 경우)이 나와 있습니다.

API 버전	출시일	지원 중단일	지원 종료일	이전 가이드
v3	2023년 10월 31일
v2	2022년 12월 6일	2024년 2월 15일	2024년 9월 3일	v2에서 v3로 이전
v1	2020년 3월 9일	2023년 3월 13일	2023년 9월 14일	v1에서 v2로 이전

기능 지원 중단

예정된 주요 기능 지원 중단에 대한 공지사항은 Google Ads 개발자 블로그를 참고하세요.

아래 표에는 공지된 모든 기능 지원 중단이 나와 있으며, 최초 시행일, 지원 중단에 관한 설명, 권장 조치, 관련 문서 링크가 제공됩니다.

기능	최초 시행일	설명
타겟팅 확장	2023년 3월 25일	타겟팅 확장 기능을 타겟팅 최적화로 대체하는 기능이 2023년 3월 25일부터 2023년 5월 초까지 단계적으로 출시되었습니다. Display & Video 360 API 및 구조화된 데이터 파일 동작과 관련된 변경사항 및 권장 조치는 블로그 게시물에서 발표되었습니다.
수동 트리거	2023년 5월 17일	일정 2023년 5월 17일: 수동 트리거를 사용하는 광고 항목이 Display & Video 360에서 게재 중단됩니다. 이 날짜 이후에 활성 광고 항목에 연결된 수동 트리거를 활성화하면 광고 항목에서 광고가 게재되지 않습니다. 2023년 8월 1일: DV360 API v1 및 v2의 advertisers.manualTriggers 서비스, DV360 API v1의 LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER enum 값, DV360 API v1의 LineItemFlight.triggerId 필드가 지원 종료됩니다. 이 날짜 이후에는 이러한 서비스 또는 입력란에 대한 요청이 오류를 반환합니다. 추천 해결법: 수동 트리거를 사용하여 광고 항목 게재를 시작하고 중지하는 작업을 즉시 중지합니다. advertisers.manualTriggers 서비스에 대한 요청을 중지합니다. 수동 트리거를 사용하여 모든 광고 항목의 flight.flightDateType 및 flight.triggerId 필드를 업데이트합니다.
설치된 앱 및 새 휴대기기 GoogleAudience 유형	2023년 5월 20일	일정 2023년 5월 20일: 더 이상 GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS 또는 GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES GoogleAudienceType의 GoogleAudience 리소스를 광고 항목 또는 게재 신청서 잠재고객 타겟팅에 할당할 수 없습니다. 이러한 잠재고객을 광고 항목의 잠재고객 타겟팅에 할당하는 요청은 오류를 반환합니다. 여기에는 생성된 광고 항목의 잠재고객 타겟팅에 지원 중단된 잠재고객이 포함되는 경우 advertisers.lineItems.duplicate 및 advertisers.lineItems.generateDefault 요청이 포함됩니다. 2023년 6월 8일: 영향을 받는 잠재고객이 모든 광고 항목 및 게재 신청서 타겟팅과 모든 결합 잠재고객에서 삭제됩니다. 이러한 잠재고객이 삭제되어 광고 항목에서 광고를 게재할 수 없으면 일시중지됩니다. 이 날짜부터는 googleAudiences 서비스를 사용하여 이러한 잠재고객을 더 이상 검색할 수 없습니다. 권장 작업: 향후 광고 항목 타겟팅을 업데이트할 때 영향을 받는 잠재고객의 사용을 즉시 중지하는 것이 좋습니다. 기존 광고 항목 및 게재 신청서 타겟팅에서 영향을 받는 모든 잠재고객을 삭제합니다. 공유 대상 그룹 가이드에서 잠재고객 타겟팅 업데이트에 대해 자세히 알아보세요.
활동 기반 및 최대 게재빈도 FirstAndThirdPartyAudience 유형	2023년 5월 20일	일정 2023년 5월 20일: 더 이상 ACTIVITY_BASED 또는 FREQUENCY_CAP AudienceType의 FirstAndThirdPartyAudience 리소스를 광고 항목 또는 게재 신청서 잠재고객 타겟팅에 할당할 수 없습니다. 이러한 잠재고객을 광고 항목의 잠재고객 타겟팅에 할당하는 요청은 오류를 반환합니다. 여기에는 생성된 광고 항목의 잠재고객 타겟팅에 지원 중단된 잠재고객이 포함되는 경우 advertisers.lineItems.duplicate 및 advertisers.lineItems.generateDefault 요청이 포함됩니다. 2023년 6월 8일: 영향을 받는 잠재고객이 모든 광고 항목 및 게재 신청서 타겟팅과 모든 결합 잠재고객에서 삭제됩니다. 이러한 잠재고객이 삭제되어 광고 항목에서 광고를 게재할 수 없으면 일시중지됩니다. 이 날짜부터는 firstAndThirdPartyAudiences 서비스를 사용하여 이러한 잠재고객을 더 이상 검색할 수 없습니다. 권장 작업: 향후 광고 항목 타겟팅을 업데이트할 때 영향을 받는 잠재고객의 사용을 즉시 중지하는 것이 좋습니다. 기존 광고 항목 및 게재 신청서 타겟팅에서 영향을 받는 모든 잠재고객을 삭제합니다. 공유 대상 그룹 가이드에서 잠재고객 타겟팅 업데이트에 대해 자세히 알아보세요.
기존 API 할당량 한도	2023년 5월 30일	2023년 5월 30일부터 기존 사용량 한도가 다음과 같은 하이브리드 할당량 구조로 대체됩니다. 프로젝트당 일일 요청 할당량을 삭제합니다. 검증 방법에 대해 프로젝트별 광고주별 분당 요청 할당량을 설정합니다. 이러한 새로운 제한을 통해 API 사용의 유연성을 높이고 광고주 간에 요청을 병렬화할 수 있습니다. 이번 변경사항에 관한 자세한 내용은 기존 할당량 한도 문서를 참고하세요.
LIST 필터의 여러 필드 제한사항 간에 OR 연산자 사용 초기 시행일이 업데이트됨	2023년 6월 21일	2023년 6월 21일부터 LIST 요청 filter 매개변수에서 더 이상 서로 다른 필드의 제한사항 간에 OR 논리 연산자를 사용할 수 없습니다. 예를 들어 필터 문자열 lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123"로 식별된 리소스는 대신 다음 필터 문자열이 포함된 두 개의 LIST 요청을 사용하여 검색해야 합니다. lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" insertionOrderId="123" 논리 연산자의 제한사항에 관한 자세한 내용은 LIST 요청 필터링 방법 가이드를 참고하세요. 서비스가 중단되지 않도록 2023년 6월 21일 전에 모든 기존 LIST 호출의 filter 쿼리 매개변수를 검토하고 OR 논리 연산자를 올바르게 사용하고 있는지 확인하세요.
budget.budget_segments.date_range.end_date 및 flight.dateRange.endDate 필드로 목록 요청을 필터링하거나 정렬하는 기능 최초 시행일이 업데이트됨	2023년 6월 21일	2023년 6월 21일부터 budget.budget_segments.date_range.end_date 및 flight.dateRange.endDate는 더 이상 advertisers.insertionOrders.list 및 advertisers.lineItems.list filter 및 orderBy 쿼리 매개변수의 필드로 허용되지 않습니다. 이 날짜 이후에는 filter 및 orderBy 쿼리 매개변수에서 이러한 필드를 사용하는 요청이 오류를 반환합니다. 서비스가 중단되지 않도록 2023년 6월 21일 전에 이 두 필드를 사용하는 모든 필터 및 순서 로직을 삭제하세요.
advertisers.lineItems.list 요청을 4개의 추가 필드로 필터링하는 기능	2023년 6월 21일	2023년 6월 21일부터 advertisers.lineItems.list에서 다음 필드별 필터링이 더 이상 지원되지 않습니다. flight.triggerId targetedChannelId targetedNegativeKeywordListId warningMessages 서비스가 중단되지 않도록 2023년 6월 21일 전에 이 4개의 필드를 사용하는 모든 필터 로직을 삭제하세요.
결과 기반 구매	2023년 8월 1일	2023년 8월 1일부터 billableOutcome 필드 값 BILLABLE_OUTCOME_PAY_PER_CLICK 또는 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION로 정의된 결과 기반 구매를 사용하는 게재 신청서 및 하위 광고 항목이 보관처리됩니다. 이 변경사항은 다음 요청에 영향을 미칩니다. advertisers.insertionOrders.create를 사용하여 결과 기반 구매를 통해 게재 신청서를 만들려고 하면 400 오류가 반환됩니다. advertisers.lineItems.create, advertisers.lineItems.duplicate 또는 advertisers.lineItems.generateDefault를 사용하여 결과 기반 구매를 통해 게재 신청서에 광고 항목을 만들려고 하면 400 오류가 반환됩니다. 보관처리된 리소스는 기본적으로 LIST 요청에 포함되지 않으므로 영향을 받는 리소스는 기본적으로 더 이상 advertisers.insertionOrders.list 및 advertisers.lineItems.list 메서드에서 반환되지 않습니다.
광고 소재 리소스의 publisherReviewStatuses 필드	2024년 6월 26일	2024년 6월 26일부터 publisherReviewStatuses 필드가 지원 중단되며 Creative 리소스를 검색할 때 비워집니다.
YouTube + 파트너 광고 항목의 콘텐츠 타겟팅	2024년 9월 30일	2024년 9월 30일부터 YouTube + 파트너 광고 항목에서 다음과 같이 식별된 타겟팅 유형의 값이 지원 중단됩니다. TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_UNRATED CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_FAMILIES TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_EMBEDDED_VIDEO SENSITIVE_CATEGORY_LIVE_STREAMING_VIDEO 기존 광고 항목 타겟팅에서 지원 종료 타겟팅 옵션이 자동으로 삭제됩니다. 이러한 값은 광고주 수준 타겟팅에 계속 사용할 수 있습니다. 서비스가 중단되지 않도록 지원 종료일 전에 기존 YouTube + 파트너 광고 항목에서 이 타겟팅을 삭제하세요.
Oracle 퍼스트 파티 및 서드 파티 잠재고객	2024년 9월 30일	2024년 9월 30일에 Oracle의 FirstAndThirdPartyAudience 리소스 소스가 지원 중단됩니다. 지원 종료 시 이러한 잠재고객은 기존 리소스 타겟팅 및 결합된 잠재고객에서 삭제됩니다. 지원 중단된 잠재고객만 타겟팅하거나 지원 중단된 잠재고객을 제외하는 광고 항목의 경우 이 업데이트로 인해 광고 항목이 자동으로 일시중지됩니다. 서비스가 중단되지 않도록 지원 종료일 전에 기존 광고 항목 잠재고객 타겟팅 및 통합 잠재고객에서 Oracle 잠재고객을 식별하고 삭제하세요.
일부 입찰 전략에 대한 광고 항목 타겟팅 최적화	2024년 9월 30일	2024년 9월 30일부터 입찰 전략의 하위 집합을 사용하는 LineItem 리소스는 더 이상 타겟팅 최적화와 호환되지 않습니다. 이번 변경으로 targetingExpansion.enableOptimizedTargeting이 True로, bidStrategy.maximizeSpendAutoBid.performanceGoalType이 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN 또는 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED로, bidStrategy.performanceGoalAutoBid.performanceGoalType이 BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM로 설정된 LineItem 리소스는 targetingExpansion.enableOptimizedTargeting이 False로 설정되도록 업데이트됩니다. 서비스가 중단되지 않도록 이러한 입찰 전략을 사용하는 광고 항목에 타겟팅 최적화가 사용 설정되어 있지 않은지 업데이트하고 확인하세요.
게재 신청서에 대한 최대한 빨리 게재Pacing	2024년 11월 5일	2024년 11월 5일부터 게재 신청서 pacing 필드를 설정할 때 PACING_TYPE_ASAP가 더 이상 PACING_PERIOD_FLIGHT와 호환되지 않습니다. 이 구성이 적용된 모든 기존 게재 신청서의 pacingType가 PACING_TYPE_AHEAD로 업데이트됩니다. 서비스가 중단되지 않도록 PACING_TYPE_ASAP 및 PACING_PERIOD_FLIGHT를 사용하여 기존 게재 신청서의 pacing를 업데이트합니다.
퍼스트 파티 잠재고객의 무한 멤버십 기간	2025년 4월 7일	2025년 4월 7일부터 FirstAndThirdPartyAudience 리소스에서 더 이상 무한 잠재고객 멤버십 기간을 허용하지 않습니다. membershipDurationDays 필드 값을 10,000으로 설정하는 firstAndThirdPartyAudiences.create 및 firstAndThirdPartyAudiences.patch 요청은 400 오류를 반환합니다. membershipDurationDays 필드 값이 10,000인 기존 잠재고객은 540으로 업데이트되며, 새로운 멤버십 기간이 기존 멤버십에 소급 적용됩니다. 이렇게 하면 540일이 지난 모든 멤버십이 만료됩니다. 서비스가 중단되지 않도록 하려면 다음 단계를 따르세요. 통합에서 신규 또는 기존 잠재고객의 membershipDurationDays 필드 값을 10,000으로 설정하지 않는지 확인합니다. firstAndThirdPartyAudiences.editCustomerMatchMembers를 사용하여 기존 고객 일치 타겟팅 잠재고객의 멤버십을 새로고침합니다. 고객 일치 타겟팅 잠재고객 멤버십을 정기적으로 새로고침하여 잠재고객 목록 크기가 의도치 않게 작아지지 않도록 합니다.