بدء استخدام واجهة برمجة تطبيقات AdMob

ملاحظة مهمة: ستؤثّر أدوار المستخدِمِين وأذوناتهم الجديدة في البيانات التي تعرضها واجهة برمجة تطبيقات AdMob. مزيد من المعلومات

هذا الدليل مخصَّص للمطوّرين الذين يريدون استخدام واجهة برمجة تطبيقات AdMob للحصول على معلومات آليًا عن حساباتهم على AdMob.

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

يُرجى تنفيذ الخطوات التالية لإنشاء بيانات اعتماد OAuth2 وإجراء طلبك الأول.

المتطلبات الأساسية

• حساب على Google:

• حساب على Google AdMob.

• الاعتياد على أساسيات RST والسماح بالطلبات باستخدام OAuth 2.0.

تحديد نوع المصادقة

راجِع الجدول التالي لمعرفة نوع المصادقة الأنسب لتطبيقك:

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

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

إنشاء مشروع

لبدء استخدام واجهة برمجة تطبيقات AdMob، يجب أولاً إنشاء أو اختيار مشروع في وحدة تحكم واجهة برمجة تطبيقات Google وتفعيل واجهة برمجة التطبيقات باستخدام أداة الإعداد، التي سترشدك خلال العملية وتفعِّل واجهة برمجة تطبيقات AdMob تلقائيًا.

تمكين واجهة برمجة التطبيقات لمشروع حالي

تنطبق الخطوات التالية على المستخدمين الذين لديهم مشروع حالي ويفضّلون تفعيل واجهة برمجة تطبيقات AdMob له يدويًا.

为您的项目启用API：

1. Open the API Library中的Google API Console 。
2. If prompted, select a project, or create a new one. API Library列出了所有可用的API，并按产品家族和受欢迎程度分组。
3. 如果您要启用的API在列表中不可见，请使用搜索找到它，或单击其所属产品系列中的“ 查看全部 ”。
4. 选择要启用的API，然后单击“ 启用”按钮。
5. If prompted, enable billing.
6. If prompted, read and accept the API's Terms of Service.

إنشاء بيانات اعتماد OAuth2

ترشدك التعليمات التالية خلال عملية إنشاء معرِّف عميل OAuth 2.0 لاستخدامه مع مسار التطبيقات المثبَّتة.

1. Go to the Credentials page.

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

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

   1. اضبط نوع المستخدم على خارجي وحالة النشر على تم النشر.

   2. أو اضبط نوع المستخدم على خارجي وحالة النشر على اختبار، ثم أضِف مستخدمي الاختبار من خلال اختيار إضافة مستخدمين لمنحهم الإذن بالوصول لاستخدام معرّف عميل OAuth 2.0.

      يمكنك الاطّلاع على معلومات إضافية حول إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth.

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

عند الانتهاء، يظهر لك معرِّف عميل OAuth 2.0 وسر عميل يمكنك تنزيله بتنسيق JSON وحفظه لاستخدامه لاحقًا.

تقديم طلب

تم إنشاء واجهة برمجة تطبيقات AdMob استنادًا إلى HTTP وJSON، ما يتيح لأي برنامج HTTP عادي إرسال طلبات إلى الواجهة وتحليل استجاباتها. ومع ذلك، فإن مكتبات برامج واجهة Google API توفر تكاملاً لغويًا أفضل، وأمانًا محسَّنًا، ودعمًا لإجراء الطلبات المصرّح بها. تتوفر مكتبات البرامج بعدة لغات برمجة. ويغنيك استخدام هذه المكتبات عن إعداد طلبات HTTP وتحليل الاستجابات يدويًا.

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

مع إنشاء بيانات اعتماد OAuth 2.0، تكون جاهزًا لبدء استخدام واجهة برمجة تطبيقات AdMob. لطلب الوصول باستخدام بروتوكول OAuth 2.0، يحتاج تطبيقك أيضًا إلى معلومات النطاق:

النطاق	المعنى
https://www.googleapis.com/auth/admob.readonly	الاطّلاع على جميع بيانات AdMob. وقد يشمل ذلك معلومات الحساب وإعدادات المستودع والتوسّط والتقارير والبيانات الأخرى. ولا يتضمّن ذلك البيانات الحسّاسة، مثل الدفعات أو تفاصيل الحملة.
https://www.googleapis.com/auth/admob.report	يمكنك الاطّلاع على تقارير أداء الإعلانات والأرباح. اطّلِع على الرقم التعريفي للناشر والمنطقة الزمنية ورمز العملة التلقائي.

قدِّم طلبك الأول لإنشاء تقرير باستخدام أمثلة في Java أو PHP أو Python أو curl.

إبطال الرموز المميّزة المشتركة

يمكنك إبطال الرموز المميّزة المشتركة بطريقتَين:

1. انتقِل إلى صفحة أذونات حساب Google وأبطل الوصول من المشروع ذي الصلة.

2. يمكنك بدلاً من ذلك إبطال الرموز المميّزة لتطبيقات الويب باستخدام Google Identity API.