지원 중단 발표됨

이 페이지에는 API 버전과 Display & Video 360 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 필드가 지원 종료됩니다. 이 날짜 이후에는 이러한 서비스나 필드에 요청을 전송하면 오류가 반환됩니다.

권장 조치:

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

일정

  • 2023년 5월 20일: GoogleAudienceType 값이 GOOGLE_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일: AudienceType 값이 ACTIVITY_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"로 식별된 리소스는 다음 필터 문자열이 포함된 2개의 LIST 요청을 사용하여 검색해야 합니다.

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

논리 연산자의 제한사항에 관한 자세한 내용은 LIST 요청 필터링 안내 가이드를 참고하세요.

서비스가 중단되지 않도록 모든 기존 LIST 호출의 filter 쿼리 매개변수를 검토하고 2023년 6월 21일 전에 OR 논리 연산자를 올바르게 사용하고 있는지 확인하세요.

budget.budget_segments.date_range.end_dateflight.dateRange.endDate 필드별로 목록 요청을 필터링하거나 정렬하는 기능

최초 시행일 업데이트됨

2023년 6월 21일

2023년 6월 21일부터 budget.budget_segments.date_range.end_dateflight.dateRange.endDateadvertisers.insertionOrders.listadvertisers.lineItems.list filterorderBy 쿼리 매개변수에 더 이상 허용되지 않습니다. 이 날짜 이후에는 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일BILLABLE_OUTCOME_PAY_PER_CLICK 또는 BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSIONbillableOutcome 필드 값으로 정의된 결과 기반 구매를 사용하는 게재 신청서와 하위 광고 항목이 보관처리됩니다.

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