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

출시 노트

이 페이지에는 애드센스 관리 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

계정

이제 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

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_range를 CUSTOM로 설정하여 start_date 및 end_date를 지정할 수 있습니다.
- start_date 및 end_date 필드가 문자열 유형에서 google.type.Date 유형으로 변경되었습니다. 참고: 따라서 상대적 날짜 키워드 (예: 'today-6d')는 더 이상 지원되지 않습니다.
- 불리언 필드 use_timezone_reporting가 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 필드는 특정 사이트에 자동 광고가 사용 설정되었는지 여부를 나타내는 불리언입니다.