Google Ads API là công cụ mạnh mẽ dành cho các nhà phát triển muốn tích hợp các chức năng quảng cáo vào hệ thống của mình. Tuy nhiên, một trong những thách thức lớn nhất khi làm việc với API này là giới hạn số lượng yêu cầu mà mỗi ứng dụng có thể gửi. Việc hiểu rõ và áp dụng các phương pháp để kiểm soát giới hạn này không chỉ giúp tránh lỗi mà còn nâng cao hiệu suất của ứng dụng. Trong bài viết này, chúng ta sẽ tìm hiểu chi tiết về giới hạn số lần yêu cầu trong Google Ads API và các cách để tối ưu hoá hiệu suất.
Giới hạn số lần yêu cầu
Nhóm API Google Ads áp dụng giới hạn số lượng yêu cầu trên mỗi giây (QPS) dựa trên mã khách hàng ứng dụng (CID) và mã nhà phát triển. Việc đo lường này được thực hiện độc lập cho cả CID và mã nhà phát triển. API Google Ads sử dụng thuật toán nhóm mã thông báo để giám sát lưu lượng yêu cầu và xác định giới hạn QPS phù hợp. Do đó, giới hạn cụ thể có thể thay đổi tùy theo tổng tải trọng của máy chủ tại thời điểm bất kỳ.
Mục tiêu của việc áp dụng giới hạn này là đảm bảo tính ổn định và ngăn chặn tình trạng một người dùng làm gián đoạn trải nghiệm của những người dùng khác bằng cách gửi một lượng lớn yêu cầu vượt quá khả năng xử lý của máy chủ API.
Những yêu cầu vượt quá giới hạn sẽ bị từ chối với lỗi: RESOURCE_TEMPORARILY_EXHAUSTED. Để giảm thiểu tình trạng này, bạn có thể kiểm soát ứng dụng của mình bằng cách chủ động giảm số lượng yêu cầu gửi đi và điều tiết tốc độ QPS từ phía máy khách.
Có nhiều cách để giảm nguy cơ vượt quá giới hạn QPS. Hiểu rõ các khái niệm trong mẫu tích hợp doanh nghiệp (Enterprise Integration Pattern – EIP) như nhắn tin, phân phối lại và điều tiết sẽ giúp bạn xây dựng ứng dụng khách hiệu quả hơn.
Dưới đây là các phương pháp được đề xuất, sắp xếp theo mức độ phức tạp từ thấp đến cao:
- Hạn chế số lượng tác vụ đồng thời
- Sử dụng yêu cầu phân lô
- Áp dụng kỹ thuật điều chỉnh và giới hạn tốc độ
- Triển khai hệ thống xếp hàng
Giới hạn các tác vụ đồng thời
Một trong những nguyên nhân chính dẫn đến việc vượt quá giới hạn số lượng yêu cầu là do ứng dụng khách tạo ra quá nhiều tác vụ song song. Mặc dù API Google Ads không giới hạn số lượng yêu cầu đồng thời mà một ứng dụng khách có thể thực hiện, việc này có thể dễ dàng vượt quá giới hạn số yêu cầu mỗi giây (QPS) dựa trên mã thông báo dành cho nhà phát triển.
Để tránh tình trạng này, bạn nên thiết lập giới hạn hợp lý cho tổng số tác vụ đồng thời thực hiện yêu cầu (trên tất cả các quy trình và máy). Giới hạn này có thể được điều chỉnh tăng dần để tối ưu hóa hiệu suất mà vẫn không vượt quá giới hạn tốc độ.
Ngoài ra, bạn cũng nên áp dụng điều tiết QPS từ phía máy khách (xem phần “Điều tiết và giới hạn tốc độ” bên dưới).
Yêu cầu gộp nhóm
Bạn nên xem xét việc gộp nhiều hoạt động thành một yêu cầu duy nhất, đặc biệt trong trường hợp các lệnh gọi API dạng MutateFoo. Ví dụ, nếu bạn cần cập nhật trạng thái cho nhiều thực thể của AdGroupAd, thay vì gọi MutateAdGroupAds một lần cho mỗi thực thể, bạn có thể gọi MutateAdGroupAds một lần và truyền nhiều hoạt động (operations) trong cùng yêu cầu.
Thao tác gộp nhóm này giúp giảm tổng số yêu cầu, từ đó giảm thiểu khả năng vượt quá giới hạn tốc độ yêu cầu mỗi phút (RPM). Tuy nhiên, bạn cần lưu ý rằng việc gộp nhóm có thể dẫn đến nguy cơ vượt quá giới hạn tốc độ thao tác mỗi phút nếu thực hiện quá nhiều thao tác trên cùng một tài khoản. Hãy tham khảo tài liệu hướng dẫn về thao tác hàng loạt của Google Ads để nắm rõ cách thực hiện.
Điều tiết và giới hạn tốc độ
Ngoài việc giới hạn số lượng tác vụ đồng thời, bạn cũng có thể triển khai các cơ chế điều tiết và giới hạn tốc độ từ phía máy khách. Điều này đảm bảo rằng tất cả các tác vụ, quy trình, hoặc cụm trong ứng dụng đều chịu sự kiểm soát chặt chẽ của một giới hạn QPS cụ thể.
Bạn có thể sử dụng các công cụ như trình giới hạn tốc độ của Guava hoặc tự xây dựng thuật toán dựa trên “Bộ chứa mã thông báo” (Token Bucket) để hoạt động trong môi trường phân cụm. Ví dụ, bạn có thể tạo mã thông báo và lưu trữ chúng trong một hệ thống bộ nhớ giao dịch dùng chung (như cơ sở dữ liệu). Mỗi ứng dụng cần thu thập và sử dụng mã thông báo trước khi thực hiện yêu cầu. Nếu mã thông báo hết, ứng dụng phải chờ cho đến khi lô mã thông báo mới được tạo.
Danh sách chờ
Hàng đợi thông báo là giải pháp tối ưu để kiểm soát tải trọng hoạt động và duy trì tốc độ yêu cầu phù hợp. Có nhiều tùy chọn hàng đợi, từ các giải pháp nguồn mở đến các dịch vụ thuộc quyền sở hữu riêng, với khả năng hỗ trợ đa ngôn ngữ.
Khi sử dụng hàng đợi thông báo, bạn có thể cấu hình nhiều nhà sản xuất để đẩy thông báo vào hàng đợi và nhiều người tiêu dùng để xử lý chúng. Việc điều tiết có thể được triển khai ở phía người tiêu dùng bằng cách giới hạn số lượng người tiêu dùng đồng thời hoặc áp dụng bộ giới hạn yêu cầu cho người sản xuất hoặc người tiêu dùng.
Ví dụ, nếu một người tiêu dùng gặp lỗi do vượt giới hạn tốc độ, họ có thể đẩy lại yêu cầu vào hàng đợi để thử lại. Đồng thời, người tiêu dùng này cũng có thể thông báo cho các thực thể tiêu dùng khác tạm dừng xử lý trong một khoảng thời gian ngắn để giảm tải và khắc phục lỗi.
Kiểm soát giới hạn số lần yêu cầu trong Google Ads API là yếu tố quan trọng để đảm bảo ứng dụng hoạt động mượt mà và không bị gián đoạn. Bằng cách áp dụng các phương pháp như hạn chế tác vụ đồng thời, phân lô yêu cầu, và điều tiết tốc độ, bạn có thể giảm thiểu rủi ro vượt quá giới hạn. Hãy bắt đầu triển khai các giải pháp này để tối ưu hoá hiệu suất ứng dụng và khai thác tối đa tiềm năng của Google Ads API.
