إعداد مشروع وحدة تحكّم Google API لواجهة Google Ads API

يجب إدخال بيانات الاعتماد للوصول إلى خوادم OAuth2 من Google من أجل مصادقة مستخدمي "إعلانات Google" وتفويضهم. تحدّد بيانات الاعتماد هذه تطبيقك لـ Google، ما يتيح لك إنشاء رموز OAuth المميزة لإدارة مستخدمي "إعلانات Google". تتم إدارة الوصول إلى بيانات اعتماد Google OAuth2 من وحدة التحكم في واجهة Google API.

مشاهدة هذا الفيديو للتعرّف على بعض أفضل الممارسات المتعلّقة بالمشاريع على Google Cloud

التحقّق من Google OAuth

إذا كان أيّ تطبيق من تطبيقات Google Cloud يتم استخدامه للحصول على بيانات الاعتماد الخاصة بنطاق Google Ads API، سيحتاج إلى إجراء عملية التحقّق من بروتوكول OAuth من Google لتجنُّب ظهور شاشة واجهة مستخدم لم يتم التحقّق منها لمستخدميه. في هذا السياق، يتم تعريف التطبيق على أنّه معرّف عميل OAuth 2.0 فريد في Google Cloud.

إنّ عملية إثبات الهوية هذه مستقلة وبالإضافة إلى أي مراجعات يتم إجراؤها كجزء من عملية الموافقة على الرمز المميز للمطوّر، وهي مطلوبة لأنّ نطاق Google Ads API يُعدّ نطاقًا حسّاسًا.

لا يتم تحصيل أي رسوم مقابل عملية إثبات الهوية من خلال Google، والتي تكتمل عادةً خلال فترة تتراوح بين 3 و5 أيام عمل. تسري هذه السياسة على جميع التطبيقات.

ننصح بأن تخضع جميع التطبيقات لعملية التحقّق من خلال Google OAuth في أسرع وقت ممكن لتجنُّب أي انقطاعات في النشاط التجاري.

إنشاء مشروع

انتقِل إلى وحدة التحكم في واجهة Google API. انقر على إنشاء مشروع، وأدخِل اسمًا وانقر على إنشاء.

تفعيل Google Ads API في مشروعك

لتفعيل Google Ads API لمشروعك، يُرجى اتّباع الخطوات التالية:

  1. افتح مكتبة واجهة برمجة التطبيقات في وحدة تحكم واجهة برمجة تطبيقات Google. إذا طُلب منك ذلك، حدد مشروعك أو أنشئ مشروعًا جديدًا. تسرد مكتبة واجهة برمجة التطبيقات جميع واجهات برمجة التطبيقات المتاحة، مجمّعة حسب مجموعة المنتجات ومدى الرواج.

  2. استخدِم ميزة البحث للعثور على Google Ads API إذا لم تكن معروضة في القائمة.

  3. اختر Google Ads API، ثمّ انقر على الزر تفعيل.

اختيار نوع المستخدم وحالة النشر

بعد تفعيل واجهة برمجة التطبيقات، عليك تحديد نوع المستخدم وحالة النشر لمشروعك. يسلط الجدول التالي الضوء على بعض السمات الرئيسية والقيود لكل مجموعة من هذه الإعدادات. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Google Cloud Platform.

نوع المستخدم حالة النشر القيود
داخلي الاختبار
  • متاحة فقط للمشاريع المرتبطة بمؤسسة على Google Cloud.
  • يقتصر عدد المستخدمين التجريبيين على ما يصل إلى 100 مستخدم اختباري مدرَجين في شاشة موافقة OAuth.
  • يجب أن يكون المستخدمون التجريبيون مستخدمين داخليين في مؤسسة Google Cloud المرتبطة بالمشروع.
  • تنتهي صلاحية التفويضات بعد سبعة أيام من وقت الموافقة.
External الاختبار
  • متاح لجميع المشاريع.
  • يقتصر عدد المستخدمين التجريبيين على ما يصل إلى 100 مستخدم اختباري مدرَجين في شاشة موافقة OAuth.
  • يمكن أن يكون المستخدمون المختبِرون أي مستخدم لديه حساب Google.
  • تنتهي صلاحية التفويضات بعد سبعة أيام من وقت الموافقة.
داخلي في مرحلة الإنتاج
  • متاحة فقط للمشاريع المرتبطة بمؤسسة على Google Cloud.
  • يتيح هذا الخيار السماح لأي مستخدم داخل مؤسسة Google Cloud المرتبطة بالمشروع.
External في مرحلة الإنتاج
  • متاح لجميع المشاريع.
  • تتيح هذه السياسة السماح لأي مستخدم لديه حساب على Google.

