지원 중단 발표됨

이 페이지에는 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 필드가 지원 종료됩니다. 이 날짜 이후에 이러한 서비스 또는 필드에 대한 요청은 오류를 반환합니다.

추천 해결법:

설치된 앱 및 새 휴대기기 GoogleAudience 유형 2023년 5월 20일

일정

  • 2023년 5월 20일: 더 이상 GoogleAudienceTypeGOOGLE_AUDIENCE_TYPE_INSTALLED_APPS 또는 GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICESGoogleAudience 리소스를 광고 항목 또는 게재 신청서 잠재고객 타겟팅에 할당할 수 없습니다. 이러한 잠재고객을 광고 항목의 잠재고객 타겟팅에 할당하는 요청은 오류를 반환합니다. 생성된 광고 항목의 잠재고객 타겟팅에 지원 중단된 잠재고객이 포함되는 경우 advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault 요청이 포함됩니다.
  • 2023년 6월 8일: 영향을 받는 잠재고객이 모든 광고 항목 및 게재 신청서 타겟팅 및 모든 합성 잠재고객에서 삭제됩니다. 이러한 잠재고객이 삭제될 때 광고 항목에서 광고를 게재할 수 없는 경우 잠재고객이 일시중지됩니다. 이 날짜부터 이러한 잠재고객은 더 이상 googleAudiences 서비스를 사용하여 가져올 수 없습니다.

권장 작업:

  • 향후 광고 항목 타겟팅을 업데이트할 때 영향을 받는 잠재고객의 사용을 즉시 중지하는 것이 좋습니다.
  • 기존 광고 항목 및 게재 신청서 타겟팅에서 영향을 받는 모든 잠재고객을 삭제하세요. 타겟층 가이드에서 잠재고객 타겟팅을 업데이트하는 방법을 알아보세요.
활동 기반 및 최대 게재빈도 FirstAndThirdPartyAudience 유형 2023년 5월 20일

일정

  • 2023년 5월 20일: 더 이상 AudienceTypeACTIVITY_BASED 또는 FREQUENCY_CAPFirstAndThirdPartyAudience 리소스를 광고 항목 또는 게재 신청서 잠재고객 타겟팅에 할당할 수 없습니다. 이러한 잠재고객을 광고 항목의 잠재고객 타겟팅에 할당하는 요청은 오류를 반환합니다. 생성된 광고 항목의 잠재고객 타겟팅에 지원 중단된 잠재고객이 포함되는 경우 advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault 요청이 포함됩니다.
  • 2023년 6월 8일: 영향을 받는 잠재고객이 모든 광고 항목 및 게재 신청서 타겟팅 및 모든 합성 잠재고객에서 삭제됩니다. 이러한 잠재고객이 삭제될 때 광고 항목에서 광고를 게재할 수 없는 경우 잠재고객이 일시중지됩니다. 이 날짜부터 이러한 잠재고객은 더 이상 firstAndThirdPartyAudiences 서비스를 사용하여 가져올 수 없습니다.

권장 작업:

  • 향후 광고 항목 타겟팅을 업데이트할 때 영향을 받는 잠재고객의 사용을 즉시 중지하는 것이 좋습니다.
  • 기존 광고 항목 및 게재 신청서 타겟팅에서 영향을 받는 모든 잠재고객을 삭제하세요. 타겟층 가이드에서 잠재고객 타겟팅을 업데이트하는 방법을 알아보세요.
기존 API 할당량 한도 2023년 5월 30일

2023년 5월 30일에 기존 사용량 한도가 다음을 실행하는 하이브리드 할당량 구조로 대체됩니다.

  1. 프로젝트당 일일 요청 할당량을 제거합니다.
  2. 자격을 갖춘 메서드에 대해 프로젝트 할당량별로 광고주별 분당 요청 수를 제공합니다.

이러한 새로운 한도를 통해 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_dateflight.dateRange.endDate 필드별로 목록 요청을 필터링하거나 정렬할 수 있습니다.

최초 시행일 업데이트됨

2023년 6월 21일

2023년 6월 21일부터 advertisers.insertionOrders.listadvertisers.lineItems.list filterorderBy 쿼리 매개변수의 각각에서 budget.budget_segments.date_range.end_dateflight.dateRange.endDate 필드가 더 이상 허용되지 않습니다. 이 날짜 이후 filterorderBy 쿼리 매개변수에서 이러한 필드를 사용하는 요청은 오류를 반환합니다.

서비스가 중단되지 않도록 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로 정의된 결과 기반 구매를 사용하는 게재 신청서와 하위 광고 항목이 보관처리됩니다.

이 변경사항은 다음 요청에 영향을 미칩니다.

광고 소재 리소스의 publisherReviewStatuses 입력란 2024년 6월 26일

2024년 6월 26일부터 publisherReviewStatuses 필드가 지원 중단되고 Creative 리소스를 가져오면 이 필드가 비어 있게 됩니다.

YouTube 및 파트너 광고 항목 2024년 9월 30일

2024년 9월 30일부터 확인된 YouTube 및 파트너 광고 항목:

지원 종료일 타겟팅 옵션은 기존 광고 항목 타겟팅에서 자동으로 삭제됩니다.

서비스가 중단되지 않도록 하려면 기존 YouTube 및 지원 종료일 전의 파트너 광고 항목

Oracle 퍼스트 파티 잠재고객 및 서드 파티 잠재고객 2024년 9월 30일

2024년 9월 30일에 Oracle의 FirstAndThirdPartyAudience 리소스 소스가 지원 종료됩니다. 지원 종료 시 이러한 잠재고객은 기존 리소스 타겟팅 및 통합된 잠재고객에서 삭제됩니다. 광고 항목이 지원 종료되는 잠재고객만 타겟팅하거나 지원 종료되는 잠재고객을 제외 타겟팅하는 경우, 이 업데이트로 인해 해당 광고 항목이 자동으로 일시중지됩니다.

서비스 중단을 방지하려면 지원 종료 날짜 전에 기존 광고 항목 잠재고객 타겟팅 및 통합된 잠재고객에서 Oracle 잠재고객을 식별하고 삭제하세요.

일부 입찰 전략에 대한 광고 항목 타겟팅 최적화 2024년 9월 30일

2024년 9월 30일부터 일부 입찰 전략을 사용하는 LineItem 리소스가 더 이상 타겟팅 최적화와 호환되지 않습니다. 이번 변경으로 targetingExpansion.enableOptimizedTargetingTrue로 설정되고 bidStrategy.maximizeSpendAutoBid.performanceGoalTypeBIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED 또는 bidStrategy.performanceGoalAutoBid.performanceGoalType로 설정된 LineItem 리소스가 targetingExpansion.enableOptimizedTargetingFalse로 설정하도록 업데이트됩니다.BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM

서비스가 중단되지 않도록 하려면 이러한 입찰 전략을 사용하는 광고 항목에서 타겟팅 최적화가 사용 설정되지 않았는지 업데이트하고 확인하세요.

게재 신청서의 광고 게재 기간 ASAP(Pacing) 2024년 11월 5일

2024년 11월 5일부터 게재 신청서 pacing 필드를 설정할 때 PACING_TYPE_ASAP가 더 이상 PACING_PERIOD_FLIGHT과 호환되지 않습니다. 이 구성을 사용하는 모든 기존 게재 신청서의 pacingTypePACING_TYPE_AHEAD(으)로 업데이트됩니다.

서비스 중단을 방지하려면 PACING_TYPE_ASAPPACING_PERIOD_FLIGHT를 사용하여 기존 게재 신청서의 pacing를 업데이트하세요.