Lỗi phổ biến

Trang này liệt kê các lỗi thường gặp và cung cấp mẹo để ngăn chặn cũng như xử lý các lỗi đó. Để xem danh sách đầy đủ các lỗi, hãy xem tài liệu tham khảo về lỗi. Để được hỗ trợ thêm, hãy truy cập vào diễn đàn của chúng tôi.

google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
Tóm tắtMã truy cập OAuth 2.0 không có các phạm vi bắt buộc.
Nguyên nhân thường gặp Yêu cầu bị từ chối vì mã truy cập được cung cấp không bao gồm phạm vi OAuth 2.0 của API Google Ads.
Cách xử lý Đảm bảo mã truy cập có các phạm vi bắt buộc. Một lý do phổ biến gây ra lỗi này là bạn đang sử dụng lại mã thông báo truy cập hiện có được tạo bằng một nhóm phạm vi OAuth khác. Hãy xem các thông số uỷ quyền OAuth để biết ví dụ về cách tạo mã truy cập mới có các phạm vi bắt buộc.
Mẹo phòng tránh dịch Đảm bảo mã truy cập có các phạm vi bắt buộc. Xác thực lại người dùng bằng các phạm vi bắt buộc để có quyền truy cập vào các phạm vi đó. Nếu ứng dụng của bạn sử dụng nhiều phạm vi OAuth, bạn có thể cần triển khai Quyền OAuth chi tiết.

