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_CLICKSFUNNEL_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

AdClient

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_NAMEAD_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_CONTENTLINK.
  • 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_DAYSLAST_30_DAYS) hoặc bạn có thể chỉ định start_dateend_date bằng cách đặt date_range thành CUSTOM.
    • Các trường start_dateend_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.

Phiên bản 1.4

Phiên bản này giới thiệu chức năng sau:

  • Giờ đây, bạn có thể liệt kê các khoản thanh toán trong tài khoản AdSense của mình bằng đơn vị tiền tệ tương ứng.
  • Giờ đây, bạn có thể loại bỏ một cảnh báo bằng cách gọi phương thức delete. Phương thức này sẽ ẩn cảnh báo trong giao diện web API và AdSense.
  • Phản hồi báo cáo hiện bao gồm ngày bắt đầu và ngày kết thúc. Điều này rất quan trọng nếu bạn đang sử dụng ngày tương đối khi tạo báo cáo (chẳng hạn như today, yesterday, firstDayOfMonth-1m), thì phản hồi hiện sẽ bao gồm phạm vi ngày mà bạn đã yêu cầu.

Lỗi đã biết

Trường currency trong báo cáo không được hỗ trợ trong bản phát hành này.

Phiên bản 1.3

Phiên bản này giới thiệu chức năng sau:

  • Có thể truy xuất cảnh báo.
  • Có thể truy xuất siêu dữ liệu về chỉ số và phương diện.
  • Có thể chạy báo cáo theo múi giờ địa phương của tài khoản.

Lỗi đã biết

Trường currency trong báo cáo không được hỗ trợ trong bản phát hành này.

Phiên bản 1.2

Phiên bản này giới thiệu chức năng sau:

  • Khả năng truy lục kiểu quảng cáo.
  • Khả năng truy xuất và thực thi các báo cáo đã lưu được xác định trong giao diện người dùng.

Lỗi đã biết

Trường currency trong báo cáo không được hỗ trợ trong bản phát hành này.

Phiên bản 1.1

Phiên bản này giới thiệu chức năng sau:

Ngoài ra, giờ đây bạn có thể truy cập dữ liệu trong tài khoản mặc định hoặc trong một tài khoản cụ thể.

Lỗi đã biết

Trường currency trong báo cáo không được hỗ trợ trong bản phát hành này.

Phiên bản 1

Đây là bản phát hành đầu tiên của API. Hộp cát về quyền riêng tư bao gồm tính năng hỗ trợ truy xuất ứng dụng quảng cáo, đơn vị quảng cáo, kênh tuỳ chỉnh, kênh URL cũng như chạy báo cáo.

Lỗi đã biết

Trường currency trong báo cáo không được hỗ trợ trong bản phát hành này.