Mã thông báo của nhà phát triển

Mã của nhà phát triển là một chuỗi gồm 22 ký tự chữ và số được dùng để kết nối ứng dụng của bạn với Google Ads API. Mã thông báo dành cho nhà phát triển sẽ ngừng hoạt động từ ngày 9 tháng 9 năm 2026. Hướng dẫn này tóm tắt các thay đổi và liệt kê các câu hỏi thường gặp về quá trình di chuyển này để hỗ trợ các nhà phát triển hiện tại.

Điều gì sẽ thay đổi?

Chúng tôi đã thực hiện một số thay đổi đối với trải nghiệm tham gia Google Ads API và hoạt động quản lý quyền truy cập API trong quá trình ngừng cung cấp mã của nhà phát triển. Phần này nêu bật những thay đổi chính.

Các 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 cung cấp mã thông báo dành cho nhà phát triển kể từ ngày 9 tháng 9 năm 2026. Cấp truy cập mã của nhà phát triển hiện tại và đang hoạt động của bạn đã được tự động chuyển sang các dự án Google Cloud dựa trên hoạt động gần đây của API. Bạn có thể tiếp tục gửi mã thông báo của nhà phát triển trong tiêu đề lệnh gọi API, nhưng đây là lựa chọn không bắt buộc và sẽ bị máy chủ API bỏ qua. Mã hiện có của bạn sẽ tiếp tục hoạt động mà không có bất kỳ thay đổi nào. Giờ đây, các cấp truy cập API của bạn được xác định bằng dự án trên đám mây của Google mà bạn đã dùng để tạo thông tin đăng nhập OAuth.

Trải nghiệm đăng ký mới cho API Google Ads

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 tài khoản người quản lý Google Ads. Đừng đăng ký mã của nhà phát triển trên trang API Center hoặc tìm cách đăng ký quyền truy cập API trên trang API Center trong tài khoản người quản lý Google Ads vì các quy trình này đã được chuyển sang Google Cloud Console và sẽ không được xử lý nếu được bắt đầu trên trang API Center.

Trải nghiệm mới về quản lý quyền truy cập API

Chúng tôi đã 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, chẳng hạn như đăng ký quyền truy cập API và quản lý các cấp truy cập API trong trang Trung tâm API trong tài khoản người quản lý Google Ads. Những chức năng này hiện có trên 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 về nhà phát triển trước đây. Trang này sẽ ngừng hoạt động hoàn toàn trong tương lai.

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 tài khoản kiểm thử để gọi một tài khoản sản xuất. Các phiên bản API cũ sẽ gặp 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 Google Cloud của bạn và đăng ký quyền truy cập vào Explorer.

Bạn phải xác minh thương hiệu để có Quyền truy cập cơ bản và Quyền truy cập tiêu chuẩn

Đối với các ứng dụng có Quyền truy cập cơ bản và Quyền truy cập tiêu chuẩn mới, bạn phải hoàn tất quy trình xác minh thương hiệu cho dự án trên đám mây của Google. Những người đang 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, mặc dù bạn nên làm.

Giờ đây, các ứng dụng có Quyền truy cập cơ bản sẽ được tự động hoá 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 yêu cầu.

Do những thay đổi này đối với quy trình, tất cả các đơn đăng ký quyền truy cập vào Basic API đ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à phải đăng ký lại quyền truy cập vào API trên trang Tổng quan về API Google Ads.

Địa chỉ email liên hệ mới của API

Khi chuẩn bị ngừng hoạt động trang Trung tâm API, chúng tôi sẽ chuyển sang sử dụng danh sách người dùng là chủ sở hữu và người chỉnh sửa trong dự án Google Cloud của bạn làm kênh duy nhất để liên lạc về việc quản trị và tuân thủ bắt buộc. Để đảm bảo quá trình chuyển đổi diễn ra suôn sẻ, chúng tôi sẽ tạm thời tiếp tục gửi Thông báo bắt buộc về dịch vụ (MSA) đến địa chỉ email có trong Trung tâm API của bạn. Chúng tôi sẽ thông báo cho bạn khi hoàn tất quá trình chuyển đổi các kênh liên lạc của mình.

