Để tìm nạp các tệp tham chiếu đến lớp proto khi sử dụng API, bạn phải hiểu rõ 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, liệt kê và tài nguyên mà không cần 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 bản sao của một chiến dịch:
campaign = Google::Ads::GoogleAds::V19::Resources::Campaign.new
Tuy nhiên, 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 thực thể của thực thể đó sẽ được trả về. Khi tìm nạp một enum, hệ thống sẽ trả về một tệp tham chiếu đến lớp mà không cần tạo bản sao.
Đối với các enum, bạn có thể sử dụng một phím tắt để không cần tra cứu proto enum.
campaign.status = :PAUSED
Bạn nên sử dụng phương thức client.service để tìm nạp dịch vụ ngay cả khi bạn không sử dụng tiện ích này cho bất kỳ trường hợp sử dụng nào khác. Phương thức này có thêm logic để truyền mã thông báo nhà phát triển và thông tin xác thực. Bạn sẽ phải xử lý các thông tin này theo cách thủ công nếu sử dụng phương thức khác.