محولات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح واجهة برمجة تطبيقات AdMob إدراج
محوِّلات التوسّط
بشكل آلي. يُرجى الاطّلاع على
accounts.adSources.adapters.list
لمزيد من المعلومات. تتضمّن المحوِّلات تفاصيل عن إعدادات
المحوِّلات التابعة لجهات خارجية.
أمثلة
بعد إنشاء بيانات اعتماد OAuth 2.0،
يمكنك البدء في استخدام AdMob API. لطلب الوصول باستخدام بروتوكول OAuth 2.0، يحتاج
تطبيقك أيضًا إلى معلومات النطاق.
في ما يلي معلومات عن نطاق OAuth 2.0:
| النطاق |
المعنى |
https://www.googleapis.com/auth/admob.monetization |
الاطّلاع على إعدادات تحقيق الربح في AdMob وإنشاؤها وتعديلها
|
https://www.googleapis.com/auth/admob.readonly |
الاطّلاع على جميع بيانات AdMob وقد يشمل ذلك معلومات حسابك
وإعدادات المستودع والتوسّط والتقارير والبيانات الأخرى.
ولا يتضمّن ذلك البيانات الحسّاسة، مثل الدفعات أو تفاصيل الحملة.
|
curl (سطر الأوامر)
الطلبات التي تستخدم curl
حمِّل ملف أسرار العميل وأنشئ بيانات اعتماد
التفويض.
عند تنفيذ هذه الخطوة لأول مرة، سيُطلب منك قبول
طلب تفويض في المتصفّح. قبل الموافقة، تأكَّد من تسجيلك
باستخدام حساب Google يمكنه الوصول إلى AdMob API. سيتم تفويض
تطبيقك بالوصول إلى البيانات نيابةً عن الحساب الذي
تم تسجيل الدخول إليه حاليًا.
للمصادقة والتفويض، ننصحك باستخدام
oauth2l، وهي أداة سطر أوامر بسيطة ل
العمل مع Google OAuth 2.0. ثبِّت oauth2l وشغِّل العبارة التالية، مع استبدال path_to_credentials_json بمسار يؤدي إلى ملف credentials.json نزّلته عند تسجيل تطبيقك على السحابة الإلكترونية. في المرة الأولى التي يتم فيها تشغيل الأمر، سيرشدك إلى خطوات
مسار تفويض OAuth 2.0. تؤدي عمليات التشغيل اللاحقة إلى تحديث الرمز المميّز
تلقائيًا.
oauth2l header --json path_to_credentials_json --scope admob.readonly
أدرِج المحوِّلات.
يمكنك الحصول على معلومات محوِّل AdMob من خلال استبدال pub-XXXXXXXXXXXXXXXX
بالرقم التعريفي للناشر. اطّلِع على كيفية العثور على الرقم التعريفي للناشر.
استبدِل SSSSSSSSSSSSSSSSSSSS بمعرّف مصدر الإعلانات ل
المحوِّلات التي تهمّك.
استخدِم الأمر التالي للحصول على قائمة بالمحوِّلات:
curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
-H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"
نموذج استجابة لمصدر إعلان "شبكة AdMob" الذي يحمل رقم التعريف
5450213213286189855:
{
"adapters": [
{
"name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
"adapterId": "1",
"title": "AdMob Network Android SDK",
"platform": "ANDROID",
"formats": ["BANNER", "INTERSTITIAL",
"REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
"adapterConfigMetadata": [{
"adapterConfigMetadataId": "118",
"adapterConfigMetadataLabel": "Ad unit ID"
}]
},
{
"name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
"adapterId": "2",
"title": "AdMob Network iOS SDK",
"platform": "ANDROID",
"formats": ["BANNER", "INTERSTITIAL",
"REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
"adapterConfigMetadata": [{
"adapterConfigMetadataId": "119",
"adapterConfigMetadataLabel": "Ad unit ID"
}]
}]
}
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThe AdMob API allows programmatic listing of mediation adapters, including details on third-party configurations.\u003c/p\u003e\n"],["\u003cp\u003eTo use the AdMob API, OAuth 2.0 credentials with appropriate scope information (\u003ccode\u003eadmob.monetization\u003c/code\u003e or \u003ccode\u003eadmob.readonly\u003c/code\u003e) are required.\u003c/p\u003e\n"],["\u003cp\u003eYou can utilize \u003ccode\u003ecurl\u003c/code\u003e with OAuth 2.0 authentication to retrieve a list of adapters for a specific AdMob ad source.\u003c/p\u003e\n"],["\u003cp\u003eThe response provides details like adapter name, ID, platform, supported ad formats, and configuration metadata.\u003c/p\u003e\n"]]],["The AdMob API allows programmatic listing of mediation adapters, including third-party configurations. Access requires OAuth 2.0 credentials and specific scopes like `admob.monetization` or `admob.readonly`. To use it with curl, users must first load client secrets and generate authorization credentials, potentially via `oauth2l`. Listing adapters requires the publisher ID and ad source ID in the API request, and will return the adapter information that includes details such as ID, Title, platform, and formats.\n"],null,["# Adapters\n\nThe AdMob API has the ability to list\n[mediation adapters](/admob/api/v1/adapters-reference)\nprogrammatically, see\n[`accounts.adSources.adapters.list`](/admob/api/reference/rest/v1beta/accounts.adSources.adapters/list)\nfor additional information. Adapters include details on third-party adapter\nconfigurations.\n\nExamples\n--------\n\nWith [OAuth 2.0 credentials created](/admob/api/v1/getting-started#credentials),\nyou're ready to start using the AdMob API. To request access using OAuth 2.0,\nyour application will also need the scope information.\n\nHere's the OAuth 2.0 scope information:\n\n\u003cbr /\u003e\n\n| Scope | Meaning |\n|------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/admob.monetization` | See, create, and edit your AdMob monetization settings. |\n| `https://www.googleapis.com/auth/admob.readonly` | See all AdMob data. This may include account information, inventory and mediation settings, reports, and other data. This doesn't include sensitive data, such as payments or campaign details. |\n\n\u003cbr /\u003e\n\n### curl (command line)\n\n### Requests using curl\n\n1. Load the [client secrets file](https://console.cloud.google.com/apis/credentials) and generate authorization\n credentials.\n\n The first time you perform this step you'll be asked to accept an\n authorization prompt in your browser. Before accepting, make sure you're\n signed in with a Google Account that has access to the AdMob API. Your\n app will be authorized to access data on behalf of whichever account is\n currently signed in.\n\n For authentication and authorization, we recommend using\n [oauth2l](//github.com/google/oauth2l), a simple command-line tool for\n working with Google OAuth 2.0. Install oauth2l and run the\n command below, replacing \u003cvar translate=\"no\"\u003epath_to_credentials_json\u003c/var\u003e with a path\n to a `credentials.json` file that you download when registering your\n cloud application. For the first run, the command walks you through the\n OAuth 2.0 authorization flow. Subsequent runs refresh the token\n automatically. \n\n ```\n oauth2l header --json path_to_credentials_json --scope admob.readonly\n ```\n2. List the adapters.\n\n Get AdMob adapter information by replacing \u003cvar translate=\"no\"\u003epub-XXXXXXXXXXXXXXXX\u003c/var\u003e\n with your publisher ID, see\n [how to find your publisher ID](//support.google.com/admob/answer/2784578).\n\n Replace \u003cvar translate=\"no\"\u003eSSSSSSSSSSSSSSSSSSSS\u003c/var\u003e with the ad source ID for the\n adapters of interest.\n\n Use the following command to get a list of adapters: \n\n ```\n curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \\\n -H \"$(oauth2l header --json path_to_credentials_json --scope admob.readonly)\"\n ```\n\n Sample response for the AdMob Network ad source with ID\n `5450213213286189855`: \n\n ```scdoc\n {\n \"adapters\": [\n {\n \"name\": \"accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1\",\n \"adapterId\": \"1\",\n \"title\": \"AdMob Network Android SDK\",\n \"platform\": \"ANDROID\",\n \"formats\": [\"BANNER\", \"INTERSTITIAL\",\n \"REWARDED\", \"NATIVE\", \"REWARDED_INTERSTITIAL\", \"APP_OPEN\"],\n \"adapterConfigMetadata\": [{\n \"adapterConfigMetadataId\": \"118\",\n \"adapterConfigMetadataLabel\": \"Ad unit ID\"\n }]\n },\n {\n \"name\": \"accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2\",\n \"adapterId\": \"2\",\n \"title\": \"AdMob Network iOS SDK\",\n \"platform\": \"ANDROID\",\n \"formats\": [\"BANNER\", \"INTERSTITIAL\",\n \"REWARDED\", \"NATIVE\", \"REWARDED_INTERSTITIAL\", \"APP_OPEN\"],\n \"adapterConfigMetadata\": [{\n \"adapterConfigMetadataId\": \"119\",\n \"adapterConfigMetadataLabel\": \"Ad unit ID\"\n }]\n }]\n }\n ```"]]