Việc cần làm nếu bạn là nhà phát triển hiện tại

Xem xét cấp độ truy cập API của dự án Google Cloud: Nếu là nhà phát triển hiện tại, bạn nên xem xét trang Tổng quan về API Google Ads của các dự án Google Cloud để đảm bảo rằng các dự án này có cùng cấp độ truy cập API với mã của nhà phát triển hiện tại. Hãy làm theo hướng dẫn trong bài viết này để giải quyết mọi điểm khác biệt mà bạn có thể thấy.

Kiểm tra địa chỉ email liên hệ về 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 Google. Xác minh rằng các nhà phát triển và người quản lý tài khoản Ads đang hoạt động của bạn được chỉ định vai trò chủ sở hữu hoặc người chỉnh sửa phù hợp trong dự án trên đám mây của Google. 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. Chúng tôi sẽ tiếp tục gửi MSA đến địa chỉ email liên hệ được liệt kê trong Trung tâm API của bạn trong một khoảng thời gian tạm thời và chúng tôi sẽ thông báo cho bạn bất cứ khi nào quy trình này có thay đổi.

Khắc phục mã ứng dụng: Bạn nên cập nhật ứng dụng để ngừng gửi mã của nhà phát triển trong các lệnh gọi API. Chúng tôi đã xuất bản các phiên bản mới của thư viện ứng dụng, máy chủ MCP của Google Ads và Trợ lý nhà phát triển API Google Ads. Các phiên bản này cho phép bạn thực hiện các lệnh gọi API mà không cần đặt mã thông báo nhà phát triển. Chúng tôi sẽ bắt đầu từ chối mã của nhà phát triển trong các lệnh gọi API ở một phiên bản lớn trong tương lai của Google Ads API. Nếu ứng dụng của bạn dùng các thư viện này, hãy cập nhật các phần phụ thuộc của ứng dụng để dùng phiên bản mới nhất.

Hãy liên hệ với Nhóm hỗ trợ Google Ads API nếu bạn cần được hỗ trợ thêm hoặc có thêm câu hỏi.

Câu hỏi thường gặp

Điều gì sẽ xảy ra với các cấp truy cập API?

Các cấp truy cập API vẫn được thực thi trong Google Ads API. Tuy nhiên, giờ đây, các quyền này được cấp cho dự án trên Google Cloud Console thay vì mã của nhà phát triển. Khi bạn thực hiện các lệnh gọi API, cấp truy cập API của bạn hiện được xác định bằng dự án Google Cloud mà bạn đã dùng để tạo thông tin xác thực OAuth.

Làm cách nào để xác định những dự án cần chuyển cấp độ truy cập API?

Nếu bạn đã có mã của nhà phát triển được phê duyệt trước ngày 9 tháng 9 năm 2026, thì các cấp truy cập của mã đó đã được chuyển sang các dự án của bạn trên Google Cloud như sau:

  • Chúng tôi đã xem xét nhật ký lệnh gọi API trong 90 ngày qua để xác định những dự án trên Cloud được dùng để thực hiện lệnh gọi API bằng mã của nhà phát triển đã được phê duyệt của bạn.
  • Chúng tôi đã chỉ định các cấp độ truy cập API của mã thông báo nhà phát triển cho tất cả các dự án trên Đám mây mà chúng tôi xác định được.

Sau thay đổi này, tôi có thể có nhiều dự án trên đám mây với nhiều cấp truy cập không?

Có, bạn có thể có nhiều dự án trên Google Cloud với các cấp độ truy cập API khác nhau. Ví dụ: bạn có thể có một dự án trên Google Cloud có Quyền truy cập cơ bản và một dự án khác trên Google Cloud có Quyền truy cập tiêu chuẩn.

