Việc tìm nạp tài liệu tham chiếu đến các lớp proto khi sử dụng API đòi hỏi bạn phải có kiến thức nội tại về API hoặc cần thường xuyên tra cứu tài liệu tham khảo proto để 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 thực thể của dịch vụ, thao tác, giá trị liệt kê và tài nguyên mà không cần phải theo dõi số phiên bản API và không gian tên.
Dưới đây là cách bạn thường tạo thực thể cho một chiến dịch:
campaign = Google::Ads::GoogleAds::V16::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 hoạt động, một bản sao của thực thể đó sẽ được trả về. Khi tìm nạp một bản liệt kê, một tham chiếu đến lớp sẽ được trả về mà không cần tạo thực thể.
Đối với liệt kê, bạn có thể sử dụng một lối tắt để bỏ qua nhu cầu tra cứu các proto liệt kê.
campaign.status = :PAUSED
Bạn nên dùng phương thức client.service để tìm nạp các dịch vụ ngay cả khi bạn 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 tích hợp trong phương thức này để truyền mã của nhà phát triển và thông tin xác thực của bạn. Bạn sẽ phải xử lý theo cách thủ công nếu sử dụng một phương thức khác.