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 thư viện 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 bạn muốn sử dụng):
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ài đặt. Toán tử phiên bản bi quan "~> x.y.z" đảm bảo rằng bundle install hoặc bundle update chỉ cài đặt các phiên bản vá lỗi 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 phụ hoặc phiên bản chính mới theo cách thủ công bằng cách cập nhật Gemfile.
Các lựa chọn cài đặt khác
Nếu không dùng Bundler, 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 RubyGems:
gem install google-ads-googleadsTải gem xuống từ trang Bản phát hành rồi cài đặt từ tệp cục bộ:
gem install google-ads-googleads-[version].gem
Thiết lập chế độ xác thực
Để xác thực các lệnh gọi API, hãy định cấu hình tệp google_ads_config.rb và làm theo hướng dẫn trên trang Xác thực và uỷ quyền.
Cách sử dụng
Kể từ google-ads-googleads phiên bản 41.1.0, gem này hỗ trợ tính năng tự động yêu cầu Bundler (Bundler.require). Trong các phiên bản trước phiên bản 41.1.0 (hoặc khi không sử dụng Bundler.require), hãy yêu cầu gem một cách rõ ràng trong mã của bạn:
require 'google/ads/google_ads'
Khởi chạy ứng dụng (theo mặc định, ứng dụng sẽ tải cấu hình từ ~/google_ads_config.rb) và tìm nạp một dịch vụ cụ thể, chẳng hạn như CampaignService:
# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new
# Fetch the CampaignService client.
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 bạn đã quen với các ví dụ, hãy khám phá các phương thức khởi tạo. Các 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ủ sẽ gửi ngoại lệ nếu các lệnh gọi API của bạn không thành công. Điều quan trọng là bạn phải 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ể Google::Ads::GoogleAds::Errors::GoogleAdsError sẽ được tạo khi xảy ra lỗi API. Nội dung này chứa thông tin chi tiết giúp bạn xác định vấn đề 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.