Thứ Năm, ngày 10 tháng 9 năm 2026
Để cải thiện trải nghiệm sử dụng và làm quen cho nhà phát triển, chúng tôi đã xây dựng một trang chủ mới cho Google Ads API trong Google Cloud Console. Giờ đây, các ứng dụng có Quyền truy cập cơ bản sẽ được tự động hoá cho những nhà phát triển đã hoàn tất quy trình xác minh thương hiệu. Bài đăng này trên blog đề cập đến một số thay đổi có liên quan sẽ bắt đầu được triển khai từ hôm nay. Nhà phát triển nên xem phần việc cần làm trong bài đăng này để đảm bảo quá trình chuyển đổi diễn ra suôn sẻ.
Thay đổi đối với việc quản lý quyền truy cập API
Chúng tôi đang cập nhật cách bạn đăng ký và quản lý quyền truy cập vào Google Ads API.
Trải nghiệm mới khi làm quen với Google Ads API: Giờ đây, bạn có thể đăng ký quyền truy cập vào Google Ads API ngay trong Google Cloud Console mà không cần có tài khoản người quản lý Google Ads. Chúng tôi sẽ ngừng cung cấp tất cả chức năng đăng ký mới và quản lý quyền truy cập API trên trang Trung tâm API trong tài khoản người quản lý và chuyển sang trang Tổng quan về Google Ads API trong Google Cloud Console. Bạn vẫn có thể truy cập vào trang Trung tâm API để tham khảo thông tin chi tiết cũ về nhà phát triển. Trang này sẽ ngừng hoạt động hoàn toàn trong tương lai.
Cấp truy cập API được liên kết với các dự án trên Google Cloud: Chúng tôi sẽ ngừng sử dụng mã của nhà phát triển. Cấp truy cập hiện tại và đang hoạt động của mã nhà phát triển sẽ tự động được chuyển sang các dự án trên đám mây của Google dựa trên hoạt động gần đây của API. Bạn có thể tiếp tục gửi mã của nhà phát triển trong tiêu đề lệnh gọi API, nhưng việc này là không bắt buộc và máy chủ API sẽ bỏ qua. Mã hiện tại của bạn sẽ tiếp tục hoạt động mà không cần thay đổi. Cấp truy cập API của bạn hiện được xác định theo dự án trên Google Cloud mà bạn đã dùng để tạo thông tin xác thực OAuth. Hãy tham khảo trang Câu hỏi thường gặp của chúng tôi để tìm hiểu thêm về thay đổi này và cách khắc phục mọi vấn đề bạn có thể gặp phải.
Mã lỗi mới: Phiên bản v25 của Google Ads API sẽ gửi lỗi CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION nếu bạn cố gắng sử dụng một dự án trên đám mây của Google có Cấp truy cập vào tài khoản thử nghiệm để thực hiện lệnh gọi đến một tài khoản chính thức. Các phiên bản API cũ sẽ gửi lỗi ACTION_NOT_PERMITTED. Nếu bạn gặp lỗi này, hãy chuyển đến trang Tổng quan về Google Ads API cho dự án trên đám mây của bạn trên Google Cloud rồi đăng ký Quyền truy cập khám phá.
Thay đổi đối với quy trình xem xét API
Cần xác minh thương hiệu để có quyền truy cập Cơ bản và Tiêu chuẩn: Đối với các đơn đăng ký mới để có quyền truy cập Cơ bản và Tiêu chuẩn, bạn phải hoàn tất quy trình xác minh thương hiệu cho dự án của mình trên Google Cloud . Những người hiện có quyền truy cập không bắt buộc phải hoàn tất quy trình xác minh thương hiệu, nhưng chúng tôi khuyến khích họ làm việc này.
Tự động phê duyệt quyền truy cập Cơ bản: Giờ đây, các đơn đăng ký quyền truy cập Cơ bản sẽ được xử lý tự động và được xem xét trong vòng vài phút sau khi bạn xác minh thương hiệu và gửi đơn đăng ký.
Từ chối một lần đối với các đơn đăng ký quyền truy cập Cơ bản đang chờ xử lý: Do những thay đổi trong quy trình này, tất cả các đơn đăng ký quyền truy cập API Cơ bản đang chờ xử lý sẽ bị đóng trong quá trình chuyển đổi này. Những người đăng ký bị ảnh hưởng sẽ nhận được email có thông tin chi tiết và nên đăng ký lại quyền truy cập API trên trang Tổng quan về Google Ads API.
Việc cần làm
Xác minh cấp truy cập API: Kiểm tra để đảm bảo cấp truy cập API của dự án khớp chính xác với mã của nhà phát triển hiện tại:
- Tìm cấp truy cập của mã của nhà phát triển trong Trung tâm API của tài khoản người quản lý Google Ads.
- Xác nhận rằng dự án trên đám mây của bạn trên Google Cloud có cùng cấp truy cập trên trang Tổng quan về Google Ads API.
- Nếu cấp truy cập không khớp, vui lòng đăng ký lại để có quyền truy cập API trên trang Tổng quan về Google Ads API hoặc liên hệ với Nhóm hỗ trợ Google Ads API nếu bạn cần được trợ giúp.
Cập nhật địa chỉ email liên hệ API: Truy cập vào trang IAM (Quản lý danh tính và quyền truy cập) cho dự án trên đám mây của bạn. Đảm bảo rằng danh sách người dùng có vai trò chủ sở hữu và người chỉnh sửa đã cập nhật. Chúng tôi sẽ bắt đầu gửi Thông báo bắt buộc về dịch vụ (MSA) đến những địa chỉ email này để thông báo cho bạn về mọi thay đổi trong tương lai đối với Google Ads API.
Thay đổi về mã: Bạn nên cập nhật mã xử lý ứng dụng để ngừng gửi mã nhà phát triển trong các lệnh gọi API. Chúng tôi đã phát hành các phiên bản mới của thư viện ứng dụng, cho phép bạn thực hiện lệnh gọi API mà không cần đặt mã của nhà phát triển. Chúng tôi sẽ bắt đầu từ chối mã nhà phát triển trong các lệnh gọi API trong một phiên bản chính của Google Ads API trong tương lai.
Đăng ký lại để được cấp quyền truy cập API (nếu có): Nếu đơn đăng ký quyền truy cập API Cơ bản đang chờ xử lý của bạn đã bị đóng trong quá trình chuyển đổi này, vui lòng đăng ký lại để được cấp quyền truy cập API trên trang Tổng quan về Google Ads API của Google Cloud Console.
Chúng tôi đã xuất bản tài liệu mới để giúp bạn nắm bắt những thay đổi này. Đối với các vấn đề cần hỗ trợ kỹ thuật, hãy tham khảo trang Câu hỏi thường gặp của chúng tôi hoặc liên hệ với Nhóm hỗ trợ Google Ads API. Nếu bạn có thắc mắc hoặc muốn thảo luận về bài đăng này, vui lòng liên hệ với chúng tôi qua máy chủ Discord của Cộng đồng quảng cáo và đo lường của Google.
– Anash P. Oommen, Nhóm phụ trách Google Ads API
Nhãn: google-ads-api, release