Ví dụ

Ví dụ: giả sử bạn có 4 mã thông báo nhà phát triển và 6 dự án trên Cloud với thông tin chi tiết như sau:

  • Mã thông báo nhà phát triển 1: abcdefghijkl1234567890 có Quyền truy cập thông thường. Mã này đã được dùng với mã dự án: 1234567890, 5678912345, 45678912345.
  • Mã thông báo nhà phát triển 2: xyzabcdefghi6789012345 có Quyền truy cập cơ bản. Đã dùng với mã dự án: 1231235678.
  • Mã của nhà phát triển 3: asdfgflkjhjz7654321012 có Quyền truy cập cơ bản nhưng chưa bao giờ được dùng để thực hiện lệnh gọi API. Nội dung này mới được phê duyệt gần đây.
  • Mã thông báo nhà phát triển 4: qwertypoiuyu6543298790 có Quyền truy cập tiêu chuẩn, nhưng không được sử dụng trong 90 ngày qua. Mã dự án 9876564900 đã được dùng với mã của nhà phát triển này trước đây.
  • Dự án trên đám mây: Mã dự án trên đám mây: 7171234567 chưa từng được dùng với bất kỳ mã thông báo nhà phát triển nào để thực hiện lệnh gọi API.

Các cấp độ truy cập API sẽ được chuyển từ mã của nhà phát triển sang các dự án Google Cloud như sau:

Mã của nhà phát triển Mã dự án Cấp truy cập Giải thích
abcdefghijkl1234567890 1234567890 Truy cập chuẩn Mã của nhà phát triển và mã dự án được liên kết với nhau.
abcdefghijkl1234567890 5678912345 Truy cập chuẩn Mã của nhà phát triển và mã dự án được liên kết với nhau.
abcdefghijkl1234567890 45678912345 Truy cập chuẩn Mã của nhà phát triển và mã dự án được liên kết với nhau.
xyzabcdefghi6789012345 1231235678 Quyền truy cập cơ bản Mã của nhà phát triển và mã dự án được liên kết với nhau.
asdfgflkjhjz7654321012 -- -- Quyền truy cập API của mã thông báo nhà phát triển chưa được chuyển sang bất kỳ dự án nào vì mã này chưa bao giờ được dùng để thực hiện lệnh gọi API.
qwertypoiuyu6543298790 9876564900 Quyền truy cập vào tài khoản thử nghiệm Quyền truy cập API của mã thông báo nhà phát triển đã bị thu hồi do không hoạt động trong 90 ngày. Cấp truy cập API của dự án mặc định là quyền truy cập vào Tài khoản kiểm thử.
-- 7171234567 Quyền truy cập vào tài khoản thử nghiệm Đây là một dự án mới và chưa được dùng với bất kỳ mã của nhà phát triển nào. Cấp truy cập API của dự án mặc định là Quyền truy cập vào tài khoản kiểm thử.

Tôi có nhiều mã của nhà phát triển được phê duyệt. Bạn sẽ chuyển cấp độ truy cập API cho dự án nào?

Cấp truy cập của mỗi mã của nhà phát triển được phê duyệt sẽ được chuyển sang các dự án trên Google Cloud được liên kết với mã của nhà phát triển đó. Xem một ví dụ.

Tôi sử dụng nhiều dự án trên Google Cloud. Bạn sẽ chuyển cấp độ truy cập API cho dự án nào?

Nếu bạn đã sử dụng nhiều dự án Google Cloud bằng mã của nhà phát triển được phê duyệt trong 90 ngày qua, thì tất cả các dự án đó sẽ nhận được cùng một cấp độ truy cập API như mã của nhà phát triển của bạn. Xem một ví dụ.

Các cấp truy cập API được chỉ định cho một dự án mà tôi không còn sử dụng nữa. Làm cách nào để khắc phục vấn đề này?

