Tách riêng sự đồng ý trong API Google Ads

Thứ Năm, ngày 20 tháng 2 năm 2025

Điều gì sẽ thay đổi?
Kể từ tuần bắt đầu từ ngày 1 tháng 5 năm 2025, chúng tôi sẽ triển khai tính năng tách riêng sự đồng ý cho quy trình xác thực người dùng OAuth cho tất cả dự án trên đám mây của Google được tạo trước năm 2019. Nếu sở hữu một ứng dụng sử dụng API liên quan đến Google Ads thông qua một dự án trên đám mây của Google Cloud được tạo trước năm 2019, thì bạn có thể cần phải cập nhật ứng dụng của mình để xử lý sự đồng ý của người dùng riêng biệt trước ngày 1 tháng 5 năm 2025.

Thông tin khái quát
Tính năng tách riêng sự đồng ý cho quy trình xác thực người dùng OAuth cho phép người dùng tuỳ chỉnh những phạm vi OAuth cụ thể mà họ muốn uỷ quyền cho ứng dụng của bạn, thay vì phải đồng ý với tất cả hoặc không đồng ý với phạm vi nào. Tất cả dự án trên Google Cloud Console được tạo từ năm 2019 đều bật tính năng này, trong khi tất cả dự án được tạo trước năm 2019 đều tắt tính năng này.

Ai chịu ảnh hưởng của thay đổi này?
Bạn sẽ chịu ảnh hưởng của thay đổi này nếu đáp ứng TẤT CẢ các điều kiện sau:

  1. Ứng dụng API của bạn sử dụng một dự án trên Google Cloud Console được tạo trước năm 2019.
  2. Ứng dụng của bạn triển khai quy trình lấy sự đồng ý của người dùng OAuth 2.0 – một quy trình xác thực trong đó người dùng đăng nhập bằng Tài khoản Google của họ và cấp một hoặc nhiều quyền mà ứng dụng của bạn đang yêu cầu.
  3. Ứng dụng của bạn sử dụng nhiều API của Google và một trong số đó là API liên quan đến Google Ads được liệt kê bên dưới.

Những ai không chịu ảnh hưởng của thay đổi này?

  • Mã làm mới hiện có: Thay đổi này không ảnh hưởng đến các phương thức xác thực người dùng mà bạn đã áp dụng. Mã làm mới hiện tại của bạn sẽ tiếp tục hoạt động mà không có bất kỳ thay đổi hoặc yêu cầu xác thực lại nào.
  • Ứng dụng có một phạm vi: Nếu ứng dụng của bạn chỉ sử dụng một phạm vi API của Google, thì ứng dụng đó sẽ không chịu ảnh hưởng của thay đổi này vì không có nhiều phạm vi OAuth để phân tách.
  • Ứng dụng một người dùng/Ứng dụng được xác thực thủ công: Ứng dụng của bạn chưa triển khai quy trình xác thực người dùng OAuth rõ ràng. Thay vào đó, bạn sử dụng một tập lệnh xác thực thủ công như GenerateUserCredentials, gcloud CLI hoặc OAuth Playground để xác thực người dùng, sau đó sử dụng thông tin xác thực đó trong một khoảng thời gian dài. Vì bạn chọn tất cả các phạm vi mà ứng dụng của bạn yêu cầu trong khi xác thực, nên ứng dụng của bạn không bị ảnh hưởng bởi thay đổi này.
  • Tài khoản dịch vụ: Nếu ứng dụng của bạn sử dụng tài khoản dịch vụ để xác thực các lệnh gọi API, thì bạn sẽ không bị ảnh hưởng bởi thay đổi này

Tôi cần phải làm gì?
Bạn cần đảm bảo rằng ứng dụng của mình có thể xử lý trường hợp người dùng chỉ đồng ý một phần. Cách thực hiện:

  1. Yêu cầu danh sách phạm vi OAuth mà người dùng đã đồng ý bằng cách thêm tham số include_granted_scopes vào quy trình OAuth.
  2. Kiểm tra danh sách thực tế các phạm vi OAuth mà người dùng đã đồng ý trong phản hồi OAuth.
  3. Triển khai quy trình uỷ quyền gia tăng trong ứng dụng của bạn.

Xem hướng dẫn về sự đồng ý chi tiết của OAuth để tìm hiểu về các yêu cầu và phương pháp hay nhất để xử lý sự đồng ý chi tiết.

Làm cách nào để thử nghiệm tính năng này?
Có hai cách để kiểm thử tính năng này:

  1. Tạo một dự án trên đám mây mới trên Google Cloud: Các dự án trên đám mây mới trên Google Cloud đã bật tính năng tách riêng màn hình xin phép bằng OAuth. Vì vậy, bạn có thể tạo một dự án trên đám mây của Google mới và sử dụng dự án đó để thử nghiệm ứng dụng của mình.
  2. Bật tính năng tách riêng yêu cầu đồng ý trong dự án hiện có: Bạn có thể đặt tham số enable_granular_consent thành true trong yêu cầu uỷ quyền OAuth.

Những phạm vi API nào bị ảnh hưởng?
Các API sau đây liên quan đến Google Ads sẽ chịu ảnh hưởng của thay đổi này.

API Phạm vi của OAuth
API Google Ads https://adwords.google.com/api/adwords
API Google Ad Manager (SOAP API, Thử nghiệm) https://www.googleapis.com/auth/dfp
https://www.googleapis.com/auth/admanager
Bid Manager API https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping https://www.googleapis.com/auth/content
Display & Video 360 API https://www.googleapis.com/auth/display-video-mediaplanning
https://www.googleapis.com/auth/display-video-user-management
API AdMob https://www.googleapis.com/auth/admob.report
https://www.googleapis.com/auth/admob.googlebidding.readwrite
https://www.googleapis.com/auth/admob.monetization
AdSense cho Nền tảng API https://www.googleapis.com/auth/adsensehost
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly
API Google Analytics https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
https://www.googleapis.com/auth/analytics.manage.users
https://www.googleapis.com/auth/analytics.manage.users.readonly
https://www.googleapis.com/auth/analytics.provision
https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API https://www.googleapis.com/auth/ddmconversions
https://www.googleapis.com/auth/dfareporting
https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API https://www.googleapis.com/auth/doubleclicksearch
API Trình quản lý thẻ của Google https://www.googleapis.com/auth/tagmanager.delete.containers
https://www.googleapis.com/auth/tagmanager.edit.containers
https://www.googleapis.com/auth/tagmanager.edit.containerversions
https://www.googleapis.com/auth/tagmanager.manage.accounts
https://www.googleapis.com/auth/tagmanager.manage.users
https://www.googleapis.com/auth/tagmanager.publish
https://www.googleapis.com/auth/tagmanager.readonly
API Đặt giá thầu theo thời gian thực https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API https://www.googleapis.com/auth/authorized-buyers-marketplace
https://www.googleapis.com/auth/adexchange.buyer

Cách yêu cầu trợ giúp
Nếu bạn có câu hỏi hoặc cần được trợ giúp, hãy liên hệ với nhóm hỗ trợ của API tương ứng để đặt câu hỏi.

Nhãn: authentication, oauth