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 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. Một lý do phổ biến gây ra lỗi này là bạn đang sử 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 tham 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 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ó quyền truy cập vào 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, thì bạn có thể cần triển khai Quyền OAuth chi tiết.
google.auth.exceptions.RefreshError
invalid_grant
Tóm tắt
Mã 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 phát hành của dự án trên Google là Testing, nên 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 việc mã làm mới hết hạn sau 7 ngày.
Mã 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 của khách hàng không hợp lệ.
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ắt
Mã khách hàng của khách hà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 khách hà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à thông tin bắt buộc cho tất cả các lệnh gọi, vì vậy, hãy đảm bảo bạn đã chỉ định một 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ì các thư viện này sẽ xử lý việc này cho bạn.
CUSTOMER_NOT_FOUND
Tóm tắt
Khô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 đợ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 đó.
GOOGLE_ACCOUNT_COOKIE_INVALID
Tóm tắt
Mã 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 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ắt
Tài khoản Google 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 được 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 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 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ắt
Mã 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 chuyển cùng với tiêu đề HTTP 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 rằng bạn đã chuyển đúng mã truy cập liên kết với tài khoản của mình. Đôi khi, mã truy cập 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 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ã 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.
Dự án Google Cloud chỉ có quyền truy cập 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 Google Cloud có Cấp truy cập thử nghiệm đã được dùng để gửi yêu cầu đến 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 các phiên bản API v24 trở xuống, điều kiện này sẽ trả về AuthorizationError.ACTION_NOT_PERMITTED.)
Khô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 đã 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ị huỷ kích hoạt, 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 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 (ĐÃ HUỶ).
USER_PERMISSION_DENIED
Tóm tắt
Khá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 nối (-). Thư viện ứng dụng có hỗ trợ tích hợp cho việc này.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2026-11-13 UTC."],[],[]]