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

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

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

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

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

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

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

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