Nếu quyền truy cập vào API Google Ads được chỉ định cho một dự án Google Cloud mà bạn không còn sử dụng nữa, thì bạn không cần làm gì thêm. Google sẽ thu hồi quyền truy cập API đối với dự án không dùng đến sau 90 ngày không hoạt động.

Các cấp độ truy cập API chưa được chỉ định cho dự án trên đám mây của tôi trên Google Cloud. Làm cách nào để khắc phục vấn đề này?

Dự án Google Cloud của bạn không kế thừa cấp truy cập của mã thông báo nhà phát triển, có thể là do bạn chưa bao giờ sử dụng mã thông báo nhà phát triển và dự án Cloud để thực hiện lệnh gọi API, hoặc quyền truy cập API của mã thông báo nhà phát triển đã hết hạn gần đây do không hoạt động. Để khắc phục vấn đề này, hãy đăng ký cấp truy cập API phù hợp cho dự án đó trên trang Tổng quan về API Google Ads. Xem một ví dụ.

Tôi có thể xem cấp độ truy cập API của dự án ở đâu?

Bạn có thể xem cấp độ truy cập API của dự án Google Cloud trên trang Tổng quan về API Google Ads.

Làm cách nào để đăng ký cấp quyền truy cập API cao hơn?

Bạn có thể đăng ký các cấp truy cập API cao hơn cho dự án Google Cloud của mình trên trang Tổng quan về API Google Ads.

Điều gì sẽ xảy ra với đơn đăng ký quyền truy cập vào API đang chờ xử lý của tôi?

Mọi đơn đăng ký Quyền truy cập cơ bản đang chờ xử lý mà bạn đã bắt đầu từ Trung tâm API của tài khoản người quản lý Google Ads trước ngày 9 tháng 9 năm 2026 sẽ bị đóng. Bạn nên đăng ký lại Quyền truy cập cơ bản trên trang Tổng quan về API Google Ads của dự án Google Cloud. Nếu chịu ảnh hưởng của thay đổi này, bạn sẽ nhận được email kèm theo hướng dẫn cần thiết.

Mọi đơn đăng ký Quyền truy cập tiêu chuẩn đang chờ xử lý mà bạn đã bắt đầu từ Trung tâm API của tài khoản người quản lý Google Ads kể từ ngày 9 tháng 9 năm 2026 sẽ được xem xét như bình thường. Nếu được phê duyệt, dự án trên đám mây của Google được liên kết với mã của nhà phát triển của bạn sẽ được cấp quyền truy cập tiêu chuẩn.

Tôi có thể liên kết lại mã của nhà phát triển đã được phê duyệt với một dự án trên đám mây mới trên Google Cloud không?

Trước đây, nhóm API Google Ads hỗ trợ việc liên kết lại mã thông báo của nhà phát triển với một dự án Google Cloud mới theo từng trường hợp. Tính năng này không còn được hỗ trợ kể từ ngày 9 tháng 9 năm 2026 do chúng tôi đã ngừng cung cấp mã thông báo nhà phát triển. Nếu cần sử dụng một dự án trên đám mây mới của Google, bạn nên đăng ký quyền truy cập API thích hợp trên trang Tổng quan về Google Ads API của dự án trên đám mây của Google.

Tôi có mã của nhà phát triển đã được phê duyệt nhưng chưa bao giờ sử dụng. Tôi có thể sử dụng mã của nhà phát triển này không?

