Lỗi phổ biến

Trang này liệt kê các lỗi phổ biến và cung cấp các mẹo ngăn chặn và xử lý các lỗi đó. Để biết danh sách đầy đủ các lỗi, hãy xem thông tin 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.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 Google Cloud Platform có màn hình xin phép bằng OAuth được định cấu hình cho loại người dùng bên ngoài và trạng thái xuất bản là Testing sẽ được cấp một mã làm mới sẽ hết hạn sau 7 ngày.
Cách xử lý Trạng thái xuất bản của dự án Google của bạn 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à gặp 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 xuất bản thành In production theo hướng dẫn sau để 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 Hãy 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 khách hàng không phải là số.
Nguyên nhân thường gặp Sử dụng mã khách hàng của khách hàng không đúng.
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 khách hàng chưa đượ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 khách hàng là bắt buộc cho tất cả các cuộc gọi, vì vậy, hãy đảm bảo bạn đã chỉ định mã này 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 để 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 vừa được tạo trước khi tài khoản được thiết lập trong phần phụ trợ.
Cách xử lý Đợi 5 phút đầu tiên, sau đó thử lại sau mỗi 30 giây.
Mẹo phòng tránh dịch Hãy chờ một vài phút sau khi tạo tài khoản rồi mới gửi yêu cầu đối với tài khoản đó.
Tóm tắtMã 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ã truy cập đã hết hiệu lực.
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 về thư viện đó để biết 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 được dùng để tạo mã truy cập chưa đượ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ý 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ý của bạn) 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 tài khoản khách hàng hoặc tài khoản người quản lý có liên quan, sau đó 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ã truy cập OAuth trong tiêu đề không hợp lệ.
Nguyên nhân thường gặp Mã truy cập được chuyển cùng tiêu đề HTTP của bạn không chính xác.
Cách xử lý Không có
Mẹo phòng tránh dịch Hãy đảm bảo bạn đã chuyển đúng mã truy cập được liên kết với tài khoản của mình. Đôi khi, bạn có thể nhầm lẫn với mã làm mới và mã uỷ quyền. Nếu bạn muốn nhận thông tin xác thực có thể truy cập vào tất cả các tài khoản khách hàng trong một tài khoản người quản lý, hãy nhớ nhận mã 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.

AuthorizationError
CUSTOMER_NOT_ENABLED
Tóm tắtKhông thể truy cập tài khoản khách hàng vì tài khoản này không ở trạng thái đã kích hoạt.
Nguyên nhân thường gặp Điều này xảy ra khi tài khoản của khách hàng chưa hoàn tất việc đăng ký hoặc đã bị huỷ kích hoạt.
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 các 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 đã bị huỷ.
Mẹo phòng tránh dịch Bạn có thể chủ động kiểm tra xem tài khoản của khách hàng có bị huỷ kích hoạt hay không bằng cách kiểm tra trạng thái CANCELLED (ĐÃ HUỶ).
DEVELOPER_TOKEN_NOT_APPROVED
Tóm tắtMã của nhà phát triển chỉ được chấp thuận để sử dụng với các tài khoản thử nghiệm và đã cố gắng truy cập vào một tài khoản không thử nghiệm.
Nguyên nhân thường gặp Mã của nhà phát triển kiểm thử được dùng để truy cập vào một tài khoản không phải tài khoản kiểm thử.
Cách xử lý Đảm bảo rằng bạn thực sự muốn truy cập vào tài khoản không phải thử nghiệm. Nếu vậy, bạn cần phải đăng ký để nâng cấp mã của nhà phát triển lên Quyền truy cập tiêu chuẩn hoặc Quyền truy cập cơ bản.
Mẹo phòng tránh dịch Không có
DEVELOPER_TOKEN_PROHIBITED
Tóm tắtKhông được phép sử dụng mã của nhà phát triển 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 đưa ra 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 Google API Console mới, bạn sẽ gặp lỗi DEVELOPER_TOKEN_PROHIBITED khi đưa ra 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 sẽ cần tạo một dự án Google API Console mới cho các yêu cầu API Google Ads có 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 điều hành.
Nguyên nhân thường gặp Xác thực là 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 đã hỗ trợ việc này.