في ما يلي الاستخدام الأساسي لمكتبة البرامج:
تثبيت
الطريقة المقترَحة للتثبيت هي استخدام bundler. أضِف سطرًا
إلى Gemfile (مع استبدال x.y.z برقم الإصدار الذي يهمّك):
gem 'google-ads-googleads', '~> x.y.z'
بعد ذلك، استخدِم الأمر التالي:
$ bundle install
يستخدم هذا الأمر أداة Bundler لتعديل Gemfile.lock، مع تحديد الإصدار الدقيق من Gem وجميع التبعيات التي تم تثبيتها. يؤدي عامل تشغيل الإصدار المتشائم "~> x.y.z" إلى تثبيت bundle update للإصدارات الجديدة فقط في سلسلة x.y.*، لذا عليك الموافقة يدويًا على الإصدارات الجديدة من خلال تعديل Gemfile مرة أخرى.
خيارات التثبيت الأخرى
إذا كنت لا تستخدم bundler، يمكنك استخدام أحد الخيارات التالية:
- ثبِّت هذه المكتبة باستخدام gem:
terminal $ [sudo] gem install google-ads-googleads - نزِّل Gem من
صفحة الإصدارات وثبِّته
من الملف المحلي:
terminal $ [sudo] gem install google-ads-googleads-[version].gem
إعداد المصادقة
لمصادقة طلبات البيانات من واجهة برمجة التطبيقات، اتّبِع التعليمات الواردة في صفحة "المصادقة والتفويض".
الاستخدام
لتضمين Gem في الرمز البرمجي، اتّبِع الخطوات التالية:
require 'google/ads/google_ads'
لاسترداد خدمة معيّنة، مثل CampaignService، اتّبِع الخطوات التالية:
client = Google::Ads::GoogleAds::GoogleAdsClient.new
campaign_service = client.service.campaign
يمكنك الاطّلاع على الأمثلة على GitHub للحصول على عروض توضيحية أكثر تفصيلاً حول كيفية استخدام المكتبة.
بعد التعرّف على الأمثلة، ننصحك أيضًا بالتعرّف على عناصر الإنشاء التي توفّر مجموعة من الطرق المريحة العالية المستوى للعمل مع Google Ads API.
معالجة الأخطاء
لن تنجح كل طلبات البيانات من واجهة برمجة التطبيقات. يمكن أن يعرض الخادم أخطاءً إذا تعذّرت معالجة طلبات البيانات من واجهة برمجة التطبيقات لسبب ما. من المهم تسجيل أخطاء واجهة برمجة التطبيقات والتعامل معها بشكل مناسب.
يتم عرض مثيل GoogleAdsException عند حدوث خطأ في واجهة برمجة التطبيقات. ويتضمّن تفاصيل لمساعدتك في معرفة سبب المشكلة، ويمكنك إعداد دالة مساعدة للتعامل مع الأخطاء. اطّلِع على مثال على معالج أخطاء على GitHub.