Lỗi thường gặp

Hướng dẫn này liệt kê các lỗi API thường gặp và đưa ra các chiến lược để ngăn chặn và xử lý các lỗi đó.

Để xem danh sách đầy đủ các loại lỗi, hãy xem tài liệu tham khảo về lỗi Google Ads API. Nếu bạn cần được hỗ trợ thêm, hãy đặt câu hỏi trên diễn đàn Google Ads API.

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 có phạm vi OAuth 2.0 của Google Ads API.
Cách xử lý Đảm bảo rằng mã truy cập có các phạm vi bắt buộc. Lý do thường gặp dẫn đến lỗi này là bạn đang dùng lại mã 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 tham số uỷ quyền OAuth để biết ví dụ về cách tạo mã truy cập mới bằng các phạm vi bắt buộc.
Mẹo phòng tránh dịch Đảm bảo rằng 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ó được quyền truy cập bằng các phạm vi bắt buộc. 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 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ã làm mới hết hạn sau 7 ngày.
Cách xử lý Trạng thái xuất bản của dự án trên Google là Testing, do đó mã 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 xuất bản thành In production để tránh mã 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 khách hàng không phải là một số.
Nguyên nhân thường gặp Sử dụng mã khách hàng 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 sử dụng để biết thông tin chi tiết.
CLIENT_CUSTOMER_ID_IS_REQUIRED
Tóm tắtBạn chưa chỉ định mã khách hàng của ứng dụng trong tiêu đề HTTP.
Nguyên nhân thường gặp Không chỉ định mã khách hàng của khách hàng trong tiêu đề HTTP.
Cách xử lý Không có
Mẹo phòng tránh dịch Tất cả các lệnh gọi đều phải có mã khách hàng của ứng dụng khách, vì vậy, hãy nhớ chỉ định một mã 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ì các thư viện này sẽ xử lý việc 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 ở 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 Sau khi tạo tài khoản, hãy đợi vài phút rồi mới đưa ra yêu cầu đối với tài khoản đó.
Tóm tắtMã truy cập trong tiêu đề của 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 đã 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 đó để 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 mã này hết hạn.
NOT_ADS_USER
Tóm tắtTài khoản Google được dùng để tạo mã 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 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ý Đảm bảo bạn đă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 tài khoản khách hàng hoặc tài khoản người quản lý có liên quan, chuyển đến biểu tượng Tools and Settings > Access and security, rồi 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 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 rằng bạn đã truyền mã 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ã làm mới và mã uỷ quyền. Nếu bạn muốn nhận một thông tin đăng nhập 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 đảm bảo rằng bạn nhận được mã làm mới cho tài khoản người quản lý đó. Hãy xem hướng dẫn xác thực người dùng.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION
Tóm tắtDự án trên đám mây của Google Cloud chỉ có quyền truy cập vào tài khoản thử nghiệm và không thể dùng để truy cập vào tài khoản chính thức.
Nguyên nhân thường gặp Một dự án trên đám mây của Google Cloud có Cấp truy cập thử nghiệm đã được dùng để đưa ra yêu cầu đối với một tài khoản Google Ads không phải tài khoản thử nghiệm (tài khoản thực tế). (Trong API phiên bản 24 trở xuống, điều kiện này trả về AuthorizationError.ACTION_NOT_PERMITTED.)
Cách xử lý Nếu bạn đang kiểm thử, hãy đảm bảo rằng yêu cầu của bạn nhắm đến một tài khoản kiểm thử. Nếu bạn muốn truy cập vào một tài khoản Google Ads thực, hãy kiểm tra cấp truy cập của dự án Google Cloud trên trang Tổng quan về Google Ads API và nâng cấp cấp truy cập của dự án lên cấp truy cập Explorer, Cơ bản hoặc Tiêu chuẩn.
Mẹo phòng tránh dịch Không có
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 này không ở trạng thái được 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 CANCELLED.
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 với tư cách 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ý không có dấu gạch ngang (-). Thư viện ứng dụng có hỗ trợ sẵn cho việc này.

Trước
Xử lý lỗi
Tiếp
Bước tiếp theo