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

출시 노트

이 페이지에서는 AdSense Management API의 출시 노트를 제공합니다.

버전 2

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

2025-10-02

보고서

TRAFFIC_SOURCE 측정기준이 추가되어 트래픽 소스 (예: 'Google', 'Bing', 'Facebook', '기타')별로 측정항목을 분류할 수 있습니다. 자세한 내용은 트래픽 소스 분류를 참고하세요.

2025-05-06

PolicyIssues

지원 중단된 policyTopics[].must_fix 필드 (이전 업데이트 참고)가 이제 항상 false로 설정됩니다.

2025-02-24

PolicyIssues

정책 주제가 정책 문제, 규제 문제 또는 광고주 환경설정을 나타내는지 식별하는 policyTopics[].type 필드를 추가했습니다. 이는 이제 지원 중단된 필드로 표시된 policyTopics[].must_fix를 대체합니다.

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

생성 및 패치 메서드가 추가되었습니다. 이러한 메서드는 플랫폼용 애드센스 제품이 사용 설정된 프로젝트에서만 사용할 수 있습니다.

CustomChannels

생성, 패치, 업데이트 메서드 추가 이러한 메서드는 플랫폼용 애드센스 제품이 사용 설정된 프로젝트에서만 사용할 수 있습니다.
리소스에 active 필드를 추가했습니다.

계정

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

2022-08-25

보고서

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

2022-05-03

AdClient

get 메서드가 추가되었습니다.

보고서

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

UrlChannels

get 메서드가 추가되었습니다.

2022-03-31

계정

이제 비활성 계정이 API에 의해 반환되며 state 필드에는 계정 상태가 표시됩니다.

AdClient

계정 변경사항과 마찬가지로 이제 API에서 비활성 광고 클라이언트를 반환하며, state 필드는 광고 클라이언트의 상태를 나타냅니다.

2022-02-24

지급

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

2021-06-30

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

2021-04-19 (최초 출시)

일반

v1.4에서 지원 중단된 메서드가 모두 삭제되었습니다. 여기에는 accountId가 필요하지 않은 리소스 메서드가 포함됩니다. v2에서는 accountId이 parent 필드에 지정됩니다.
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 필드가 삭제되었습니다. listChildAccounts 맞춤 메서드를 사용하여 v2에서 유사한 기능을 구현할 수 있습니다. listChildAccounts를 재귀적으로 호출하여 v2에서 전체 하위 계정 트리를 생성할 수 있습니다.

AdClient

애드센스 UI에서 이미 삭제되었으므로 arc_opt_in 필드를 삭제했습니다.
supports_reporting 필드가 reporting_dimension_id 필드로 대체됩니다. reporting_dimension_id 필드는 AD_CLIENT_ID 보고 측정기준에 사용된 광고 클라이언트의 고유 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를 사용하면 이제 AdSense Management API 보고 데이터가 AdSense UI와 일치합니다. 즉, AdMob 및 YouTube 속성이 더 이상 지원되지 않습니다. 또한 API는 3년 전 보고 데이터만 지원합니다.
Metadata.dimensions 리소스와 Metadata.metrics 리소스가 삭제되었습니다.
보고서의 CSV 버전을 생성하는 새로운 메서드가 추가되어 v1.4의 쿼리 매개변수를 대체합니다. 참고: 압축의 경우 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_range을 CUSTOM로 설정하여 start_date 및 end_date을 지정할 수 있습니다.
- start_date 및 end_date 필드가 문자열 유형에서 google.type.Date 유형으로 변경되었습니다. 참고: 따라서 상대 날짜 키워드 (예: 'today-6d')는 더 이상 지원되지 않습니다.
- 불리언 필드 use_timezone_reporting가 reporting_time_zone로 대체되었습니다. reporting_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 필드는 특정 사이트에서 자동 광고가 사용 설정되었는지 여부를 나타내는 불리언입니다.