Lỗi thường gặp

Trang này liệt kê các lỗi thường gặp, đồng thời cung cấp các mẹo để 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 bao gồm 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. Một lý do phổ biến gây ra 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 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 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 việc 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 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 đượ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 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 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ả việc thay đổi 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 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 gửi yêu cầu đến 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 này đã đượ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 chứa một thao tác tạo cho một thành phần 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 tài nguyên có 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 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 của khách hàng không hợp lệ. 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 không đượ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 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 khách hàng, 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 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 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 được 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ý) 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 mà 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 Hãy đảm bảo rằng bạn đã chuyển đúng mã truy cập được liên kết với tài khoản của mình. Mã này đôi khi 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 xác thực 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 nhớ lấy 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 Google Cloud chỉ có quyền truy cập 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 Google Cloud có Cấp truy cập thử nghiệm đã được dùng để gửi yêu cầu đến 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 các phiên bản API v24 trở xuống, điều kiện này sẽ trả về AuthorizationError.ACTION_NOT_PERMITTED.) Cách xử lý Nếu bạn đang thử nghiệm, hãy đảm bảo yêu cầu của bạn nhắm đến một tài khoản thử nghiệm. 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 đã 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 nối (-). Thư viện ứng dụng có hỗ trợ tích hợp 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 tính theo đơn vị 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 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ó đang 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 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 có nghĩa khi được chuyển đổi từ số tiền vi mô 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 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 này đã đượ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 trùng với tên của một chiến dịch hiện có đang hoạt động hoặc bị 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, có thể đề xuất tên chiến dịch riêng biệt hoặc hiển thị 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 so 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 bạn cố gắng đặt hoặc sửa đổi trường này, lỗi sẽ xảy ra. Cách xử lý Khuyên người dùng sử dụng tham 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) trong 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 `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 bạn không sử dụng bất kỳ ký tự nào không được phép trong từ khoá. 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 Xoá các mục trùng lặp (thao tác, tham số, phần tử 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 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ề tầng 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 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 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 đổi lấy mã thông báo OAuth có định dạng không đú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 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.

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 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 được 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 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 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 Hãy 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 mức 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 truyền giá trị 0. 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 lại trong tài liệu tham khảo API.

RequestError
INVALID_INPUT	Tóm tắt Yêu cầu có định dạng không chính xác. 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 để 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 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 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. Hãy 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ó giới hạn.

StringLengthError
TOO_LONG	Tóm tắt Chuỗi được chỉ định cho trường đã 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 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.