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

출시 노트

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

버전 2

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

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

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

계정

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 수입의 리소스 이름 형식은 다음과 같습니다.
- 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_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 필드가 삭제되었습니다. v2에서는 listChildAccounts 맞춤 메서드를 사용하여 유사한 기능을 사용할 수 있습니다. 전체 하위 계정 트리는 v2에서 listChildAccounts를 재귀적으로 호출하여 생성할 수 있습니다.

AdClient

애드센스 UI에서 이미 삭제되었으므로 arc_opt_in 필드를 삭제했습니다.
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를 사용하면 이제 AdSense Management API 보고 데이터가 애드센스 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 필드는 특정 사이트에서 자동 광고가 사용 설정되었는지 여부를 나타내는 불리언입니다.