Trang này được dịch bởi Cloud Translation API.

Ghi chú phát hành

Trang này cung cấp ghi chú phát hành cho API Quản lý AdSense.

Phiên bản 2

Phiên bản này có những thay đổi sau đây để loại bỏ chức năng không được dùng nữa và điều chỉnh API Quản lý AdSense theo các tiêu chuẩn hiện tại của Google API. Theo chương trình quản lý phiên bản API của Google, phiên bản này sẽ được cập nhật theo thời gian để bổ sung chức năng (tương thích ngược) thay vì phát hành chức năng mới trong các phiên bản phụ riêng biệt.

2025-10-02

Báo cáo

Đã thêm phương diện TRAFFIC_SOURCE, cho phép chia nhỏ các chỉ số theo nguồn lưu lượng truy cập (ví dụ: "Google", "Bing", "Facebook", "Khác"). Để biết thêm thông tin, hãy xem phần Bảng chi tiết nguồn lưu lượng truy cập.

2025-05-06

PolicyIssues

Trường policyTopics[].must_fix không dùng nữa (xem nội dung cập nhật trước) giờ đây sẽ luôn được đặt thành false.

2025-02-24

PolicyIssues

Thêm trường policyTopics[].type để xác định xem một chủ đề chính sách có phải là vấn đề về chính sách, vấn đề về quy định hay lựa chọn ưu tiên của nhà quảng cáo hay không. Thao tác này sẽ thay thế policyTopics[].must_fix (hiện được đánh dấu là trường không dùng nữa).

2024-04-03

PolicyIssues

Đã thêm một bộ sưu tập mới để báo cáo về các cảnh báo và lỗi vi phạm chính sách hiện tại của một tài khoản.

2023-06-19

Thông tin thanh toán

payments.list hiện trả về thông tin chi tiết về các khoản thanh toán cho nhà xuất bản cao cấp.

2023-06-13

Báo cáo

Đã thêm các chỉ số FUNNEL_REQUESTS, FUNNEL_IMPRESSIONS, FUNNEL_CLICKS và FUNNEL_RPM. Các chỉ số này cung cấp thông tin về hiệu suất của các đơn vị không phải là đơn vị quảng cáo (ví dụ: đơn vị tìm kiếm có liên quan).

2023-03-30

Báo cáo

Đã thêm phương diện PAGE_URL, cho phép phân tích chỉ số theo URL của trang (với một số lưu ý, hãy xem phần Phân tích URL của trang).

2022-09-21

AdUnits

Thêm các phương thức tạo và vá. Xin lưu ý rằng các phương thức này chỉ có thể được dùng bởi những dự án đã bật sản phẩm AdSense cho Nền tảng.

CustomChannels

Đã thêm các phương thức tạo, vá và cập nhật. Xin lưu ý rằng các phương thức này chỉ có thể được dùng bởi những dự án đã bật sản phẩm AdSense cho Nền tảng.
Đã thêm trường đang hoạt động vào tài nguyên.

Tài khoản

Thêm phương thức getAdBlockingRecoveryTag.

2022-08-25

Báo cáo

Thêm phương diện HOSTED_AD_CLIENT_ID, cho phép nhà xuất bản lưu trữ và nhà xuất bản nền tảng phân tích các chỉ số theo tài khoản của nhà xuất bản (nhà xuất bản lưu trữ) và theo tài khoản phụ (nhà xuất bản nền tảng).

2022-05-03

AdClient

Đã thêm phương thức get.

Báo cáo

Đã thêm phương thức getSaved.

UrlChannels

Đã thêm phương thức get.

2022-03-31

Tài khoản

API hiện trả về các tài khoản không hoạt động, với trường state cho biết trạng thái của tài khoản.

AdClient

Tương tự như các thay đổi về Tài khoản, API hiện trả về các ứng dụng quảng cáo không hoạt động, với trường state cho biết trạng thái của ứng dụng quảng cáo.

2022-02-24

Thanh toán

