Lỗi phổ biến

Trang này liệt kê các lỗi thường gặp 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 tài liệu 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ã 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 dự án của Google là Testing. Do đó, mã làm mới sẽ hết hạn sau 7 ngày và nhận được một 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 các hướng dẫn này để tránh mã 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.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Tóm tắt 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 Bạn đang cố gắng sửa đổi các thuộc tính khác với thuộc tính 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 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 gửi yêu cầu API.
LINE_TOO_WIDE	Tóm tắt Một trong các trường trong quảng cáo đã dài hơn độ dài tối đa cho phép. Hãy xem bài viết Giới thiệu về quảng cáo dạng văn bản. Nguyên nhân thường gặp Có một dòng văn bản quá dài. Cách xử lý Không có Mẹo phòng tránh dịch Xác thực độ dài của dòng trước khi đưa ra yêu cầu API.

AdGroupAdError
AD_GROUP_AD_LABEL_ALREADY_EXISTS	Tóm tắt Nhãn này đã được kết hợp với một số quảng cáo. Nguyên nhân thường gặp Đang cố gắng liên kết nhãn với quảng cáo đã được liên kết. Cách xử lý Không có Mẹo phòng tránh dịch Trước tiên, hãy kiểm tra xem nhãn cần thêm đã được liên kết với quảng cáo hay chưa.
CANNOT_OPERATE_ON_REMOVED_ADGROUPAD	Tóm tắt Một thao tác đã cố gắng cập nhật một quảng cáo đã bị xoá. Nguyên nhân thường gặp Sau khi bị xóa, bạn không thể cập nhật quảng cáo đó nữa (bao gồm cả các thay đổi về trạng thái của quảng cáo). Cách xử lý Không có Mẹo phòng tránh dịch Hãy đảm bảo rằng mã của bạn không cố gắng cập nhật các quảng cáo đã bị xoá.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Tóm tắt Văn bản từ khoá chứa các ký tự không hợp lệ. Hãy xem mục Thêm từ khoá. Nguyên nhân thường gặp Văn bản từ khoá chứa các ký tự không hợp lệ. Cách xử lý Không có Mẹo phòng tránh dịch Xác thực văn bản từ khoá trong ứng dụng của bạn trước khi gửi yêu cầu tới API.

AdGroupError

DUPLICATE_ADGROUP_NAME

Tóm tắt Một nhóm quảng cáo đang được thêm hoặc đổi tên, 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 nhóm quảng cáo mới bằng tên của một nhóm quảng cáo đang hoạt động hoặc đang tạm dừng. Cách xử lý Ghi nhật ký lỗi và hiển thị thông báo lỗi cho người dùng, có thể đề xuất tên nhóm quảng cáo duy nhất hoặc hiển thị danh sách các tên đang sử dụng. Mẹo phòng tránh dịch Không có

AssetError

DUPLICATE_ASSET

Tóm tắt 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 nội dung có cùng dữ liệu nhị phân. Nguyên nhân thường gặp Một yêu cầu thay đổi với các thao tác tạo trùng lặp chứa cùng một dữ liệu nhị phân. Cách xử lý Tạo thành phần trong một yêu cầu riêng, sau đó liên kết với thành phầ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. Mẹo phòng tránh dịch Không có

AuthenticationError
CLIENT_CUSTOMER_ID_INVALID	Tóm tắt 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 ứng dụ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 bài viết Bắt đầu để biết 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 ứng dụng trong tiêu đề HTTP. Cách xử lý Không có Mẹo phòng tránh dịch Bắt buộc phải có mã khách hàng của ứng dụng cho tất cả các cuộc 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 để 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 có 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ờ vài phút sau khi tạo tài khoản rồi mới gửi yêu cầu.
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 không còn hợp lệ. Cách xử lý Yêu cầu một 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 đó 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 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ý 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ý của bạn) để sử dụng 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ý liên quan, 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ã thông báo 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 với tiêu đề HTTP là 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 bạn. Đô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 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 tài khoản người quản lý, hãy đảm bảo bạn nhận được 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, mã làm mới và OAuth2.

AuthorizationError
CUSTOMER_NOT_ENABLED	Tóm tắt Không thể truy cập vào tài khoản khách hàng vì tài khoản không ở trạng thái được bật. Nguyên nhân thường gặp Trường hợp 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 các tài khoản bị hủy kích hoạt, hãy xem bài viết Kích hoạt lại tài khoản Google Ads đã hủy. 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 ĐÃ HUỶ.
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 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 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 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 thử nghiệm. Nếu vậy thì 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 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 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ể đượ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 đư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 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 sẽ cần tạo dự án Bảng điều khiển API của Google mới cho các yêu cầu API Google Ads sử dụng mã thông báo 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 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 Hãy 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.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Tóm tắt Giá trị giá thầu không phải là bội số chính xác của đơn vị đơn vị tiền tệ tối thiểu của tài khoản. Ví dụ: 0, 015 USD (15000 tính theo micro) 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 được trả về ngay cả khi giá thầu nằm trong ngân sách chiến dịch. 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 Kiểm tra xem tài khoản có đang tham gia Google Ad Grants hay không. Nếu có, hãy hạn chế giá thầu CPC ở mức tối đa mà chương trình quy định.

CampaignBudgetError
MONEY_AMOUNT_LESS_THAN_CURRENCY_MINIMUM_CPC	Tóm tắt Số tiền ngân sách quá ít. 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 số tiền ngân sách lớn hơn hoặc bằng đơn vị tối thiểu cho đơn vị tiền tệ của tài khoản.
NON_MULTIPLE_OF_MINIMUM_CURRENCY_UNIT	Tóm tắt Số tiền ngân sách sẽ có quá nhiều chữ số thập phân có nghĩa khi được chuyển đổi từ số tiền một phần triệu sang số tiền theo đơn vị tiền tệ của tài khoản. 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 số tiền ngân sách có thể chia hết cho đơn vị tối thiểu tương ứng với đơn vị tiền tệ của tài khoản.

