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 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ắ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 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.
Không thể sử dụng toán tử này với lớp con của Quảng cáo.
Nguyên nhân thường gặp
Đang cố gắng sửa đổi các thuộc tính khác với status của quảng cáo.
Cách xử lý
Không có
Mẹo phòng tránh dịch
Sau khi tạo một quảng cáo, bạn sẽ không thể sửa đổi quảng cáo đó. Nếu muốn sửa đổi quảng cáo, bạn phải tạo 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 của 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
Hãy xác thực các URL trong ứng dụng trước khi gửi yêu cầu API.
Hai thao tác trong một yêu cầu duy nhất chứa một thao tác tạo cho một tài sản có cùng dữ liệu nhị phân.
Nguyên nhân thường gặp
Yêu cầu thay đổi có các thao tác tạo trùng lặp chứa cùng dữ liệu nhị phân.
Cách xử lý
Tạo tài sản trong một yêu cầu riêng, rồi liên kết với tài sản đó trong yêu cầu tiếp theo; hoặc sử dụng một mã nhận dạng tạm thời trong cùng một yêu cầu.
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 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ắ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 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 đó.
GOOGLE_ACCOUNT_COOKIE_INVALID
Tóm tắt
Mã 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ắt
Tà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ắ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 đượ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.
Khô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ắt
Mã 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ắt
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 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ắt
Khá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.
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 USD (15000 tính bằng micrô) 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 được trả về ngay cả khi giá thầu nằm trong phạm vi ngân sách chiến dịch.
Yêu cầu đã hết thời gian chờ và không thể hoàn tất đủ nhanh để trả về phản hồi.
Nguyên nhân thường gặp
Yêu cầu tìm kiếm đã được thực hiện với lượng phản hồi quá lớn hoặc yêu cầu thay đổi quá lớn nên không thể xử lý.
Cách xử lý
Chờ khoảng 30 giây, rồi thử gửi yêu cầu lần nữa. Nếu lỗi vẫn tiếp diễn, hãy thử chia yêu cầu thành nhiều yêu cầu nhỏ hơn và có thể hoàn thành nhanh hơn.
Đã 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 hoạt động không chính xác do có lỗi.
Cách xử lý
Thử lại mọi yêu cầu không thành công với lỗi này, sử dụng thời gian đợi luỹ thừa để 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 nội bộ gặp phải một vấn đề tạm thời.
Cách xử lý
Thử lại mọi yêu cầu không thành công với lỗi này, sử dụng thời gian đợi luỹ thừa để 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 đổi cho mã thông báo OAuth không đúng định dạng.
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 chạy Ví dụ về tạo thông tin đăng nhập người dùng nhiều lần cho cùng một thông tin đăng nhập ứng dụng OAuth và uỷ quyền cho người dùng.
Cách xử lý
Để tạo lại mã làm mới cho một tổ hợp cụ thể gồm việc uỷ quyền thông tin đăng nhập của người dùng và ứ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 quyền truy cập vào API Google Ads không sử dụng được mã đó và làm mất hiệu lực mọi mã truy cập mà mã làm mới đã được 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 vị trí an toàn để tránh cần tạo lại.
Yêu cầu đã tham chiếu tới một tài nguyên không tìm thấy.
Nguyên nhân thường gặp
Yêu cầu đã cố làm thay đổi hoặc tham chiếu đến một tài nguyên không tồn tại hoặc đã bị xoá. Hoặc tên tài nguyên đã cung cấp cho tài nguyên không đúng định dạng.
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 tài nguyên hiện có trước khi gửi yêu cầu thay đổi. Xem 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 này đang cố gắng tạo tài nguyên khiến tổng số tài nguyên đó vượt quá giới hạn đã chỉ định.
Nguyên nhân thường gặp
Có nhiều giới hạn 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 đang gặp phải bằng cách xem lại phần Giới hạn của hệ thống. Bạn có thể sử dụng lại một tài nguyên hiện có hoặc xoá bớt 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ó giới hạn.