قائمة التحقُّق من نقل البيانات

مكتبة الفيديو: ورشة العمل 2021

في ما يلي قائمة تحقُّق لمساعدتك في بدء نقل البيانات:

  1. مراجعة عمليات الربط من AdWords API إلى Google Ads API:

  2. يمكنك الاطّلاع على الأدوات التالية:

  3. عليك قبول الأحكام والشروط المعدَّلة وتعديل معلومات الاتصال في مركز API.

    • سجِّل الدخول إلى مركز واجهة برمجة التطبيقات في الحساب الإداري الذي يحتوي على الرمز المميّز للمطوّر: ads.google.com/aw/apicenter.
    • انتقِل للأسفل إلى البريد الإلكتروني المخصّص للتواصل في واجهة برمجة التطبيقات وعدِّله.
    • انتقِل للأسفل إلى المكان الرئيسي للنشاط التجاري واقبل الشروط الجديدة، ثم انقر على حفظ.
  4. فعِّل Google Ads API في مشروعك على Google Cloud.

    • افتح مكتبة واجهة برمجة التطبيقات في وحدة تحكم Google API. اختَر مشروعك أو أنشئ مشروعًا جديدًا إذا طُلب منك ذلك. تعرض مكتبة واجهة برمجة التطبيقات جميع واجهات برمجة التطبيقات المتاحة، مجمّعة حسب مجموعة المنتجات والجمهور.
    • استخدِم البحث للعثور على Google Ads API إذا لم تكن مرئية في القائمة.
    • اختَر Google Ads API، ثم انقر على الزر تفعيل.
  5. إذا كنت قد استخدمت AdWords API من قبل، ستظل بيانات الاعتماد التي تستخدمها صالحة لواجهة Google Ads API. لا تطلب رمزًا مميزًا جديدًا لمطوّر البرامج أو أنشئ زوجًا جديدًا من بروتوكول OAuth2 clientId وclientSecret.

  6. اختَر مكتبة برامج.

  7. راجِع دليل البدء السريع لإجراء مكالمتك الأولى.

استخدام مكتبة برامج

إذا كنت تستخدم إحدى مكتبات العملاء في AdWords API، يمكنك تنزيل إحدى مكتبات عملاء Google Ads API وبدء العمل على الفور. للحصول على تعليمات عن كيفية إعداد ملف الإعداد، راجِع ReadME في مكتبة البرامج.

في معظم الحالات، يمكن إعادة استخدام الضبط الحالي عند نقل البيانات من مكتبات عميل AdWords API إلى مكتبات عملاء Google Ads API. أحد الاختلافات الرئيسية هو الإصدار الجديد من login-customer-id. يقدّم دليلنا معلومات حول الحالات التي تحتاج فيها إلى إضافة هذه الإعدادات إلى إعداداتك.

مثال على إعداد Java

بالنسبة إلى مكتبة برامج Java، يمكنك نسخ الأسطر في ملف ads.properties التي تحدّد بيانات الاعتماد وتغيير البادئة api.adwords في كل مفتاح إلى api.googleads:

api.adwords.clientId       --> api.googleads.clientId
api.adwords.clientSecret   --> api.googleads.clientSecret
api.adwords.refreshToken   --> api.googleads.refreshToken
api.adwords.developerToken --> api.googleads.developerToken

بعد تحديث ملف الإعداد، يمكنك المتابعة لإجراء مكالمتك الأولى:

لغة Java

  1. في بيئة التطوير المتكاملة (IDE)، افتح GetCampaign.java ونفِّذها.
  2. يجب أن تطبع وحدة التحكم قائمة بالحملات في حسابك.

C#‎

  1. في بيئة التطوير المتكاملة (IDE)، افتح GetCampaigns.cs ونفِّذها.
  2. يجب أن تطبع وحدة التحكم قائمة بالحملات في حسابك.

‫2,999

  1. نفِّذ GetGet.php.
  2. يجب أن تطبع وحدة التحكم قائمة بالحملات في حسابك.

لغة Python

  1. في بيئة التطوير المتكاملة (IDE)، افتح get_campaigns.py ونفِّذها.
  2. يجب أن تطبع وحدة التحكم قائمة بالحملات في حسابك.

Ruby

  1. في سطر الأوامر، نفِّذ get_campaigns.rb عن طريق الكتابة:
    ruby get_campaigns.rb
  2. يجب أن تطبع وحدة التحكم قائمة بالحملات في حسابك.

Perl

  1. نفِّذ get_campaigns.pl.
  2. يجب أن تطبع وحدة التحكم قائمة بالحملات في حسابك.

أمثلة على الرموز

وتقدِّم مكتبات العملاء أيضًا أمثلة مفصّلة للرموز تعرض كيفية نقل البيانات من AdWords API إلى Google Ads API.

بدائل لاستخدام مكتبة برامج

إذا كنت تستخدم AdWords API بدون مكتبة عملاء وتريد الاستمرار في إجراء ذلك باستخدام Google Ads API، سيظل بإمكانك استخدام بيانات اعتمادك.

يمكنك الانتقال إلى دليل REST للاطّلاع على كيفية استخدام بيانات الاعتماد لتنفيذ الطلبات في واجهة برمجة تطبيقات "إعلانات Google" باستخدام REST عبر HTTP.