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

مكتبة الفيديو: ورشة العمل لعام 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". لا تطلب رمزًا مميزًا جديدًا لمطوّر البرامج أو إنشاء أزواج clientId وclientSecret جديدة من OAuth.

  6. اختر مكتبة عميل.

  7. يمكنك الاطّلاع على دليل Quickstart لإجراء مكالمتك الأولى.

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

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

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

مثال على إعداد جافا

بالنسبة إلى مكتبة برامج 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، افتح GetCampaign.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 بدون مكتبة عميل وترغب في مواصلة تنفيذ ذلك باستخدام Google Ads API، سيظل بإمكانك استخدام بيانات اعتمادك.

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