출시 노트

이 페이지에는 애드센스 관리 API의 출시 노트가 나와 있습니다.

버전 2

이 버전에는 지원 중단된 기능을 삭제하고 애드센스 관리 API를 현재 Google API 표준에 맞추기 위해 다음과 같은 변경사항이 도입되었습니다. Google API 버전 관리 체계에 따라 이 버전은 시간이 지남에 따라 업데이트되어 별도의 부 버전에 출시되는 새로운 기능이 아니라 이전 버전과 호환되는 추가 기능을 포함합니다.

2024-04-03

PolicyIssues

  • 계정의 현재 정책 위반 및 경고를 보고하는 새 컬렉션을 추가했습니다.

2023-06-19

지급

  • 이제 payments.list에서 프리미엄 게시자를 위한 지급 세부정보를 반환합니다.

2023-06-13

보고서

  • 광고가 아닌 단위 (예: 관련 검색어 단위)의 실적에 대한 정보를 제공하는 FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS, FUNNEL_RPM 측정항목이 추가되었습니다.

2023-03-30

보고서

  • 측정항목을 페이지 URL별로 분류할 수 있는 PAGE_URL 측정기준이 추가되었습니다 (일부 주의사항은 페이지 URL 분류 참고).

2022-09-21

AdUnits

  • create 및 패치 메서드를 추가했습니다. 이 방법은 플랫폼용 애드센스 제품을 사용하는 프로젝트에서만 사용할 수 있습니다.

CustomChannels

  • create, patch, update 메서드를 추가했습니다. 이 방법은 플랫폼용 애드센스 제품을 사용하는 프로젝트에서만 사용할 수 있습니다.
  • 리소스에 활성 필드를 추가했습니다.

계정

  • getAdBlockingRecoveryTag 메서드가 추가되었습니다.

2022-08-25

보고서

  • 호스트 및 플랫폼 게시자가 게시자 계정 (호스트 게시자) 및 하위 계정 (플랫폼 게시자)별로 측정항목을 분류할 수 있는 HOSTED_AD_CLIENT_ID 측정기준이 추가되었습니다.

2022-05-03

AdClient

  • get 메서드를 추가했습니다.

보고서

  • getSaved 메서드가 추가되었습니다.

UrlChannels

  • get 메서드를 추가했습니다.

2022-03-31

계정

AdClient

2022-02-24

결제

  • YouTube 수입을 위한 별도의 리소스를 지원하도록 리소스 이름 형식이 확장되었습니다. 이번 변경사항은 YouTube 수입이 자체 결제 계정으로 분리되는 YouTube 크리에이터를 위한 개선된 애드센스 환경을 단계적으로 출시하기 전에 이루어진 조치입니다. YouTube 수입 전용 결제 계정이 있으면 결제 목록 수단에서도 YouTube 결제 정보가 반환됩니다. YouTube 수입은 다음과 같은 리소스 이름 형식으로 지정됩니다.
    • accounts/{account}/payments/youtube-unpaid가 현재 YouTube에서 지급된 미지급금입니다.
    • accounts/{account}/payments/youtube-yyyy-MM-dd에 따라 YouTube 유료 수입이 지급됩니다.

    참고: 애드센스 수입의 리소스 이름은 변경되지 않습니다.
    • accounts/{account}/payments/unpaid (현재) 애드센스 수입입니다.
    • accounts/{account}/payments/yyyy-MM-dd에 따라 애드센스 계정에 대한 지급액이 지급됩니다.

2021-06-30

보고서

  • 사이트에서 사용자에게 광고가 표시되는 방식 (인페이지, 전면 광고 등)을 나타내는 측정기준 AD_FORMAT_NAMEAD_FORMAT_CODE를 추가했습니다. v1.4에는 이름이 같지만 구성원이 다른 측정기준이 지원 중단되었습니다. v2에 추가된 두 측정기준은 v1.4에 있던 측정기준과 다릅니다.

2021-04-19 (최초 출시)

일반

  • v1.4에서 지원 중단된 모든 메서드가 삭제되었습니다. 여기에는 accountId가 필요 없는 리소스 메서드가 포함됩니다. v2에서 accountIdparent 필드에 지정됩니다.
  • Google API 표준에 따라 리소스는 이제 name 필드로 식별됩니다. 예를 들어 AdClient의 이름은 accounts/{accountId}/adclients/{adClientId}과 같습니다. 또한 v1.4에서는 리소스 ID가 보고 측정기준으로 사용되었지만 v2에서는 이제 여러 리소스의 reporting_dimension_id 필드를 통해 이 값을 사용할 수 있습니다.
  • 모든 리소스에서 kind 필드가 삭제되었습니다.