CampaignError

DUPLICATE_CAMPAIGN_NAME

Tóm tắt Một chiến dịch đang được thêm hoặc đổi tên, nhưng tên này đã được một chiến dịch khác sử dụng. Nguyên nhân thường gặp Tạo chiến dịch mới bằng tên của chiến dịch đang hoạt động hoặc đang tạm dừng hiện có. Cách xử lý Ghi nhật ký lỗi và hiển thị thông báo lỗi cho người dùng, có thể đề xuất tên riêng biệt của chiến dịch hoặc hiển thị danh sách các tên đang sử dụng. Mẹo phòng tránh dịch Không có

CriterionError
KEYWORD_HAS_INVALID_CHARS	Tóm tắt Thêm hoặc chỉnh sửa từ khoá 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 như ! @ % * trong từ khóa. Cách xử lý Không có Mẹo phòng tránh dịch Đảm bảo bạn không sử dụng bất kỳ ký tự không được phép nào trong từ khóa. Hãy xem mục Thêm từ khoá.

DistinctError
DUPLICATE_ELEMENT	Tóm tắt Yêu cầu chứa 2 tham số giống hệt nhau và không cần thiết. 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 Hãy xoá những nội dung trùng lặp (các toán tử, tham số, phần tử danh sách) trước khi tạo yêu cầu. Tìm các trường có điều kiện ràng buộc DistinctElements.

InternalError
DEADLINE_EXCEEDED	Tóm tắt Yêu cầu đã hết thời gian chờ và không thể được 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 đã tạo ra phản hồi quá lớn hoặc yêu cầu thay đổi quá lớn nên không xử lý được. 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 để có thể hoàn tất nhanh hơn. Mẹo phòng tránh dịch Xem xét Phân đoạn để hiểu cách phân đoạn có thể ảnh hưởng đến kích thước của một câu trả lời. Lưu ý về các giới hạn của lớp truyền tải gRPC.
INTERNAL_ERROR	Tóm tắt Đã 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 chính xác do 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 lịch trình 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 một lỗi nội bộ tạm thời nên 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 sự cố tạm thời trong nội bộ. 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 lịch trình 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 đã trao đổ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 người dùng cố gắng tạo mã làm mới đã đượ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 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à cho phép người dùng sử dụng. Cách xử lý Để tạo lại mã làm mới cho một tổ hợp nhất định giữa 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 mã đó không dùng được cho quyền truy cập vào API Google Ads và làm mất hiệu lực của 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 việc tạo lại mã.

MutateError

RESOURCE_NOT_FOUND

Tóm tắt Yêu cầu đã tham chiếu đến một tài nguyên không thể tìm thấy. Nguyên nhân thường gặp Yêu cầu đã cố 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 đã cho cho tài nguyên này không đúng định dạng. Cách xử lý Dùng yêu cầu tìm kiếm để truy xuất tên tài nguyên của một 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 Khô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.

NotEmptyError
EMPTY_LIST	Tóm tắt Danh sách bắt buộc đang trống. Nguyên nhân thường gặp Truyền danh sách thao tác trống vào phương thức mutate. Cách xử lý Không có Mẹo phòng tránh dịch Không có

QuotaError
RESOURCE_EXHAUSTED	Tóm tắt Đã vượt quá giới hạn tần suất của hệ thống. 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 Thiết lập độ trễ ngắn giữa các yêu cầu hoặc kết hợp nhiều thao tác hơn với ít yêu cầu hơn.

RangeError
TOO_LOW	Tóm tắt Giá trị thấp hơn giá trị tối thiểu cho phép. Nguyên nhân thường gặp Tình trạng quên chỉ định mã nhận dạng, khiến giá trị 0 được truyền vào. Cách xử lý Không có Mẹo phòng tránh dịch Hãy lưu ý mọi giới hạn về phạm vi được nêu trong tài liệu tham khảo API.

RequestError
INVALID_INPUT	Tóm tắt Yêu cầu không đúng định dạng. Nguyên nhân thường gặp URL hoặc nội dung yêu cầu không đúng định dạng. Cách xử lý Không có Mẹo phòng tránh dịch Không có
REQUIRED_FIELD_MISSING	Tóm tắt Yêu cầu thiếu thông tin bắt buộc. Nguyên nhân thường gặp Thiếu trường bắt buộc khi cố gắng thêm thực thể. Cách xử lý Ghi nhật ký lỗi và hiển thị thông báo lỗi cho người dùng. Thuộc tính fieldPath của lỗi cho biết trường nào bị thiếu. Mẹo phòng tránh dịch Hãy tham khảo tài liệu tham khảo API để tìm hiểu những trường bắt buộc.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Tóm tắt Yêu cầu đang cố gắng tạo một tài nguyên sẽ 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ố ngữ 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 xét Giới hạn hệ thống. 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 bị hạn chế.

StringLengthError
TOO_LONG	Tóm tắt Chuỗi được gán cho trường được chỉ định dài hơn giới hạn. Nguyên nhân thường gặp Dòng tiêu đề hoặc nội dung mô tả cho quảng cáo chứa quá nhiều văn bản. Cách xử lý Xác định giới hạn đang gặp phải, sửa đổi chuỗi cho phù hợp rồi gửi lại yêu cầu. Mẹo phòng tránh dịch Chú ý đến giới hạn độ dài chuỗi.