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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

    • سجِّل الدخول إلى مركز واجهة برمجة التطبيقات للحساب الإداري حيث يتوفّر لديك الرمز المميّز لمطوّر البرامج: 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. راجِع دليل Quickstart لإجراء أول مكالمة لك.

استخدام مكتبة عملاء

إذا كنت تستخدم إحدى مكتبات العملاء في 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. يجب أن تعرض وحدة التحكم قائمة بالحملات في حسابك.

PHP

  1. نفِّذ GetCampaign.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 Ads API باستخدام REST عبر HTTP.