الاستخدام الأساسي

في ما يلي الاستخدام الأساسي لمكتبة البرامج:

تثبيت

الطريقة المقترَحة لتثبيت المكتبة هي استخدام Bundler. أضِف سطرًا إلى Gemfile (مع استبدال x.y.z برقم الإصدار الذي تريد استخدامه):

gem 'google-ads-googleads', '~> x.y.z'

بعد ذلك، شغِّل:

bundle install

يستخدم هذا الأمر Bundler لتحديث Gemfile.lock، مع قفل الإصدار الدقيق من gem وجميع تبعيات gem التي تم تثبيتها. يضمن عامل تشغيل الإصدار المتشائم "~> x.y.z" أنّ bundle install أو bundle update يثبّت فقط إصدارات التصحيح الجديدة في سلسلة x.y.*، لذا عليك تفعيل الإصدارات الثانوية أو أرقام الإصدارات الرئيسية الجديدة يدويًا من خلال تحديث Gemfile.

خيارات التثبيت الأخرى

إذا لم تكن تستخدم Bundler، يمكنك استخدام أحد الخيارات التالية:

  1. ثبِّت هذه المكتبة باستخدام RubyGems:

    gem install google-ads-googleads

  2. نزِّل gem من صفحة الإصدارات وثبِّته من الملف المحلي:

    gem install google-ads-googleads-[version].gem

إعداد المصادقة

لمصادقة طلبات البيانات من واجهة برمجة التطبيقات، اضبط ملف google_ads_config.rb واتّبِع التعليمات الواردة في صفحة المصادقة والتفويض.

الاستخدام

Starting in google-ads-googleads v41.1.0, the gem supports Bundler autorequire (Bundler.require). In versions prior to v41.1.0 (or when not using Bundler.require), explicitly require the gem in your code:

require 'google/ads/google_ads'

ابدأ العميل (الذي يحمّل الإعدادات من ~/google_ads_config.rb تلقائيًا) واجلب خدمة معيّنة، مثل CampaignService:

# Initialize the client using ~/google_ads_config.rb.
client = Google::Ads::GoogleAds::GoogleAdsClient.new

# Fetch the CampaignService client.
campaign_service = client.service.campaign

يمكنك الاطّلاع على الأمثلة على GitHub للحصول على عروض توضيحية أكثر تفصيلاً حول كيفية استخدام المكتبة.

بعد التعرّف على الأمثلة، يمكنك استكشاف المصانع التي توفّر مجموعة من الطرق الملائمة العالية المستوى للعمل مع Google Ads API.

معالجة الأخطاء

لا تنجح بعض طلبات البيانات من واجهة برمجة التطبيقات. يُظهر الخادم استثناءات في حال تعذّر تنفيذ طلبات البيانات من واجهة برمجة التطبيقات. من المهم رصد أخطاء واجهة برمجة التطبيقات ومعالجتها بشكل مناسب.

يتم عرض مثيل Google::Ads::GoogleAds::Errors::GoogleAdsError عند حدوث خطأ في واجهة برمجة التطبيقات. وتحتوي على تفاصيل لمساعدتك في تحديد الخطأ، ويمكنك إعداد دالة مساعِدة لمعالجة الأخطاء. يمكنك الاطّلاع على مثال على معالج الأخطاء على GitHub.