Lỗi thường gặp

Trang này liệt kê các lỗi thường gặp và đưa ra các 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, hướng dẫn Tìm hiểu về các lỗi API hoặc hướng dẫn về Các loại lỗi. Để được hỗ trợ thêm, hãy liên hệ với Nhóm hỗ trợ API Google Ads.

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 có 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. Lý do thường gặp dẫn đến lỗi này là bạn đang 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 bằng 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ó đượ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 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 xuất bản của dự án trê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. Mẹo phòng tránh dịch Xem phần Ứng dụng chưa được xác minh.

AdError
CANNOT_USE_AD_SUBCLASS_FOR_OPERATOR	Tóm tắt Bạn không thể sử dụng toán tử này với một lớp con của Quảng cáo. 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.
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 được phép. 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 đường kẻ 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 Cố gắng liên kết nhãn với những 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ị xoá, quảng cáo sẽ không thể cập nhật được nữa, kể cả những thay đổi về trạng thái. 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 những quảng cáo đã bị xoá.

AdGroupCriterionError
INVALID_KEYWORD_TEXT	Tóm tắt Văn bản từ khoá chứa ký tự không hợp lệ. Xem phần Thêm từ khoá. Nguyên nhân thường gặp Văn bản từ khoá chứa 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 đưa ra yêu cầu cho API.

AdGroupError

DUPLICATE_ADGROUP_NAME

Tóm tắt 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 đ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ẹ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 Một yêu cầu biến đổ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 thành phần trong một yêu cầu riêng biệt, sau đó liên kết đến thành phần đó trong yêu cầu tiếp theo; hoặc sử dụng mã 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 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 sử dụng để 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ý Đợ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 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.

AuthorizationError
CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Tóm tắt Dự án trên đám mây của Google Cloud chỉ có quyền truy cập vào tài khoản 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 trên đám mây của Google Cloud có Cấp truy cập thử nghiệm đã được dùng để đưa ra yêu cầu đối với 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 API phiên bản 24 trở xuống, điều kiện này trả về AuthorizationError.ACTION_NOT_PERMITTED.) Cách xử lý Nếu bạn đang kiểm thử, hãy đảm bảo rằng yêu cầu của bạn nhắm đến một tài khoản kiểm thử. Nếu bạn muốn truy cập vào một tài khoản Google Ads thực, hãy kiểm tra cấp truy cập của dự án Google Cloud trên trang Tổng quan về Google Ads API và nâng cấp cấp truy cập của dự án lên cấp truy cập Explorer, Cơ bản hoặc Tiêu chuẩn. Mẹo phòng tránh dịch Không có
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 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 đã 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.
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 ngang (-). Thư viện ứng dụng có hỗ trợ sẵn cho việc này.

BiddingError
BID_TOO_MANY_FRACTIONAL_DIGITS	Tóm tắt 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. 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ó tham gia chương trình Google Ad Grants hay không. Nếu có, hãy giới hạn giá thầu CPC ở mức tối đa theo quy định của chương trì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 của đơ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ừ một số tiền nhỏ sang số tiền bằng đơ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ệ trong 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 có tên của một chiến dịch đang hoạt động hoặc bị tạm dừng. Cách xử lý Ghi lại lỗi và cho người dùng thấy thông báo lỗi, đồng thời có thể đề xuất một tên chiến dịch duy nhất hoặc cho thấy danh sách tên đang được sử dụng. Mẹo phòng tránh dịch Không có
CANNOT_SET_CAMPAIGN_KEYWORD_MATCH_TYPE	Tóm tắt Bạn đang cố gắng thay đổi chế độ cài đặt kiểu khớp từ khoá ở cấp chiến dịch cho một chiến dịch đã bật bộ tính năng Tối đa hoá AI. Nguyên nhân thường gặp Khi bạn bật bộ tính năng Tối đa hoá AI, chế độ cài đặt kiểu khớp mở rộng ở cấp chiến dịch sẽ ngừng hoạt động vì theo mặc định, tất cả từ khoá đều được coi là từ khoá khớp mở rộng. Nếu cố gắng đặt hoặc sửa đổi trường này, bạn sẽ gặp lỗi. Cách xử lý Khuyên người dùng sử dụng thông số `disable_search_term_matching` ở cấp nhóm quảng cáo thay vì đặt kiểu khớp mở rộng ở cấp chiến dịch. Mẹo phòng tránh dịch Tránh đặt "keyword_match_type" thành "BROAD" (hoặc bất kỳ giá trị nào khác) trên chiến dịch nếu "ai_max_setting.enable_ai_max" được đặt thành "true". Bật/tắt tính năng so khớp cụm từ tìm kiếm ở cấp nhóm quảng cáo bằng cách sử dụng "disable_search_term_matching".

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 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 rằng bạn không sử dụng bất kỳ ký tự nào không được phép trong từ khoá. Xem phần 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à dư 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 Xoá các mục trùng lặp (thao tác, tham số, phần tử danh sách) trước khi đưa ra yêu cầu. Tìm những trường 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 Một yêu cầu tìm kiếm đã tạo ra phản hồi quá lớn hoặc một yêu cầu thay đổi tài nguyên quá lớn để 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 để 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 phản hồi. Lưu ý các hạn chế về lớp truyền tải gRPC.
INTERNAL_ERROR	Tóm tắt Đã xảy ra lỗi không mong muốn trong quá trình 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 thông tin xác thực người dùng uỷ quyền 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ã thông báo đó không sử dụng được để truy cập vào Google Ads API 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.

MutateError

RESOURCE_NOT_FOUND

Tóm tắt Yêu cầu đề cập đến 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ố gắng sửa đổ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 thay đổi tài nguyên. 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.

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 một danh sách trống các thao tác 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 Một giá trị thấp hơn giá trị tối thiểu được phép. Nguyên nhân thường gặp Quên chỉ định một mã nhận dạng, dẫn đến việc giá trị 0 được truyền vào. Cách xử lý Không có Mẹo phòng tránh dịch Lưu ý mọi giới hạn về phạm vi được ghi trong tài liệu tham khảo API.

RequestError
INVALID_INPUT	Tóm tắt Yêu cầu sai định dạng. Nguyên nhân thường gặp URL hoặc nội dung của yêu cầu sai đị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 nhật ký lỗi và hiện 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 để biết những trường nào là 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 khiến tổng số tài nguyên đó vượt quá một hạn mức được 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 Giới hạn hệ thống. Sử dụng lại một 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ế.

StringLengthError
TOO_LONG	Tóm tắt Chuỗi được chỉ định cho trường cụ thể 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 mà bạ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 Lưu ý đến giới hạn độ dài chuỗi.