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

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

مشاهدة هذا الفيديو للتعرّف على بعض أفضل الممارسات المتعلّقة بالمشاريع على السحابة الإلكترونية

إثبات الهوية من خلال بروتوكول Google OAuth

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

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

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

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

إنشاء مشروع

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

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

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

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

  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 إلى ما يلي، بغض النظر عن نوع المستخدم أو حالة النشر لمشروعك:

  • أثناء عملية التفويض، يتم عرض شاشة واجهة مستخدم للمستخدمين لم يتم التحقّق منها.

  • مسموح لك بتفويض 100 مستخدم فقط.

  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. إذا كان نوع العميل هو تطبيق ويب، أضِف معرّف موارد منتظمًا (URI) واحد على الأقل معتمد لإعادة التوجيه.

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

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

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