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

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

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

التحقّق من OAuth في Google

يجب أن يخضع أي تطبيق على 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، ولكن هناك حصة على إجمالي عدد مشاريع Cloud. بدلاً من ذلك، يمكنك الاشتراك للحصول على حساب Google جديد يتضمّن حصة مجانية من المشاريع.

تفعيل 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 المرتبطة بالمشروع. تنتهي صلاحية التفويضات بعد سبعة أيام من وقت الموافقة.
المصادر الخارجية	الاختبار	متاحة لجميع المشاريع يقتصر على ما يصل إلى 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 لرد الاتصال، وهي غير متاحة في مسار تطبيق سطح المكتب.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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