Method: accounts.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://admob.googleapis.com/v1/accounts
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
معامِلات طلب البحث
| المعلمات |
pageSize |
integer
الحدّ الأقصى لعدد الحسابات المطلوب عرضها.
|
pageToken |
string
القيمة التي تعرضها آخر ListPublisherAccountsResponse؛ إلى أنّ هذه الإضافة هي استمرار لاستدعاء accounts.list سابق، وأنّ النظام يجب أن يعرض الصفحة التالية من البيانات.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ على طلب قائمة حسابات الناشرين
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"account": [
{
object (PublisherAccount)
}
],
"nextPageToken": string
} |
| الحقول |
account[] |
object (PublisherAccount)
ناشر يمكن لبيانات اعتماد العميل الوصول إليه.
|
nextPageToken |
string
إذا لم يكن فارغًا، يشير ذلك إلى أنّه قد يكون هناك المزيد من الحسابات للطلب. عليك تمرير هذه القيمة في ListPublisherAccountsRequest جديد.
|
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/admob.readonly
https://www.googleapis.com/auth/admob.report
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eLists the most recently signed-in AdMob publisher account and provides pagination for accessing more accounts.\u003c/p\u003e\n"],["\u003cp\u003eRequest an account list with optional parameters to specify the maximum number of accounts and page tokens for continuation.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of publisher accounts and a token for retrieving the next page if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for read-only or report access to AdMob data.\u003c/p\u003e\n"]]],["This document details how to retrieve a list of AdMob publisher accounts. Use a `GET` request to `https://admob.googleapis.com/v1/accounts`. The request body should be empty. Optional `pageSize` and `pageToken` query parameters control the number of accounts returned and pagination. The response body includes an array of account objects and an optional `nextPageToken` for further data retrieval. Access requires specific OAuth scopes: `admob.readonly` or `admob.report`.\n"],null,["# Method: accounts.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListPublisherAccountsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nLists the AdMob publisher account that was most recently signed in to from the AdMob UI. For more information, see \u003chttps://support.google.com/admob/answer/10243672\u003e.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1/accounts`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` Maximum number of accounts to return. |\n| `pageToken` | `string` The value returned by the last `ListPublisherAccountsResponse`; indicates that this is a continuation of a prior `accounts.list` call, and that the system should return the next page of data. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the publisher account list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"account\": [ { object (/admob/api/reference/rest/v1/accounts#PublisherAccount) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `account[]` | `object (`[PublisherAccount](/admob/api/reference/rest/v1/accounts#PublisherAccount)`)` Publisher that the client credentials can access. |\n| `nextPageToken` | `string` If not empty, indicates that there might be more accounts for the request; you must pass this value in a new `ListPublisherAccountsRequest`. |\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)."]]