google.auth.exceptions.RefreshError
invalid_grant
Tóm tắtMã thông báo đã hết hạn hoặc bị thu hồi.
Nguyên nhân thường gặp Một dự án trên Google Cloud Platform có màn hình đồng ý OAuth được định cấu hình cho loại người dùng bên ngoài và trạng thái phát hành là Testing sẽ được cấp một mã thông báo làm mới hết hạn sau 7 ngày.
Cách xử lý Trạng thái phát hành của dự án Google là Testing, vì vậy, mã thông báo làm mới sẽ hết hạn sau mỗi 7 ngày và nhận được lỗi invalid_grant. Truy cập vào Google API Console rồi chuyển đến màn hình xin phép bằng OAuth. Sau đó, hãy thay đổi trạng thái phát hành thành In production theo hướng dẫn này để tránh mã thông báo làm mới hết hạn sau 7 ngày.
Mẹo phòng tránh dịch Xem phần Ứng dụng chưa được xác minh.

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID
Tóm tắtMã khách hàng của ứng dụng không phải là số.
Nguyên nhân thường gặp Sử dụng mã khách hàng ứng dụng khách không phù hợp.
Cách xử lý Không có
Mẹo phòng tránh dịch 123-456-7890 phải là 1234567890. Hãy xem phần Bắt đầu để biết thông tin chi tiết.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Tóm tắtMã khách hàng của ứng dụng không được chỉ định trong tiêu đề HTTP.
Nguyên nhân thường gặp Không chỉ định mã khách hàng của ứng dụng trong tiêu đề HTTP.
Cách xử lý Không có
Mẹo phòng tránh dịch Mã khách hàng của ứng dụng khách là bắt buộc đối với tất cả lệnh gọi, vì vậy, hãy đảm bảo bạn đã chỉ định mã khách hàng trong tiêu đề HTTP. Hãy cân nhắc sử dụng thư viện ứng dụng của chúng tôi vì chúng sẽ xử lý vấn đề này cho bạn.
CUSTOMER_NOT_FOUND
Tóm tắtKhông tìm thấy tài khoản nào cho mã khách hàng được cung cấp trong tiêu đề.
Nguyên nhân thường gặp Cố gắng truy cập vào một tài khoản mới được tạo trước khi tài khoản được thiết lập trong phần phụ trợ.
Cách xử lý Chờ 5 phút ban đầu, sau đó thử lại mỗi 30 giây.
Mẹo phòng tránh dịch Hãy đợi vài phút sau khi tạo tài khoản rồi mới đưa ra yêu cầu đối với tài khoản đó.
Tóm tắtMã thông báo truy cập trong tiêu đề yêu cầu không hợp lệ hoặc đã hết hạn.
Nguyên nhân thường gặp Mã thông báo truy cập đã bị vô hiệu hoá.
Cách xử lý Yêu cầu mã thông báo mới. Nếu bạn đang sử dụng một trong các thư viện ứng dụng của chúng tôi, hãy tham khảo tài liệu của thư viện đó về cách làm mới mã thông báo.
Mẹo phòng tránh dịch Lưu trữ và sử dụng lại mã truy cập cho đến khi hết hạn.
NOT_ADS_USER
Tóm tắtTài khoản Google dùng để tạo mã thông báo truy cập không được liên kết với bất kỳ tài khoản Google Ads nào.
Nguyên nhân thường gặp Thông tin đăng nhập mà bạn cung cấp tương ứng với một Tài khoản Google chưa bật Google Ads.
Cách xử lý Hãy nhớ đăng nhập bằng một tài khoản Google Ads hợp lệ (thường là tài khoản người quản lý) cho quy trình OAuth. Bạn cũng có thể mời Tài khoản Google truy cập vào một tài khoản Google Ads hiện có bằng cách đăng nhập vào tài khoản người quản lý, chọn khách hàng hoặc tài khoản người quản lý có liên quan, chuyển đến Tools and Settings > Access and security, sau đó thêm địa chỉ email của Tài khoản Google.
Mẹo phòng tránh dịch Không có
OAUTH_TOKEN_INVALID
Tóm tắtMã thông báo truy cập OAuth trong tiêu đề không hợp lệ.
Nguyên nhân thường gặp Mã truy cập mà bạn truyền bằng tiêu đề HTTP không chính xác.
Cách xử lý Không có
Mẹo phòng tránh dịch Đảm bảo bạn đã truyền mã thông báo truy cập chính xác được liên kết với tài khoản của mình. Đôi khi, mã này bị nhầm lẫn với mã thông báo làm mới và mã uỷ quyền. Nếu bạn muốn có thông tin xác thực có thể truy cập vào tất cả tài khoản khách hàng trong một tài khoản người quản lý, hãy nhớ lấy mã thông báo làm mới cho tài khoản người quản lý đó. Để biết thêm thông tin, hãy xem hướng dẫn của chúng tôi về mã truy cập và mã làm mới cũng như OAuth2.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
Tóm tắtMã thông báo nhà phát triển đã được liên kết với một tổ chức Google Cloud và không thể liên kết với một tổ chức khác.
Nguyên nhân thường gặp Mã thông báo nhà phát triển không được liên kết với một dự án trên Google Cloud trong cùng một tổ chức Google Cloud với dự án Google Cloud dùng để đưa ra yêu cầu ban đầu.
Cách xử lý Đảm bảo rằng mã ứng dụng khách OAuth được liên kết với các dự án Google Cloud trong cùng một tổ chức Google Cloud nếu bạn đã gửi yêu cầu API bằng mã của nhà phát triển.
Mẹo phòng tránh dịch Hãy đảm bảo rằng tất cả dự án trên Google Cloud của bạn đều được liên kết với cùng một tổ chức trên Google Cloud. Một dự án Google Cloud chỉ có thể liên kết với một mã thông báo nhà phát triển, nhưng một mã thông báo nhà phát triển có thể liên kết với nhiều dự án trong tổ chức.
DEVELOPER_TOKEN_INVALID
Tóm tắtMã thông báo dành cho nhà phát triển không hợp lệ.
Nguyên nhân thường gặp Nguyên nhân phổ biến gây ra lỗi này bao gồm lỗi chính tả trong mã thông báo nhà phát triển hoặc đặt không chính xác mã thông báo nhà phát triển trong một tiêu đề yêu cầu khác.
Cách xử lý Hãy nhớ sao chép mã thông báo dành cho nhà phát triển từ Trung tâm API để tránh lỗi chính tả. Bạn có thể tìm thấy Trung tâm API trong tài khoản người quản lý Google Ads. Ngoài ra, hãy đảm bảo bạn đang đặt mã thông báo nhà phát triển trong đúng tiêu đề. Đôi khi, mã thông báo dành cho nhà phát triển bị nhầm lẫn với mã thông báo làm mới OAuth và mã uỷ quyền. Đọc thêm về các tiêu đề yêu cầu khác nhau tại đây.
Mẹo phòng tránh dịch Không có

