Sau đây là cách sử dụng cơ bản của thư viện ứng dụng:
Cài đặt
Bạn nên cài đặt bằng cách sử dụng bundler. Thêm một dòng vào Gemfile (thay thế x.y.z bằng số phiên bản mà bạn quan tâm):
gem 'google-ads-googleads', '~> x.y.z'
Sau đó, hãy chạy:
$ bundle install
Lệnh này sử dụng bundler để cập nhật Gemfile.lock, khoá chính xác phiên bản của gem và tất cả các phần phụ thuộc của gem đã được cài đặt. Toán tử phiên bản bi quan "~> x.y.z" khiến bundle update chỉ cài đặt các phiên bản mới trong chuỗi x.y.*, vì vậy, bạn phải chọn sử dụng các phiên bản mới theo cách thủ công bằng cách cập nhật lại Gemfile.
Các lựa chọn cài đặt khác
Nếu không dùng trình đóng gói, bạn có thể dùng một trong các lựa chọn sau:
- Cài đặt thư viện này bằng gem:
terminal $ [sudo] gem install google-ads-googleads - Tải gem xuống từ trang Bản phát hành rồi cài đặt gem đó từ tệp cục bộ:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
Thiết lập tính năng xác thực
Để xác thực các lệnh gọi API, hãy làm theo hướng dẫn trên trang Xác thực và uỷ quyền.
Cách sử dụng
Cách thêm gem vào mã của bạn:
require 'google/ads/google_ads'
Để tìm nạp một dịch vụ cụ thể, chẳng hạn như CampaignService:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
Hãy xem các ví dụ trên GitHub để biết thêm thông tin chi tiết về cách sử dụng thư viện này.
Sau khi làm quen với các ví dụ, bạn cũng nên làm quen với các phương thức khởi tạo. Phương thức này cung cấp một tập hợp các phương thức tiện lợi cấp cao để làm việc với API Google Ads.
Xử lý lỗi
Không phải lệnh gọi API nào cũng thành công. Máy chủ có thể gửi lỗi nếu lệnh gọi API của bạn không thành công vì lý do nào đó. Bạn cần nắm bắt và xử lý các lỗi API một cách thích hợp.
Một thực thể GoogleAdsException sẽ được gửi khi xảy ra lỗi API. Nó có thông tin chi tiết để giúp bạn tìm ra lỗi và bạn có thể thiết lập một hàm trợ giúp để xử lý các lỗi. Xem ví dụ về trình xử lý lỗi trên GitHub.