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 AdSense Management API.

Phiên bản 2

Phiên bản này ra mắt 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 với các tiêu chuẩn API hiện tại của Google. Theo lược đồ tạo 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 đang được phát hành trong các phiên bản nhỏ riêng biệt.

2023-06-19

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 những đơn vị không phải là quảng cáo (ví dụ: đơn vị nội dung 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 (với một số lưu ý, hãy xem phần Chi tiết URL trang).

2022-09-21

AdUnits

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

Hiện tại, API sẽ trả về những 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, ứng dụng quảng cáo không hoạt động hiện được API trả về, 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 cho thu nhập từ YouTube. Thay đổi này trước khi triển khai theo từng giai đoạn trải nghiệm AdSense cải tiến cho nhà sáng tạo trên YouTube, trong đó, các khoản thu nhập từ YouTube sẽ được tách riêng vào tài khoản thanh toán riêng. Thông tin thanh toán từ YouTube cũng sẽ được trả lại qua 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 để biết thu nhập trả phí trên YouTube.
Lưu ý: Tên tài nguyên cho thu nhập AdSense vẫn không thay đổi:
- accounts/{account}/payments/unpaid cho khoản thu nhập chưa thanh toán (hiện tại) trên AdSense.
- accounts/{account}/payments/yyyy-MM-dd để biết thu nhập trả phí trên AdSense.

2021-06-30

Báo cáo

Thêm các phương diện AD_FORMAT_NAME và AD_FORMAT_CODE, cho biết cách quảng cáo hiển thị cho người dùng trên trang web của bạn (trong trang, quảng cáo giữa lần tải trang, v.v.). Lưu ý rằng v1.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 phần; hai phương diện được thêm trong v2 khác với các phương diện có trong v1.4.

19/04/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 đều đã bị xoá. Điều này bao gồm cả 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 tiêu chuẩn API của Google, tài nguyên giờ đây được xác định bằng trường name. Ví dụ: tên của AdClient sẽ trông giố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 sử 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 đã đượ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. Đây là danh sách các công việc chưa xử lý mà bạn cần 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.
Trường sub_accounts đã bị xoá. Bạn có thể sử dụng chức năng tương tự trong phiên bản 2 bằng phương thức tuỳ chỉnh listChildAccounts. Hệ thống 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 đệ 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 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ợ tính năng báo cáo.

AdUnit

Trường status đổ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 trên đơn vị quảng cáo này trong 7 ngày qua hay không. Trong phiên bản 2, trạng thái này có nghĩa là đơn vị quảng cáo đã được người dùng kích hoạt và có thể phân phát quảng cáo.
Trường code đã bị xoá. 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 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á.
Trường is_dismissible đã bị xoá.
Trường locale đổi tên thành language_code.

CustomChannel

Trường code đã bị xoá. 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ì đã 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ừ chuỗi loại thành 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 USD", "87,65 bảng Anh").

Báo cáo

Với phiên bản 2, dữ liệu báo cáo API Quản lý AdSense đã điều chỉnh cho phù hợp với giao diện người dùng AdSense. Điều này có nghĩa là AdMob và YouTube không còn được hỗ trợ nữa. Ngoài ra, API sẽ chỉ hỗ trợ dữ liệu báo cáo cách đây 3 năm.
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 đã được thay đổi khi tạo báo cáo đặc biệt.
- Trường account_id đổi tên thành account.
- Trường dimension đổi tên thành dimensions.
- Trường metric đổi tên thành metrics.
- Trường filter đổi tên thành filters.
- Trường sort đổi tên thành order_by.
- Trường locale đổi tên thành language_code.
- Trường currency đổi tên thành currency_code.
- Hiện 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ừ chuỗi loại thành loại google.type.Date. Lưu ý: do đó, các từ khoá có liên quan đến ngày tương đối (ví dụ: "hôm nay-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 (tức là PST/PDT). Giá trị mặc định trong phiên bản 2 là ACCOUNT_TIME_ZONE, khác với chế độ mặc định trong phiên bản 1.4.
- Trường start_index đã bị xoá.
- Trường max_results đổ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 đổi tên thành language_code.
- Trường start_index đã bị xoá.
- Trường max_results đã bị xoá.

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ề các trang web mà bạn đã thêm vào tài khoản AdSense của mình.
Trường state cho biết trang web có ở trạng thái nào sau đây: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION hay không.
Trường auto_ads_enabled là một giá trị boolean cho biết liệu quảng cáo tự động đã được bật trên một trang web cụ thể hay chưa.