계정

  • name 필드가 display_name로 변경되었습니다.
  • timezone 필드가 문자열에서 google.type.TimeZone로 변경되었습니다.
  • creation_time 필드 (유형 int64)가 create_time (유형 google.protobuf.Timestamp)로 변경되었습니다.
  • 새 계정 가입 절차의 일부로 완료해야 하는 미해결 작업의 목록인 pending_tasks 필드가 추가되었습니다. 예를 들어 결제 프로필 또는 전화 인증과 관련된 작업이 있을 수 있습니다.
  • sub_accounts 필드가 삭제되었습니다. v2에서는 listChildAccounts 커스텀 메서드를 사용하여 유사한 기능을 구현할 수 있습니다. v2에서는 listChildAccounts를 재귀적으로 호출하여 전체 하위 계정 트리를 생성할 수 있습니다.

AdClient

  • arc_opt_in 필드는 애드센스 UI에서 이미 삭제되었으므로 삭제되었습니다.
  • supports_reporting 필드는 AD_CLIENT_ID 보고 측정기준에서 사용되는 광고 클라이언트의 고유 ID를 나타내는 reporting_dimension_id 필드로 대체됩니다. reporting_dimension_id가 비어 있으면 AdClient는 보고를 지원하지 않는 것입니다.

AdUnit

  • status 필드 이름이 state로 변경되었습니다. 또한 ACTIVE 상태는 이 광고 단위에서 최근 7일 동안 활동이 있었는지 여부를 더 이상 나타내지 않습니다. v2에서는 사용자가 광고 단위를 활성화하여 광고를 게재할 수 있음을 의미합니다.
  • code 필드가 삭제되었습니다. 이 값은 여전히 name 필드의 끝 (마지막 슬래시 뒤)에서 찾을 수 있습니다.
  • contentAdsSettings.backupOption 필드가 삭제되었습니다.
  • type 필드는 TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT, LINK 값으로 제한되었습니다.
  • 애드센스 UI에서 이미 삭제된 다른 필드인 custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings도 삭제됩니다.

알림

  • delete 메서드가 삭제되었습니다.
  • is_dismissible 필드가 삭제되었습니다.
  • locale 필드 이름이 language_code로 변경되었습니다.

CustomChannel

  • code 필드가 삭제되었습니다. 이 값은 여전히 name 필드의 끝 (마지막 슬래시 뒤)에서 찾을 수 있습니다.
  • targeting_info 필드는 애드센스 UI에서 이미 삭제되었으므로 삭제되었습니다.

결제

  • payment_date 필드 이름이 date로 변경되고 문자열 유형에서 google.type.Date 유형으로 변경되었습니다.
  • payment_amount 필드와 payment_amount_currency_code 필드가 단일 payment 필드로 결합되었습니다 (예: '¥1,235 JPY', '$1,234.57', '£87.65').