Định dạng tên tài nguyên đã được mở rộng để hỗ trợ các tài nguyên riêng biệt cho thu nhập trên YouTube. Thay đổi này diễn ra trước khi chúng tôi triển khai từng bước trải nghiệm AdSense được cải thiện cho các nhà sáng tạo trên YouTube. Trong đó, thu nhập từ YouTube sẽ được tách thành một tài khoản thanh toán riêng. Thông tin thanh toán của YouTube cũng sẽ được trả về từ phương thức danh sách thanh toán, sau khi bạn có tài khoản thanh toán riêng cho thu nhập từ YouTube. Thu nhập trên YouTube sẽ có định dạng tên tài nguyên như sau:
- accounts/{account}/payments/youtube-unpaid cho thu nhập chưa thanh toán (hiện tại) trên YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd cho thu nhập từ YouTube có tính phí.
Lưu ý: Tên tài nguyên cho thu nhập từ AdSense vẫn không thay đổi:
- accounts/{account}/payments/unpaid cho thu nhập AdSense chưa thanh toán (hiện tại).
- accounts/{account}/payments/yyyy-MM-dd cho thu nhập từ AdSense có tính phí.

2021-06-30

Báo cáo

Đã thêm phương diện AD_FORMAT_NAME và AD_FORMAT_CODE, cho biết cách quảng cáo xuất hiện với người dùng trên trang web của bạn (trong trang, quảng cáo giữa các lần tải trang, v.v.). Xin lưu ý rằng phiên bản 1.4 có các phương diện (không dùng nữa) có cùng tên nhưng có các thành phần khác nhau; 2 phương diện được thêm vào phiên bản 2 khác biệt với những phương diện có trong phiên bản 1.4.

19/4/2021 (Bản phát hành ban đầu)

Tổng quan

Tất cả phương thức không dùng nữa trong phiên bản 1.4 đều đã bị xoá. Trong đó có cả những phương thức tài nguyên không yêu cầu accountId. Trong phiên bản 2, accountId được chỉ định trong trường parent.
Theo các tiêu chuẩn API của Google, các tài nguyên hiện được xác định bằng trường name. Ví dụ: tên của AdClient sẽ có dạng accounts/{accountId}/adclients/{adClientId}. Ngoài ra, trong phiên bản 1.4, mã nhận dạng tài nguyên được dùng làm phương diện báo cáo, nhưng trong phiên bản 2, giá trị đó hiện có sẵn thông qua trường reporting_dimension_id trên một số tài nguyên.
Trường kind đã bị xoá khỏi tất cả các tài nguyên.

Tài khoản

Trường name đã được thay đổi thành display_name.
Trường timezone đã thay đổi từ một chuỗi thành google.type.TimeZone.
Trường creation_time (loại int64) đã được thay đổi thành create_time (loại google.protobuf.Timestamp).
Thêm trường pending_tasks. Đây là danh sách những việc cần làm chưa hoàn thành trong quy trình đăng ký tài khoản mới. Ví dụ: các việc cần làm có thể liên quan đến hồ sơ thanh toán hoặc quy trình xác minh số điện thoại.
Đã xoá trường sub_accounts. Bạn có thể đạt được chức năng tương tự trong phiên bản 2 bằng phương thức tuỳ chỉnh listChildAccounts. Bạn có thể tạo toàn bộ cây tài khoản con trong phiên bản 2 bằng cách gọi listChildAccounts một cách đệ quy.

AdClient

Xoá trường arc_opt_in vì trường này đã bị xoá khỏi giao diện người dùng AdSense.
Trường supports_reporting được thay thế bằng trường reporting_dimension_id. Trường này đại diện cho mã nhận dạng duy nhất của ứng dụng khách quảng cáo như được dùng trong phương diện báo cáo AD_CLIENT_ID. Nếu reporting_dimension_id trống, thì AdClient không hỗ trợ báo cáo.

AdUnit

Trường status đã được đổi tên thành state. Ngoài ra, trạng thái ACTIVE không còn cho biết có hoạt động nào trên đơn vị quảng cáo này trong 7 ngày qua hay không. Trong phiên bản 2, điều này có nghĩa là người dùng đã kích hoạt đơn vị quảng cáo và đơn vị này có thể phân phát quảng cáo.
Đã xoá trường code. Bạn vẫn có thể tìm thấy giá trị này ở cuối trường name (sau dấu gạch chéo cuối cùng).
Đã xoá trường contentAdsSettings.backupOption.
Trường type đã bị hạn chế đối với các giá trị TYPE_UNSPECIFIED, DISPLAY, FEED, ARTICLE, MATCHED_CONTENT và LINK.
Các trường khác đã bị xoá trong giao diện người dùng AdSense cũng sẽ bị xoá: custom_style, saved_style_id, mobile_content_ads_settings, feed_ads_settings.

