Lỗi thường gặp
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này liệt kê các lỗi thường gặp và cung cấp mẹo về cách ngăn chặn và 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 trợ giúp thêm, hãy liên hệ với nhóm hỗ trợ.
google.rpc.ErrorInfo
ACCESS_TOKEN_SCOPE_INSUFFICIENT
Tóm tắt
Mã 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 Google Ads API.
Cách xử lý
Đảm bảo 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 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 các 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 mã truy cập có các phạm vi cần thiết. 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ắ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 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 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.
Bạn không thể sử dụng toán tử này với một lớp con của Ad.
Nguyên nhân thường gặp
Cố gắng sửa đổi các thuộc tính khác ngoài status của quảng cáo.
Cách xử lý
Không có
Mẹo phòng tránh dịch
Bạn không thể sửa đổi quảng cáo sau khi tạo. Nếu muốn sửa đổi quảng cáo, bạn phải tạo một quảng cáo mới rồi xoá quảng cáo cũ. Tuy nhiên, bạn có thể sửa đổi status của quảng cáo bằng cách sử dụng MutateAdGroupAds.
INVALID_INPUT
Tóm tắt
Một trong các trường trong quảng cáo chứa ký tự không hợp lệ.
Nguyên nhân thường gặp
Sử dụng ký tự đặc biệt trong URL.
Cách xử lý
Không có
Mẹo phòng tránh dịch
Xác thực URL trong ứng dụng của bạn trước khi đưa ra yêu cầu API.
Bạn đang thêm hoặc đổi tên một nhóm quảng cáo, nhưng tên đó đã được một nhóm quảng cáo khác sử dụng.
Nguyên nhân thường gặp
Tạo một nhóm quảng cáo mới có tên của một nhóm quảng cáo hiện có đang hoạt động hoặc đang tạm dừng.
Cách xử lý
Ghi lại lỗi và hiển thị thông báo lỗi cho người dùng, bạn có thể đề xuất một tên nhóm quảng cáo duy nhất hoặc cho thấy danh sách tên đang được sử dụng.
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 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ắt
Bạ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ắ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 ở phần phụ trợ.
Cách xử lý
Chờ 5 phút ban đầu, 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 đó.
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 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ắt
Tà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ắ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 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.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
Tóm tắt
Mã của nhà phát triển đã được liên kết với một tổ chức trên 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ã của nhà phát triển không được liên kết với một dự án trên đám mây trong cùng một tổ chức Google Cloud như dự án trên đám mây được dùng để đưa ra yêu cầu ban đầu.
Cách xử lý
Đảm bảo rằng mã ứng dụng 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 đã thực hiện các yêu cầu API bằng mã thông báo của nhà phát triển.
Mẹo phòng tránh dịch
Đảm bảo rằng tất cả dự án trên Google Cloud đều được liên kết với cùng một tổ chức trên Google Cloud. Mỗi dự án Google Cloud chỉ có thể được liên kết với một mã của nhà phát triển, nhưng một mã của nhà phát triển có thể được liên kết với nhiều dự án trong tổ chức.
DEVELOPER_TOKEN_INVALID
Tóm tắt
Mã của 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ã của nhà phát triển hoặc việc thiết lập mã của nhà phát triển không chính xác trong một tiêu đề của yêu cầu khác.
Cách xử lý
Hãy nhớ sao chép mã của nhà phát triển từ trung tâm API để tránh lỗi chính tả. Bạn có thể tìm trung tâm API trong tài khoản người quản lý Google Ads. Ngoài ra, hãy đảm bảo rằng bạn đang đặt mã của nhà phát triển trong tiêu đề chính xác. Đô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.
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 đượ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 đã 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.
DEVELOPER_TOKEN_NOT_APPROVED
Tóm tắt
Mã của 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ã của 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 kiểm thử. Nếu có, bạn cần đă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 Cơ bản.
Mẹo phòng tránh dịch
Không có
DEVELOPER_TOKEN_PROHIBITED
Tóm tắt
Bạn khô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 Bảng điều khiển API của Google chỉ có thể được 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 thực hiện một yêu cầu API Google Ads, mã của nhà phát triển sẽ được liên kết vĩnh viễn với dự án trên Google API Console. Nếu không sử dụng một dự án mới trên Google API Console, 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 cần tạo một dự án mới trên 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ắ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ý mà không có dấu gạch ngang (-). Các thư viện ứng dụng có hỗ trợ sẵn cho việc này.
Giá trị giá thầu không phải là bội số chính xác của đơn vị tiền tệ tối thiểu của tài khoản. Ví dụ: 0, 015 đô la Mỹ (15000 trong đơn vị vi mô) không phải là giá thầu hợp lệ.
Nguyên nhân thường gặp
Không có
Cách xử lý
Không có
Mẹo phòng tránh dịch
Xác minh rằng giá thầu là bội số của đơn vị tối thiểu cho đơn vị tiền tệ của tài khoản.
BID_TOO_BIG
Tóm tắt
Lỗi này vẫn xảy ra ngay cả khi giá thầu nằm trong ngân sách chiến dịch.
Đã xảy ra lỗi không mong muốn trong khi xử lý yêu cầu.
Nguyên nhân thường gặp
API không hoạt động đúng cách do một lỗi.
Cách xử lý
Thử lại mọi yêu cầu không thành công do lỗi này, bằng cách sử dụng lịch thời gian đợi luỹ thừa cho các lần thử lại.
Mẹo phòng tránh dịch
Không có
TRANSIENT_ERROR
Tóm tắt
Đã xảy ra lỗi nội bộ tạm thời và bạn nên thử lại.
Nguyên nhân thường gặp
Lỗi này xảy ra khi API gặp phải một vấn đề tạm thời ở bên trong.
Cách xử lý
Thử lại mọi yêu cầu không thành công do lỗi này, bằng cách sử dụng lịch thời gian đợi luỹ thừa cho các lần thử lại.
Mẹo phòng tránh dịch
Không có
InvalidGrantError
invalid_grant (malformed auth code)
Tóm tắt
Mã uỷ quyền được trao đổi để lấy mã thông báo OAuth bị lỗi.
Nguyên nhân thường gặp
Điều này xảy ra khi bạn cố gắng tạo mã làm mới cho một người dùng đã được cấp quyền truy cập vào ứng dụng yêu cầu. Ví dụ: điều này có thể xảy ra khi bạn chạy Ví dụ về cách tạo thông tin xác thực người dùng nhiều lần cho cùng một thông tin xác thực ứng dụng OAuth và người dùng uỷ quyền.
Cách xử lý
Để tạo lại mã làm mới cho một tổ hợp nhất định gồm người dùng uỷ quyền và thông tin đăng nhập của ứng dụng OAuth, hãy thu hồi mã làm mới hiện có. Xin lưu ý rằng việc thu hồi mã thông báo sẽ khiến mã đó không dùng được để truy cập vào API Google Ads và làm mất hiệu lực mọi mã truy cập mà mã làm mới đã dùng để tạo.
Mẹo phòng tránh dịch
Hãy nhớ lưu trữ mã làm mới ở một nơi an toàn để tránh phải tạo lại mã này.
Yêu cầu đề cập đến một tài nguyên không tìm thấy được.
Nguyên nhân thường gặp
Yêu cầu đã cố gắng biến đổi hoặc tham chiếu một tài nguyên không tồn tại hoặc đã bị xoá. Hoặc tên tài nguyên đã cho của tài nguyên bị lỗi.
Cách xử lý
Sử dụng yêu cầu tìm kiếm để truy xuất tên tài nguyên cho một tài nguyên hiện có trước khi gửi yêu cầu biến đổi. Tham khảo hướng dẫn về thư viện ứng dụng của chúng tôi, trong đó có tài liệu về cách tạo tên tài nguyên hợp lệ bằng mọi ngôn ngữ được hỗ trợ
Mẹo phòng tránh dịch
Đừng tạo tên tài nguyên theo cách thủ công. Sử dụng một trong các phương thức trợ giúp do thư viện ứng dụng của chúng tôi cung cấp.
Yêu cầu đang cố gắng tạo một tài nguyên khiến tổng số tài nguyên đó vượt quá một hạn mức cụ thể.
Nguyên nhân thường gặp
Có nhiều hạn mức về số lượng tài nguyên có thể tồn tại trong một số bối cảnh nhất định.
Cách xử lý
Xác định giới hạn mà bạn đang gặp phải bằng cách xem Giới hạn của hệ thống. Bạn có thể sử dụng lại tài nguyên hiện có hoặc xoá tài nguyên để tạo không gian cho tài nguyên mới.
Mẹo phòng tránh dịch
Sử dụng cụm từ tìm kiếm để theo dõi số lượng tài nguyên có hạn chế.
[[["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-06-30 UTC."],[],[]]