Tiện ích tra cứu

Khi sử dụng API, việc tìm nạp các tham chiếu đến các lớp giao thức yêu cầu bạn phải hiểu rõ về API hoặc thường xuyên tra cứu tài liệu tham khảo giao thức để biết đường dẫn chính xác.

ProtoLookupUtil

Tiện ích tra cứu proto cho phép bạn tra cứu và tạo các phiên bản của dịch vụ, thao tác, hoạt động liệt kê và tài nguyên mà không cần theo dõi số phiên bản và không gian tên của API.

Dưới đây là cách bạn thường khởi tạo một chiến dịch:

campaign = Google::Ads::GoogleAds::V20::Resources::Campaign.new

Nhưng với tiện ích tra cứu proto, bạn có thể sử dụng một biểu mẫu đơn giản hơn:

campaign = client.resource.campaign

Khi tìm nạp một tài nguyên, dịch vụ hoặc thao tác, một phiên bản của thực thể đó sẽ được trả về. Khi tìm nạp một phép liệt kê, một tham chiếu đến lớp sẽ được trả về mà không cần khởi tạo.

Đối với các hoạt động liệt kê, bạn có thể dùng một phím tắt để bỏ qua nhu cầu tra cứu các giao thức liệt kê.

campaign.status = :PAUSED

Bạn nên sử dụng phương thức client.service để tìm nạp các dịch vụ ngay cả khi không dùng tiện ích này cho bất kỳ trường hợp sử dụng nào khác. Có thêm logic được tích hợp vào phương thức này để truyền mã thông báo nhà phát triển và thông tin xác thực của bạn. Bạn sẽ phải xử lý thông tin này theo cách thủ công nếu sử dụng một phương thức khác.