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

출시 노트

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

버전 2

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

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/미지급 (현재) 애드센스 수입입니다.
- accounts/{account}/payments/yyyy-MM-dd:

2021-06-30

보고서

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

2021년 4월 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 필드는 특정 사이트에 자동 광고가 사용 설정되었는지 여부를 나타내는 불리언입니다.