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 đồ 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 để thê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.

2024-04-03

PolicyIssues

Thêm một tập hợp báo cáo 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

Thanh toán

payments.list hiện trả về chi tiết về các khoản thanh toán cho các 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à 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 trang (với một số lưu ý, hãy xem Chi tiết về 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 những 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 những 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ỏ 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, ứng dụng quảng cáo không hoạt động hiện sẽ đượ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 trên YouTube. Thay đổi này diễn ra trước khi chúng tôi triển khai theo từng giai đoạn đối với trải nghiệm AdSense được cải thiện cho nhà sáng tạo trên YouTube, trong đó, thu nhập từ YouTube sẽ được tách sang tài khoản thanh toán riêng. Thông tin thanh toán của 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 sau đây:
- accounts/{account}/payments/youtube-unpaid cho các khoản thu nhập trên YouTube chưa thanh toán (hiện tại).
- 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 trên AdSense vẫn không thay đổi:
- accounts/{account}/payments/unpaid cho các 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 vi phạm

Thêm phương diện AD_FORMAT_NAME và AD_FORMAT_CODE, cho biết cách quảng cáo hiển thị với 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 phiên bản 1.4 có các phương diện trùng tên nhưng thành phần khác nhau; 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

Mọi 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 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 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 đã đượ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. Trường này là danh sách các nhiệm vụ chưa hoàn thành cần được hoàn thành trong quá trình đăng ký tài khoản mới. Ví dụ: các tác vụ có thể liên quan đến hồ sơ thanh toán hoặc xác minh số điện thoại của bạn.
Trường sub_accounts đã bị xoá. 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 theo quy tắc đệ quy.

AdClient

Xoá trường arc_opt_in vì trường đó đã bị xoá khỏi giao diện người dùng AdSense.
Thay thế trường supports_reporting 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 đó 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.
Những 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.
Trường is_dismissible đã bị xoá.
Trường locale đã được đổ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 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 USD", "87,65 bảng Anh").

Báo vi phạm

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à chúng tôi sẽ không hỗ trợ tài sản AdMob và YouTube 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á.
Các phương thức mới đã được thêm vào để tạo phiên bản báo cáo CSV, 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ừ 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ụ: "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 (tức 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.
- Trường start_index đã bị xoá.
- 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 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.
- 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 vào để tìm nạp dữ liệu về những 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 trong số các trạng thái sau đây: REQUIRES_REVIEW, GETTING_READY, READY, NEEDS_ATTENTION.
Trường auto_ads_enabled là một giá trị boolean cho biết quảng cáo tự động đã được bật trên một trang web cụ thể hay chưa.