AuthorizationError
CUSTOMER_NOT_ENABLED
Tóm tắtKhông thể truy cập vào tài khoản khách hàng vì tài khoản đó không ở trạng thái bật.
Nguyên nhân thường gặp Điều này xảy ra khi tài khoản khách hàng chưa hoàn tất quy trình đăng ký hoặc đã bị vô hiệu hoá.
Cách xử lý Đăng nhập vào giao diện người dùng Google Ads và đảm bảo rằng bạn đã hoàn tất quy trình đăng ký cho tài khoản này. Đối với tài khoản đã bị vô hiệu hoá, hãy xem bài viết Kích hoạt lại tài khoản Google Ads đã huỷ.
Mẹo phòng tránh dịch Bạn có thể chủ động kiểm tra xem tài khoản khách hàng có bị vô hiệu hoá hay không bằng cách kiểm tra trạng thái ĐÃ HUỶ.
DEVELOPER_TOKEN_NOT_APPROVED
Tóm tắtMã thông báo dành cho nhà phát triển chỉ được phê duyệt để sử dụng với tài khoản thử nghiệm và đã cố gắng truy cập vào một tài khoản không phải tài khoản thử nghiệm.
Nguyên nhân thường gặp Mã thông báo nhà phát triển thử nghiệm đã được dùng để truy cập vào một tài khoản không phải tài khoản thử nghiệm.
Cách xử lý Đảm bảo rằng bạn thực sự muốn truy cập vào một tài khoản không phải tài khoản thử nghiệm. Nếu có, bạn cần yêu cầu nâng cấp mã thông báo nhà phát triển lên quyền truy cập Tiêu chuẩn hoặc Cơ bản.
Mẹo phòng tránh dịch Không có
DEVELOPER_TOKEN_PROHIBITED
Tóm tắtMã thông báo nhà phát triển không được phép sử dụng với dự án được gửi trong yêu cầu.
Nguyên nhân thường gặp Mỗi dự án trên Google API Console chỉ có thể liên kết với mã của nhà phát triển từ một tài khoản người quản lý. Sau khi bạn tạo một yêu cầu API Google Ads, mã của nhà phát triển sẽ được ghép nối vĩnh viễn với dự án Google API Console. Nếu không sử dụng dự án mới trên Google API Console, bạn sẽ gặp lỗi DEVELOPER_TOKEN_PROHIBITED khi tạo yêu cầu.
Cách xử lý Không có
Mẹo phòng tránh dịch Nếu chuyển sang mã của nhà phát triển trong một tài khoản người quản lý mới, bạn cần tạo một dự án mới trong Google API Console cho các yêu cầu API Google Ads sử dụng mã của người quản lý mới.
USER_PERMISSION_DENIED
Tóm tắtKhách hàng được uỷ quyền không có quyền truy cập vào khách hàng đang hoạt động.
Nguyên nhân thường gặp Xác thực dưới dạng người dùng có quyền truy cập vào tài khoản người quản lý nhưng không chỉ định login-customer-id trong yêu cầu.
Cách xử lý Không có
Mẹo phòng tránh dịch Chỉ định login-customer-id làm mã tài khoản người quản lý mà không có dấu gạch nối (-). Thư viện ứng dụng đã tích hợp tính năng hỗ trợ cho việc này.