Giới hạn

Trang này trình bày các giới hạn và giới hạn trong tập lệnh Google Ads mà bạn cần lưu ý. 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ó khả năng xử lý lỗi.

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

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 đó sẽ bị huỷ. Tất cả các thay đổi được thực hiện trước khi tập lệnh bị huỷ sẽ được áp dụng.

Tập lệnh Google Ads Manager

Tập lệnh Ads Manager thường có thể thực thi trong tối đa 30 phút sau đó sẽ bị huỷ. Tuy nhiên, nếu một tập lệnh Ads Manager sử dụng phương thức executeInParallel để xử lý song song các tài khoản 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 bên dưới, 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 tập lệnh bị huỷ sẽ được áp dụng.

Hạn mức về số thực thể

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

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

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

    10.000 sẽ dẫn đến lỗi thời gian chạy.

  • Đầu ra nhật ký sẽ bị cắt bớt ở mức 100Kb. Hệ thống sẽ ghi lại cảnh báo nếu điều đó xảy ra.

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

  • Mỗi tài khoản do một tập lệnh Ad Manager xử lý sẽ có hạn mức riêng như liệt kê ở trên.

  • 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.

Hạn mức tải lên hàng loạt

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

  • Công việc tải lên sẽ hết thời gian 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ụ cơ bản của Google Apps Script áp dụng các hạn mức hằng ngày và giới hạn cố định cho một số tính năng. Để xem danh sách các hạn mức này và các thông báo ngoại lệ đi kèm, hãy tham khảo trang này.

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

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

Nếu thường xuyên đạt đến 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 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 biệt: