디스플레이 및 Video 360 API v2에 대한 지원이 종료됩니다. Display & Video 360 API v3를 대신 사용하세요. v2에서 v3으로 이전하는 방법은 이전 가이드를 참고하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

지원 중단 발표됨

이 페이지에는 API 지원 중단 날짜 및 지원 종료 날짜가 나와 있습니다. 버전 및 개별 기능 디스플레이 및 Video 360 API

API의 지원 중단 및 지원 종료 날짜도 Google Ads 개발자 블로그

버전 지원 중단

디스플레이 및 Video 360 API 버전은 정기적으로 출시 및 지원 중단되고 지원 종료됩니다. 이러한 단계는 다음과 같이 정의됩니다.

출시: 버전의 알파 또는 베타 상태가 종료되며 있습니다. 해당 버전에 추가된 기능이 계속 출시될 수 있습니다.
지원 중단: 버전이 중단되고 지원이 종료됩니다 (종료). 발표 날짜가 발표됩니다. 사용자는 지원 종료되기 전에 최신 버전으로 이전해야 함 있습니다. 해당 버전에 추가된 기능이 더 이상 제공되지 않습니다.
종료: 더 이상 지원되지 않는 버전입니다. 버전에 대한 요청 오류가 반환됩니다.

아래 표에는 기존의 핵심 디스플레이 및 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월 초까지 점진적으로 적용되었습니다. 디스플레이 및 블로그 게시물을 통해 Video 360 API 및 구조화된 데이터 파일 동작과 권장 조치가 발표되었습니다.
수동 트리거	2023년 5월 17일	일정 2023년 5월 17일: 수동 트리거를 사용하는 광고 항목은 디스플레이 및 동영상 360 이 날짜 이후에 활성 광고 항목에 연결된 수동 트리거를 활성화하면 광고 항목이 광고를 게재하지 않습니다. 2023년 8월 1일: DV360 API v1 및 v2의 `advertisers.manualTriggers` 서비스, DV360 API v1의 `LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER` 열거형 값, DV360 API v1의 `LineItemFlight.triggerId` 필드가 지원 종료됩니다. 이 날짜 이후에 이러한 서비스 또는 필드에 대한 요청은 오류를 반환합니다. 추천 해결법: 수동 트리거를 사용한 즉시 광고 항목 게재를 시작하고 중지합니다. `advertisers.manualTriggers` 서비스에 대한 요청을 중지합니다. 수동 트리거를 사용하여 모든 광고 항목의 `flight.flightDateType` 및 `flight.triggerId` 필드를 업데이트합니다.
설치된 앱 및 새 휴대기기 `GoogleAudience` 유형	2023년 5월 20일	일정 2023년 5월 20일: 더 이상 `GoogleAudienceType`이 `GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS` 또는 `GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES`인 `GoogleAudience` 리소스를 광고 항목 또는 게재 신청서 잠재고객 타겟팅에 할당할 수 없습니다. 이러한 잠재고객을 광고 항목의 잠재고객 타겟팅에 할당하는 요청은 오류를 반환합니다. 생성된 광고 항목의 잠재고객 타겟팅에 지원 중단된 잠재고객이 포함되는 경우 `advertisers.lineItems.duplicate` 및 `advertisers.lineItems.generateDefault` 요청이 포함됩니다. 2023년 6월 8일: 영향을 받는 잠재고객이 모든 광고 항목 및 게재 신청서 타겟팅 및 모든 합성 잠재고객에서 삭제됩니다. 이러한 잠재고객이 삭제될 때 광고 항목에서 광고를 게재할 수 없는 경우 잠재고객이 일시중지됩니다. 이 날짜부터 이러한 잠재고객은 더 이상 `googleAudiences` 서비스를 사용하여 가져올 수 없습니다. 권장 작업: 향후 광고 항목 타겟팅을 업데이트할 때 영향을 받는 잠재고객의 사용을 즉시 중지하는 것이 좋습니다. 기존 광고 항목 및 게재 신청서 타겟팅에서 영향을 받는 모든 잠재고객을 삭제하세요. 타겟층 가이드에서 잠재고객 타겟팅을 업데이트하는 방법을 알아보세요.
활동 기반 및 최대 게재빈도 `FirstAndThirdPartyAudience` 유형	2023년 5월 20일	일정 2023년 5월 20일: 더 이상 `AudienceType`이 `ACTIVITY_BASED` 또는 `FREQUENCY_CAP`인 `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일부터 `advertisers.insertionOrders.list` 및 `advertisers.lineItems.list` `filter` 및 `orderBy` 쿼리 매개변수의 각각에서 `budget.budget_segments.date_range.end_date` 및 `flight.dateRange.endDate` 필드가 더 이상 허용되지 않습니다. 이 날짜 이후 `filter` 및 `orderBy` 쿼리 매개변수에서 이러한 필드를 사용하는 요청은 오류를 반환합니다. 서비스가 중단되지 않도록 2023년 6월 21일 이전에 이 두 필드를 사용하는 모든 필터 및 주문 로직을 삭제하세요.
4개의 추가 필드로 `advertisers.lineItems.list` 요청을 필터링하는 기능	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` `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`로 설정된 `LineItem` 리소스가 `targetingExpansion.enableOptimizedTargeting`을 `False`로 설정하도록 업데이트됩니다.`BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM` 서비스가 중단되지 않도록 하려면 이러한 입찰 전략을 사용하는 광고 항목에서 타겟팅 최적화가 사용 설정되지 않았는지 업데이트하고 확인하세요.
게재 신청서의 광고 게재 기간 ASAP(`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`를 업데이트하세요.