يؤدي عدم إكمال عملية التحقّق من بروتوكول Google OAuth إلى ما يلي، بغض النظر عن نوع المستخدم أو حالة النشر لمشروعك:

  1. افتح صفحة "شاشة الموافقة"، واختر مشروعك في القائمة المنسدلة في أعلى الصفحة.

  2. اختَر نوع المستخدم وانقر على إنشاء.

  3. املأ نموذج شاشة الموافقة. يمكنك تعديل هذه المعلومات لاحقًا إذا لزم الأمر. انقر على حفظ ومتابعة عند الانتهاء.

  4. في الصفحة التالية، انقر على إضافة مراجع أو إزالتها.

    • انتقِل للأسفل وأدخِل ما يلي في الحقل ضمن إضافة النطاقات يدويًا:

      https://www.googleapis.com/auth/adwords
      
    • انقر على إضافة إلى الجدول.

    • أضِف أي نطاقات أخرى سيطلبها مشروعك، ثم انقر على تعديل.

    • انقر على حفظ ومتابعة.

  5. إذا كنت لا تخطط لنشر مشروعك على الفور، يُرجى إضافة عنوان البريد الإلكتروني لكل حساب مستخدم ستستخدمه للاختبار، ثم النقر على حفظ ومتابعة.

  6. راجِع صفحة الملخّص وانقر على الرجوع إلى لوحة البيانات.

بعد اختبار تطبيقك وعملية التفويض، يمكنك الرجوع إلى لوحة البيانات والنقر على نشر التطبيق لتغيير حالة النشر من الاختبار إلى في مرحلة الإنتاج.

اختيار نوع تطبيق

يتوفّر خياران لنوعَي التطبيقات في Google Ads API: التطبيقات المتوافقة مع أجهزة الكمبيوتر المكتبي أو الويب. ارجع إلى الجدول التالي لتحديد النوع الأنسب للتطبيق الذي تريد إنشاءه:

اختيار نوع التطبيق هذا في حال ...
تطبيق متوافق مع أجهزة الكمبيوتر المكتبي
  • أنت تدير جميع حساباتك في "إعلانات Google" باستخدام حساب إداري واحد من المستوى الأعلى.
  • إذا كنت مستخدمًا لأول مرة، أو ترغب في البدء بسرعة بأبسط إعداد.
  • لن يصادق تطبيقك إلا مستخدمي Google من جهاز واحد.
تطبيق الويب
  • عليك إجراء المصادقة بصفتك مستخدمًا يمكنه منح تطبيقك الإذن بالوصول إلى بيانات حسابه على "إعلانات Google".
  • لنفترض أنك تريد إنشاء بيانات اعتماد متعددة بسهولة، لإدارة حسابات الجهات الخارجية على سبيل المثال.
  • يتطلب تطبيقك عناوين URL لمعاودة الاتصال. عناوين URL لمعاودة الاتصال غير متوافقة في تدفق تطبيق سطح المكتب.

لمعرفة مزيد من التفاصيل، يُرجى الرجوع إلى مستندات OAuth في Google Identity Platform بشأن تطبيقات الكمبيوتر المكتبي أو تطبيقات الويب.

إنشاء معرِّف العميل وسر العميل

بعد تحديد نوع تطبيقك، اتّبِع التعليمات أدناه لإنشاء معرِّف عميل OAuth2 وسر العميل:

  1. افتح صفحة بيانات الاعتماد. اختَر مشروعًا تم إنشاؤه سابقًا أو أنشئ مشروعًا جديدًا.

  2. في شاشة "بيانات الاعتماد"، انقر على إنشاء بيانات الاعتماد، ثم اختَر معرِّف عميل OAuth.

    1. إذا لم تكن قد ضبطت شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth في هذا المشروع سابقًا، سيتم توجيهك لإجراء ذلك الآن. انقر على ضبط شاشة الموافقة.

      1. اختَر نوع المستخدم وانقر على إنشاء.

      2. املأ النموذج الأولي. يمكنك تعديل هذه المعلومات لاحقًا إذا لزم الأمر. انقر على حفظ عند الانتهاء.

    2. انتقِل مجددًا إلى بيانات الاعتماد > إنشاء بيانات الاعتماد > معرّف عميل OAuth للمتابعة.

  3. اختَر تطبيق سطح المكتب أو تطبيق الويب كنوع التطبيق، بناءً على حالة الاستخدام.

  4. أدخِل اسمًا له، ثم انقر على إنشاء.

  5. إذا كان نوع العميل هو تطبيق ويب، أضِف عنوان URL واحدًا على الأقل مصرّحًا به لإعادة التوجيه.

    لإجراء اختبار محلي متوافق مع الإعدادات التلقائية في أمثلة مكتبة العملاء، يمكنك استخدام http://127.0.0.1.

    بالنسبة إلى برامج تطبيق سطح المكتب، سيظل بإمكانك استخدام إعادة توجيه عنوان IP للتكرار، ولكن لا يتم ضبط معرّف الموارد المنتظم (URI) بشكل صريح في Cloud Console.

  6. في صفحة التأكيد، انسخ معرّف العميل وسر العميل إلى الحافظة، حيث ستحتاج إليهما عند إعداد مكتبة البرامج. يمكنك أيضًا الرجوع إلى صفحة بيانات الاعتماد لاحقًا لاسترداد هذه التفاصيل.