Không, bạn không thể sử dụng mã của nhà phát triển này. Có hai trường hợp:

  1. Quyền truy cập vào mã của nhà phát triển có thể bị thu hồi do không hoạt động: Theo các chính sách của Google, Google có thể thu hồi mã API của bạn nếu mã đó không được sử dụng trong 90 ngày liên tiếp. Nếu đã lâu bạn không sử dụng mã của nhà phát triển, thì có thể cấp truy cập của mã thông báo đó đã bị thu hồi do không hoạt động. Nếu trường hợp này xảy ra, hãy đăng ký lại quyền truy cập API cho dự án trên đám mây của bạn trên trang Tổng quan về Google Ads API. Xem một ví dụ.

  2. Mã của nhà phát triển của bạn mới được phê duyệt gần đây, nhưng bạn chưa bao giờ sử dụng mã này trước ngày 9 tháng 9 năm 2026: Vì bạn chưa bao giờ sử dụng mã của nhà phát triển đã được phê duyệt với một dự án trên đám mây của Google Cloud trước ngày 9 tháng 9 năm 2026, nên các cấp truy cập của mã này chưa được chuyển sang dự án trên đám mây. Do đó, bạn không thể sử dụng mã thông báo nhà phát triển nữa. Chúng tôi sẽ gửi lỗi CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION nếu bạn cố gắng thực hiện lệnh gọi API đến một tài khoản phát hành công khai bằng mã thông báo nhà phát triển này. Để khắc phục lỗi này, hãy đăng ký quyền truy cập API thích hợp trên trang Tổng quan về API Google Ads của dự án Google Cloud. Xem một ví dụ.

Trong cả hai trường hợp này, bạn có thể đăng ký cấp độ Quyền truy cập của người khám phá và Quyền truy cập cơ bản, sau đó yêu cầu sẽ được tự động xem xét. Bạn không cần làm việc với Nhóm tuân thủ của Google để hoàn tất quy trình xem xét nữa. Nếu cần Quyền truy cập tiêu chuẩn, bạn cần được xem xét thủ công. Tuy nhiên, bạn có thể chia sẻ thông tin chi tiết về mã thông báo nhà phát triển đã được phê duyệt khi đăng ký Quyền truy cập tiêu chuẩn, để Nhóm tuân thủ có thể xem xét đơn đăng ký Quyền truy cập tiêu chuẩn mới của bạn một cách phù hợp.

Tôi có thể ngừng gửi mã của nhà phát triển trong các yêu cầu API không?

Có, bạn có thể ngừng gửi mã của nhà phát triển trong các yêu cầu API. Nếu sử dụng một thư viện ứng dụng, bạn có thể cần nâng cấp lên phiên bản mới nhất của thư viện đó. Kiểm tra nhật ký thay đổi của thư viện để xác nhận xem thư viện có hỗ trợ thực hiện các lệnh gọi API mà không cần chỉ định mã của nhà phát triển hay không.

Tôi đã tham gia chương trình thí điểm cấp truy cập do đám mây quản lý. Tôi bị ảnh hưởng như thế nào?

Chương trình thí điểm cấp truy cập được quản lý trên đám mây được giới thiệu để giúp các nhà phát triển Google Cloud thực hiện các lệnh gọi API mà không cần gửi mã của nhà phát triển trong yêu cầu API. Vì chúng tôi đã ngừng cung cấp mã thông báo của nhà phát triển, nên chương trình này sẽ bị ngừng.

Các cấp truy cập của mã thông báo nhà phát triển đang hoạt động đã được chuyển sang dự án trên đám mây của Google Cloud, vì vậy, mã hiện có của bạn sẽ tiếp tục hoạt động mà không cần thay đổi. Nếu cần sử dụng một dự án Google Cloud mới, bạn nên đăng ký quyền truy cập API trên trang Tổng quan về API Google Ads của dự án Google Cloud.

Mã của nhà phát triển của tôi nằm trong danh sách cho phép. Tôi bị ảnh hưởng như thế nào?

Google có thể triển khai các chương trình thí điểm để cấp cho một số nhà phát triển quyền sử dụng các tính năng thử nghiệm. Đôi khi, bạn có thể truy cập vào các tính năng này bằng cách thêm mã của nhà phát triển vào danh sách cho phép. Nếu bạn tham gia một chương trình thử nghiệm như vậy, thì bạn không cần làm gì cả.

