Lỗi phổ biế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. 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 Đ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.
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 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 gửi 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 các 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 Bạn đã cố gắng cập nhật một quảng cáo đã bị xóa. Nguyên nhân thường gặp Bạn không thể cập nhật quảng cáo sau khi đã xóa, bao gồm cả các thay đổi đối với 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 Đả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ị xóa.

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 bài viết 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 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 vào 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 hiện đ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, tuỳ ý đề 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 được 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 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. 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à 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 đú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 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.

AuthorizationError
CUSTOMER_NOT_ENABLED	Tóm tắt 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.

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ị 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. 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á nhỏ. 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 đáng kể khi quy đổi từ một số tiền nhỏ thành một 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 của đơ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 đã được một chiến dịch khác sử dụng. Nguyên nhân thường gặp Tạo một chiến dịch mới bằng tên của một chiến dịch hiện đ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, tuỳ ý đề xuất tên chiến dịch duy nhất hoặc hiển thị danh sách các tên đang được 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ừ khóa chứa ký tự không hợp lệ. Nguyên nhân thường gặp Sử dụng các ký tự đặc biệt như ! @ % * trong từ khoá. 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ự nào không được phép trong từ khóa. Hãy xem bài viết Thêm từ khoá.

DistinctError
DUPLICATE_ELEMENT	Tóm tắt Yêu cầu chứa hai tham số giống hệt nhau và thừa. 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á các mục trùng lặp (toán tử, tham số, phần tử trong danh sách) trước khi gửi yêu cầu. Tìm các trường có quy tắc 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ể 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. Mẹo phòng tránh dịch Xem mục Phân đoạn để hiểu phân đoạn có thể ảnh hưởng như thế nào đến kích thước của một phản hồi. Lưu ý các hạn chế 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 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.

MutateError

RESOURCE_NOT_FOUND

Tóm tắt 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.

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 Chuyể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 trong í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 Quên chỉ định mã nhận dạng, dẫn đến việc giá trị 0 sẽ được truyền vào. Cách xử lý Không có Mẹo phòng tránh dịch Xin lưu ý rằng 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 của 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 các trường bắt buộc khi cố gắng thêm một thực thể. Cách xử lý Ghi lại 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 các trường bắt buộc.

ResourceCountLimitExceededError

RESOURCE_LIMIT

Tóm tắt 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.

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ả của 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 và gửi lại yêu cầu. Mẹo phòng tránh dịch Hãy lưu ý đến giới hạn độ dài chuỗi.