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 giới thiệu các thay đổi sau để xoá chức năng không dùng nữa và điều chỉnh API Quản lý AdSense cho phù hợp với các tiêu chuẩn API hiện tại của Google. Theo lược đồ phiên bản API của Google, phiên bản này sẽ được cập nhật theo thời gian để bao gồm chức năng bổ sung (tương thích ngược) thay vì chức năng mới được phát hành trong các phiên bản nhỏ riêng biệt.

2025-02-24

PolicyIssues

Thêm trường policyTopics[].type để xác định xem một chủ đề về 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 tập hợp mới để báo cáo về các lỗi vi phạm chính sách và cảnh báo hiện có đối với một tài khoản.

2023-06-19

Thông tin thanh toán

Giờ đây, payments.list sẽ 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 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 các chỉ số theo URL của trang (có 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 chỉ những dự án được bật sản phẩm AdSense cho nền tảng mới có thể sử dụng các phương thức này.

CustomChannels

Thêm các phương thức tạo, vá và cập nhật. Xin lưu ý rằng chỉ những dự án được bật sản phẩm AdSense cho nền tảng mới có thể sử dụng các phương thức này.
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

Giờ đây, API sẽ 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 ở trê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 được thực hiện trước khi chúng tôi triển khai từng bước trải nghiệm AdSense cải tiến dành cho nhà sáng tạo trên YouTube. Trong đó, thu nhập từ YouTube sẽ được tách riêng vào một tài khoản thanh toán riêng. Thông tin thanh toán trên YouTube cũng sẽ được trả về từ phương thức danh sách khoản thanh toán sau khi bạn có một 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 đối với thu nhập chưa thanh toán (hiện tại) trên YouTube.
- accounts/{account}/payments/youtube-yyyy-MM-dd đối với thu nhập có tính phí từ YouTube.
Lưu ý: Tên tài nguyên cho thu nhập từ AdSense vẫn không thay đổi:
- accounts/{account}/payments/unpaid để biết các khoản thu nhập chưa được thanh toán (hiện tại) từ AdSense.
- accounts/{account}/payments/yyyy-MM-dd đối với thu nhập từ AdSense đã được thanh toán.

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 hiển thị quảng cáo với người dùng trên trang web của bạn (trong trang, quảng cáo dạng hình ảnh, 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 khác thành viên; hai phương diện được thêm vào phiên bản 2 khác với các phương diện có trong phiên bản 1.4.

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

Tổng quan

Tất cả phương thức không dùng nữa trong phiên bản 1.4 đã bị xoá. Điều này bao gồm các 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 như 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ả tài nguyên.

Tài khoản

Trường name đã được thay đổi thành display_name.
Trường timezone đã được 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 là danh sách các tác vụ chưa hoàn tất cần hoàn thành trong quy trình đăng ký tài khoản mới. Ví dụ: các nhiệm vụ có thể liên quan đến hồ sơ thanh toán hoặc xác minh qua đ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 cây tài khoản con đầy đủ trong phiên bản 2 bằng cách gọi listChildAccounts đệ 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, đại diện cho mã nhận dạng duy nhất của ứng dụng quảng cáo được dùng trong phương diện báo cáo AD_CLIENT_ID. Nếu reporting_dimension_id trống, thì AdClient sẽ 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 liệu 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à 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 lên cuối cùng).
Trường contentAdsSettings.backupOption đã bị xoá.
Trường type đã bị hạn chế ở 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

Xoá phương thức delete.
Đã 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 lên cuối cùng).
Trường targeting_info đã bị xoá vì trường này đã 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ừ kiểu chuỗi thành kiểu 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 Yên Nhật", "1.234,57 đô la Mỹ", "87,65 bảng Anh").

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.
Tài nguyên Metadata.dimensions và tài nguyên Metadata.metrics đã bị xoá.
Các phương thức mới đã được thêm vào để 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 đã được 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ừ kiểu chuỗi thành kiểu 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ợ.
- 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 (có 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 khi 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

Chúng tôi đã thêm Sites để tìm nạp dữ liệu về các 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 biểu thị liệu quảng cáo tự động đã được bật trên một trang web cụ thể hay chưa.