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

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

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

التحقّق من Google OAuth

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

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

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

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

إنشاء مشروع

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

نقطة رئيسية: إذا كانت الفوترة مفعَّلة، لـ Google Cloud في مثال - حينئذٍ يجب عليك تحديد حساب فوترة للمشروع الجديد.

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

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

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

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

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

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

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

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

نوع المستخدم	حالة النشر	القيود
داخلي	الاختبار	هذه الميزة متاحة فقط للمشاريع المرتبطة بخدمة Google Cloud. التنظيم: الحد الأقصى لعدد المستخدمين التجريبيين المُدرَجين في موافقة OAuth هو 100 مستخدم كحد أقصى. الشاشة. يجب أن يكون مستخدمو الاختبار هم مستخدمون داخليون في Google Cloud. المؤسسة المرتبطة بالمشروع. تنتهي صلاحية التفويضات بعد سبعة أيام من وقت الموافقة.
المصادر الخارجية	الاختبار	متاحة لجميع المشاريع الحد الأقصى لعدد المستخدمين التجريبيين المُدرَجين في موافقة OAuth هو 100 مستخدم كحد أقصى. الشاشة. يمكن أن يكون المستخدمون التجريبيون أي مستخدم لديه حساب 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 Console.

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