Method: accounts.adSources.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
مطلوب. المؤسسة الرئيسية التي تملك هذه المجموعة من مصادر الإعلانات. التنسيق: accounts/{publisherId}
|
معامِلات طلب البحث
المعلمات |
pageSize |
integer
الحدّ الأقصى لعدد مصادر الإعلانات المطلوب عرضها. وفي حال عدم تحديد قيمة أو 0، سيتم عرض 10,000 مصدر إعلان كحدّ أقصى. الحد الأقصى للقيمة هو 20000؛ سيتم فرض القيم الأكبر من 10000 على 20000.
|
pageToken |
string
رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق لتطبيق "adSources.list ". يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
الاستجابة لـ ListAdSourcesRequest.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"adSources": [
{
object (AdSource )
}
],
"nextPageToken": string
} |
الحقول |
adSources[] |
object (AdSource )
مصادر الإعلانات.
|
nextPageToken |
string
يُستخدَم لضبط pageToken في ListAdSourcesRequest لاسترداد الصفحة التالية. في حال إسقاط هذا الحقل، لن تظهر أي صفحات لاحقة.
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/admob.readonly
https://www.googleapis.com/auth/admob.report
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
AdSource
تمثيل JSON |
{
"name": string,
"adSourceId": string,
"title": string
} |
الحقول |
name |
string
اسم المورد لمصدر الإعلان هذا. التنسيق هو: accounts/{publisherId}/adSources/{adSourceId}
|
adSourceId |
string
رقم تعريف مصدر الإعلان هذا.
|
title |
string
الاسم المعروض لمصدر الإعلان هذا.
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eRetrieves a list of ad sources associated with a specific AdMob account.\u003c/p\u003e\n"],["\u003cp\u003eAllows pagination to retrieve large lists of ad sources using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach ad source is identified by a unique \u003ccode\u003eadSourceId\u003c/code\u003e and has a display \u003ccode\u003etitle\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"]]],["This document details how to list ad sources using the AdMob API. To retrieve ad sources, send a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources`, specifying the account ID in the `parent` path parameter. Optional query parameters include `pageSize` (maximum ad sources returned) and `pageToken` (for pagination). The request body must be empty. The response includes a list of `adSources` with their `name`, `adSourceId`, and `title` and a `nextPageToken` for further pages.\n"],null,["# Method: accounts.adSources.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListAdSourcesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AdSource](#AdSource)\n - [JSON representation](#AdSource.SCHEMA_REPRESENTATION)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the ad sources.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent which owns this collection of ad sources. Format: accounts/{publisherId} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of ad sources to return. If unspecified or 0, at most 10,000 ad sources will be returned. The maximum value is 20,000; values above 10,000 will be coerced to 20,000. |\n| `pageToken` | `string` A page token, received from a previous `adSources.list` call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the ListAdSourcesRequest.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"adSources\": [ { object (/admob/api/reference/rest/v1beta/accounts.adSources/list#AdSource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `adSources[]` | `object (`[AdSource](/admob/api/reference/rest/v1beta/accounts.adSources/list#AdSource)`)` The ad sources. |\n| `nextPageToken` | `string` Used to set the `pageToken` in the `ListAdSourcesRequest` to retrieve the next page. If this field is omitted, there are no subsequent pages. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admob.readonly`\n- `\n https://www.googleapis.com/auth/admob.report`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nAdSource\n--------\n\nDefinition of a mediation ad source.\n\n| JSON representation |\n|-------------------------------------------------------------------|\n| ``` { \"name\": string, \"adSourceId\": string, \"title\": string } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of this ad source. Format is: accounts/{publisherId}/adSources/{adSourceId} |\n| `adSourceId` | `string` ID of this ad source. |\n| `title` | `string` Display name of this ad source. |"]]