Chúng tôi đã cập nhật tất cả các chương trình thí điểm để sử dụng dự án trên Google Cloud thay vì mã thông báo nhà phát triển làm cơ chế đưa vào danh sách cho phép và chuyển trạng thái danh sách cho phép của mã thông báo nhà phát triển sang các dự án trên Google Cloud được liên kết. Mã hiện có của bạn sẽ tiếp tục hoạt động mà không có bất kỳ thay đổi nào. Nếu bạn vẫn gặp vấn đề, hãy liên hệ với người quản lý tài khoản tại Google đã đăng ký bạn tham gia chương trình thí điểm.

Tôi có mã thông báo nhà phát triển đã được phê duyệt và tôi muốn sử dụng mã thông báo đó với một dự án mới trên Google Cloud. Điều đó có được phép không?

Không, bạn không thể sử dụng một dự án mới trên Google Cloud bằng mã thông báo nhà phát triển đã được phê duyệt. Vì bạn chưa bao giờ sử dụng mã nhà phát triển đã được phê duyệt với dự án mới trên Google Cloud trước ngày 9 tháng 9 năm 2026, nên các cấp truy cập của mã này chưa được chuyển sang dự án trên Cloud. Chúng tôi sẽ gửi lỗi CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION nếu bạn cố gắng thực hiện lệnh gọi API bằng mã của nhà phát triển này, vì mã của nhà phát triển không còn được dùng để xác định cấp truy cập API của bạn nữa. Để khắc phục lỗi này, hãy đăng ký quyền truy cập API thích hợp trên trang Tổng quan về Google Ads API của dự án Google Cloud. Xem một ví dụ.

Mã của nhà phát triển của tôi bị rò rỉ ra bên ngoài. Tôi có cần đặt lại mã của nhà phát triển không?

Không, trong trường hợp này, bạn không cần đặt lại mã của nhà phát triển. Vì chúng tôi đã chuyển các cấp độ truy cập API của mã thông báo nhà phát triển sang dự án Google Cloud của bạn, nên người dùng trái phép không thể sử dụng mã thông báo nhà phát triển của bạn với dự án Google Cloud của riêng họ nữa. Tuy nhiên, bạn có thể đặt lại mã của nhà phát triển trong Trung tâm API nếu muốn.

Điều gì sẽ xảy ra với API Center?

Trang Trung tâm API hiện có trong tài khoản người quản lý Google Ads không được dùng nữa và sẽ bị xoá trong tương lai gần. Nếu đã có mã của nhà phát triển, bạn vẫn có thể đăng nhập vào tài khoản người quản lý Google Ads và xem thông tin chi tiết. Tuy nhiên, những thông tin này chỉ được cung cấp để bạn tham khảo. Không thực hiện bất kỳ nhiệm vụ nào liên quan đến Cấp truy cập mã của nhà phát triển, chẳng hạn như đăng ký cấp truy cập API cao hơn trên trang này.

Nếu cần đăng ký cấp truy cập API cao hơn, bạn nên thực hiện việc này trên trang Tổng quan về API Google Ads của dự án Google Cloud.

Tôi có cần tài khoản người quản lý Google Ads để sử dụng Google Ads API không?

Bạn không cần tài khoản người quản lý Google Ads để sử dụng Google Ads API nữa. Bạn chỉ cần tài khoản người quản lý nếu cần liên kết và quản lý nhiều tài khoản bằng API.

Tôi là một nhà phát triển mới. Làm cách nào để đăng ký Google Ads API?

Làm theo hướng dẫn trong hướng dẫn bắt đầu sử dụng để đăng ký Google Ads API. Đừng đăng ký mã của nhà phát triển thông qua Trung tâm API của tài khoản người quản lý Google Ads; những đơn đăng ký này sẽ không được xử lý. API Center sẽ ngừng hoạt động trong tương lai gần.

Tiếp
Cấp truy cập và cách sử dụng được phép