Giới hạn

Trang này trình bày nhiều giới hạn và hạn chế trong tập lệnh Google Ads mà bạn nên biết. Các giới hạn này có thể thay đổi bất cứ lúc nào mà không cần cảnh báo, vì vậy, hãy đảm bảo rằng tập lệnh của bạn linh hoạt và có chứa quy trình xử lý lỗi.

Giới hạn thời gian thực thi

Tập lệnh Google Ads

Tập lệnh Google Ads cho tài khoản nhà quảng cáo có thể thực thi trong tối đa 30 phút, sau đó tập lệnh sẽ bị huỷ. Tất cả các thay đổi được thực hiện trước khi kịch bản bị huỷ sẽ được áp dụng.

Tập lệnh của tài khoản người quản lý Google Ads

Tập lệnh của Trình quản lý quảng cáo thường có thể thực thi trong tối đa 30 phút, sau đó tập lệnh sẽ bị huỷ. Tuy nhiên, nếu một tập lệnh của Trình quản lý quảng cáo sử dụng phương thức executeInParallel để xử lý các tài khoản song song và chỉ định một phương thức gọi lại, thì tập lệnh đó có thể thực thi trong tối đa 60 phút trước khi bị huỷ. Điều này được minh hoạ trong hình sau, trong đó processAccount là hàm song song và allFinished là phương thức gọi lại khi gọi executeInParallel.

Tất cả các thay đổi được thực hiện trước khi kịch bản bị huỷ sẽ được áp dụng.

Giới hạn về thực thể

Tập lệnh của tài khoản Google Ads

  • Một trình lặp sẽ trả về tối đa 50.000 kết quả theo mặc định. Bạn có thể sửa đổi bằng cách gọi withLimit() trên bộ chọn.

  • Một bộ chọn có thể xử lý tối đa 10.000 mã nhận dạng trong selector.withIds(). Nếu bạn chỉ định từ 10.000 mã nhận dạng trở lên, selector.get() sẽ gửi một lỗi thời gian chạy. Tương tự, việc chỉ định điều kiện Id IN [LIST] có danh sách hơn 10.000 mã nhận dạng sẽ dẫn đến lỗi thời gian chạy.

  • Kết quả ghi nhật ký sẽ bị cắt bớt ở mức 100Kb. Một cảnh báo sẽ được ghi lại nếu điều đó xảy ra.

Kịch bản của tài khoản người quản lý

  • Mỗi tài khoản được tập lệnh Trình quản lý quảng cáo xử lý sẽ có hạn mức riêng như được liệt kê trong phần trước.

  • Khi sử dụng phương thức executeInParallel, một tập lệnh có thể xử lý tối đa 50 tài khoản.

  • Phương thức processAccount từ executeInParallel có thể trả về tối đa 10 MB dữ liệu.

Giới hạn tải lên hàng loạt

  • Tệp tải lên bị giới hạn ở mức 50 MB và 1 triệu hàng, đồng thời sẽ bị từ chối khi gửi nếu vượt quá các giới hạn này.

  • Một công việc tải lên sẽ hết thời gian chờ sau 2 giờ và công việc đó sẽ ngừng xử lý mọi dữ liệu còn lại trong tệp đã tải lên.

Hạn mức cho các dịch vụ của Google

Các dịch vụ Google Apps Script cơ bản áp đặt hạn mức hằng ngày và giới hạn nghiêm ngặt đối với một số tính năng. Xem danh sách các hạn mức này và thông báo ngoại lệ đi kèm.

Tập lệnh được uỷ quyền

OAuth2 được dùng để uỷ quyền cho tập lệnh. Mỗi tài khoản có giới hạn là 250 tập lệnh được uỷ quyền. Nếu vượt quá hạn mức đó, một trong những tập lệnh đã được uỷ quyền trước đó sẽ bị huỷ uỷ quyền. Đây chỉ là tạm thời và tập lệnh có thể được uỷ quyền lại vào lần tiếp theo bạn mở tập lệnh.

Nếu thường xuyên gặp phải giới hạn này, bạn nên cân nhắc sử dụng nhiều tài khoản người dùng để uỷ quyền cho các nhóm tập lệnh khác nhau.

Chiến dịch video và chiến dịch mua sắm

Bộ chọn chiến dịch chuẩn (AdsApp.campaigns().get()) sẽ lọc ra các chiến dịch video và mua sắm khỏi kết quả. Thay vào đó, hãy sử dụng bộ chọn chiến dịch chuyên dụng: