إعداد مشروع Google Play Console لواجهة برمجة التطبيقات مع "إعلانات Google"

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

شاهِد هذا الفيديو للاطّلاع على بعض أفضل الممارسات في مشروع Cloud.

إثبات ملكية Google OAuth

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

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

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

ونوصي كل التطبيقات بإجراء عملية إثبات الملكية في Google OAuth في أقرب وقت ممكن لتجنُّب أي انقطاع في النشاط التجاري.

إنشاء مشروع

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

نقطة رئيسية: في حال تفعيل الفوترة - على Google Cloud بدلاً من ذلك - عليك اختيار حساب فوترة للمشروع الجديد.

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

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

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

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

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

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

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

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

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

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

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

• ويقتصر السماح على 100 مستخدم فقط.

ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

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

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

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

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

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

     https://www.googleapis.com/auth/adwords
     

   • انقر على إضافة إلى الجدول.

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

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

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

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

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

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

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

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

نقطة رئيسية: لا يزال بإمكانك اختيار مسار تطبيق سطح المكتب حتى إذا كنت تطور تطبيقًا لتشغيله على خادم. ويتمثل الاختلاف في ما إذا كان تفويض OAuth قد تم إكماله محليًا أو عن بُعد. يتطلّب مسار الوصول إلى الكمبيوتر المكتبي أن يتم إكمال المصادقة على الجهاز المحلي، في حين تسمح خطوات الويب بإكمال التفويض على خادم تفويض Google.

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

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

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

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

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

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

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

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

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

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

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

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

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

   ملاحظة: يمكنك إضافة رقم منفذ إلى معرّف الموارد المنتظم (URI) لإعادة التوجيه لتقييد الاستخدام إلى منفذ معيّن. في حال عدم ضبط المنفذ، يمكن لعميل OAuth إعادة التوجيه إلى أي منفذ.

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

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