보고서

  • v2에서는 애드센스 관리 API 보고 데이터가 애드센스 UI와 일치합니다. 즉, AdMob 및 YouTube 서비스는 더 이상 지원되지 않습니다. 또한 API는 3년 이전의 보고서 데이터만 지원합니다.
  • Metadata.dimensions 리소스와 Metadata.metrics 리소스가 삭제되었습니다.
  • v1.4의 쿼리 매개변수를 대체하는 보고서의 CSV 버전을 생성하는 새로운 메서드가 추가되었습니다. 참고: 압축을 위해 HTTP 헤더 'Accept-Encoding: gzip'을 계속 사용할 수 있습니다.
  • 임시 보고서 생성 시 일부 필드가 변경되었습니다.
    • account_id 필드 이름이 account로 변경되었습니다.
    • dimension 필드 이름이 dimensions로 변경되었습니다.
    • metric 필드 이름이 metrics로 변경되었습니다.
    • filter 필드 이름이 filters로 변경되었습니다.
    • sort 필드 이름이 order_by로 변경되었습니다.
    • locale 필드 이름이 language_code로 변경되었습니다.
    • currency 필드 이름이 currency_code로 변경되었습니다.
    • 이제 date_range를 사용하여 몇 가지 공통 범위(예: TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS, LAST_30_DAYS)을 지정하거나 date_rangeCUSTOM로 설정하여 start_dateend_date를 지정할 수 있습니다.
    • start_dateend_date 필드가 문자열 유형에서 google.type.Date 유형으로 변경되었습니다. 참고: 따라서 상대적 날짜 키워드 (예: 'today-6d')는 더 이상 지원되지 않습니다.
    • 불리언 필드 use_timezone_reportingreporting_time_zone로 대체되었습니다. 이 필드는 두 값, 즉 ACCOUNT_TIME_ZONE 또는 GOOGLE_TIME_ZONE (PST/PDT) 중 하나를 가질 수 있습니다. v2의 기본값은 ACCOUNT_TIME_ZONE이며 v1.4의 기본값과 다릅니다.
    • start_index 필드가 삭제되었습니다.
    • max_results 필드 이름이 limit로 변경되었습니다.
  • 저장된 보고서 생성 시 일부 필드가 변경되었습니다.
    • 날짜 필드 (date_range, start_date, end_date, reporting_time_zone)를 추가했습니다.
    • currency_code 필드를 추가했습니다.
    • locale 필드 이름이 language_code로 변경되었습니다.
    • start_index 필드가 삭제되었습니다.
    • max_results 필드가 삭제되었습니다.

SavedAdStyle

  • SavedAdStyle은(는) 애드센스 UI에서 이미 삭제되었으므로 삭제되었습니다.

사이트

  • 애드센스 계정에 추가한 웹사이트에 대한 데이터를 가져올 수 있도록 Sites이(가) 추가되었습니다.
  • state 필드는 사이트가 REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION 상태 중 하나인지 나타냅니다.
  • auto_ads_enabled 필드는 특정 사이트에 자동 광고가 사용 설정되었는지 여부를 나타내는 불리언입니다.

버전 1.4

이 버전에 포함된 기능은 다음과 같습니다.

  • 이제 애드센스 계정 지급액을 해당 통화로 표시할 수 있습니다.
  • 이제 API 및 애드센스 웹 인터페이스에서 알림을 숨기는 delete 메서드를 호출하여 알림을 닫을 수 있습니다.
  • 이제 보고서 응답에 시작일과 종료일이 포함됩니다. 이는 보고서를 생성할 때 상대적 날짜 (예: today, yesterday, firstDayOfMonth-1m)를 사용하는 경우 이제 요청한 기간이 응답에 포함됩니다.

알려진 문제

이 버전에서는 보고서의 currency 필드가 지원되지 않습니다.

버전 1.3

이 버전에 포함된 기능은 다음과 같습니다.

  • 알림 검색 기능
  • 측정항목 및 측정기준 메타데이터를 검색하는 기능
  • 계정의 현지 시간대로 보고서를 실행하는 기능

알려진 문제

이 버전에서는 보고서의 currency 필드가 지원되지 않습니다.

버전 1.2

이 버전에 포함된 기능은 다음과 같습니다.

  • 광고 스타일을 가져오는 기능
  • 프런트엔드에 정의된 저장된 보고서를 검색하고 실행하는 기능

알려진 문제

이 버전에서는 보고서의 currency 필드가 지원되지 않습니다.

버전 1.1

이 버전에 포함된 기능은 다음과 같습니다.

  • 사용자가 액세스 권한을 가진 계정을 나열하는 기능
  • 특정 계정에 대해 GET 호출을 수행하는 기능
  • 광고 단위맞춤 채널에 대해 GET 호출을 수행하는 기능
  • 광고 단위 및 맞춤 채널 간의 연결을 결정하는 기능
  • 맞춤 채널에 타겟팅 정보에 대한 더 많은 데이터가 포함됨

또한 이제 기본 계정 또는 특정 계정의 데이터에 액세스할 수 있습니다.

알려진 문제

이 버전에서는 보고서의 currency 필드가 지원되지 않습니다.

버전 1

이 API의 첫 번째 출시입니다. 광고 클라이언트, 광고 단위, 맞춤 채널, URL 채널 검색 및 보고서 실행을 위한 지원 기능이 포함되어 있습니다.

알려진 문제

이 버전에서는 보고서의 currency 필드가 지원되지 않습니다.