Cảnh báo

Phương thức delete đã bị xoá.
Đã xoá trường is_dismissible.
Trường locale đã được đổi tên thành language_code.

CustomChannel

Đã xoá trường code. Bạn vẫn có thể tìm thấy giá trị này ở cuối trường name (sau dấu gạch chéo cuối cùng).
Trường targeting_info đã bị xoá vì đã bị xoá khỏi giao diện người dùng AdSense.

Thanh toán

Trường payment_date đã được đổi tên thành date và thay đổi từ loại chuỗi thành loại google.type.Date.
Trường payment_amount và trường payment_amount_currency_code đã được kết hợp thành một trường payment duy nhất (ví dụ: "¥1.235 JPY", "$1.234,57", "£87,65").

Báo cáo

Với phiên bản 2, dữ liệu báo cáo của API Quản lý AdSense hiện phù hợp với giao diện người dùng AdSense. Điều này có nghĩa là các tài sản AdMob và YouTube không còn được hỗ trợ nữa. Ngoài ra, API này sẽ chỉ hỗ trợ dữ liệu báo cáo trong 3 năm trở lại đây.
Tài nguyên Metadata.dimensions và tài nguyên Metadata.metrics đã bị xoá.
Chúng tôi đã thêm các phương thức mới để tạo phiên bản CSV của báo cáo, thay thế các tham số truy vấn trong phiên bản 1.4. Lưu ý: để nén, bạn vẫn có thể sử dụng tiêu đề HTTP "Accept-Encoding: gzip".
Một số trường đã thay đổi khi tạo báo cáo đặc biệt.
- Trường account_id đã được đổi tên thành account.
- Trường dimension đã được đổi tên thành dimensions.
- Trường metric đã được đổi tên thành metrics.
- Trường filter đã được đổi tên thành filters.
- Trường sort đã được đổi tên thành order_by.
- Trường locale đã được đổi tên thành language_code.
- Trường currency đã được đổi tên thành currency_code.
- Giờ đây, bạn có thể chỉ định một số dải ô phổ biến bằng date_range (ví dụ: TODAY, YESTERDAY, MONTH_TO_DATE, YEAR_TO_DATE, LAST_7_DAYS và LAST_30_DAYS) hoặc bạn có thể chỉ định start_date và end_date bằng cách đặt date_range thành CUSTOM.
- Các trường start_date và end_date đã được thay đổi từ loại chuỗi thành loại google.type.Date. Lưu ý: do đó, các từ khoá ngày tương đối (ví dụ: "today-6d") không còn được hỗ trợ nữa.
- Trường boolean use_timezone_reporting đã được thay thế bằng reporting_time_zone. Trường này có thể có một trong hai giá trị: ACCOUNT_TIME_ZONE hoặc GOOGLE_TIME_ZONE (nghĩa là PST/PDT). Giá trị mặc định trong phiên bản 2 là ACCOUNT_TIME_ZONE, khác với giá trị mặc định trong phiên bản 1.4.
- Đã xoá trường start_index.
- Trường max_results đã được đổi tên thành limit.
Một số trường đã được thay đổi trong quá trình tạo báo cáo đã lưu.
- Đã thêm các trường ngày (date_range, start_date, end_date, reporting_time_zone).
- Đã thêm trường currency_code.
- Trường locale đã được đổi tên thành language_code.
- Đã xoá trường start_index.
- Đã xoá trường max_results.

SavedAdStyle

SavedAdStyle đã bị xoá vì đã bị xoá khỏi giao diện người dùng AdSense.

Trang web

Sites đã được thêm để tìm nạp dữ liệu về những trang web mà bạn đã thêm vào tài khoản AdSense.
Trường state cho biết liệu trang web có ở bất kỳ trạng thái nào sau đây hay không: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
Trường auto_ads_enabled là một boolean đại diện cho việc quảng cáo tự động đã được bật trên một trang web cụ thể hay chưa.