Method: accounts.apps.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
برنامه‌ها را در حساب AdMob مشخص شده فهرست کنید.
درخواست HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/apps
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. نام منبع حساب برای فهرست کردن برنامه‌ها. مثال: accounts/pub-9876543210987654 |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer حداکثر تعداد برنامه برای بازگشت. اگر نامشخص یا 0 باشد، حداکثر 10000 برنامه برگردانده می شود. حداکثر مقدار 20000 است. مقادیر بالای 20000 به 20000 اجباری می شود. |
pageToken | string مقدار بازگشتی توسط آخرین ListAppsResponse . نشان می دهد که این ادامه تماس قبلی apps.list است و سیستم باید صفحه بعدی داده ها را برگرداند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ به درخواست لیست برنامه ها.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"apps": [
{
object (App)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
apps[] | object ( App ) برنامه های به دست آمده برای حساب درخواستی. |
nextPageToken | string اگر خالی نباشد، نشان می دهد که ممکن است برنامه های بیشتری برای درخواست وجود داشته باشد. این مقدار باید در یک ListAppsRequest جدید ارسال شود. |
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/admob.monetization -
https://www.googleapis.com/auth/admob.readonly
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLists all the apps associated with a specific AdMob account using an HTTP GET request.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to retrieve large numbers of apps with \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes an array of apps and a token for retrieving the next page, if available.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization: \u003ccode\u003ehttps://www.googleapis.com/auth/admob.monetization\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/admob.readonly\u003c/code\u003e.\u003c/p\u003e\n"]]],["This API call lists apps under a specified AdMob account. It uses a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*}/apps`. The `parent` path parameter (e.g., `accounts/pub-9876543210987654`) is required. Optional query parameters `pageSize` (max 20,000) and `pageToken` are used for pagination. The request body is empty. The response includes a list of apps and an optional `nextPageToken` for subsequent requests and requires specific authorization scopes.\n"],null,["# Method: accounts.apps.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.ListAppsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the apps under the specified AdMob account.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/apps`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|----------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. Resource name of the account to list apps for. Example: accounts/pub-9876543210987654 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of apps to return. If unspecified or 0, at most 10,000 apps will be returned. The maximum value is 20,000; values above 20,000 will be coerced to 20,000. |\n| `pageToken` | `string` The value returned by the last `ListAppsResponse`; indicates that this is a continuation of a prior `apps.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 apps list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------|\n| ``` { \"apps\": [ { object (/admob/api/reference/rest/v1beta/accounts.apps#App) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| `apps[]` | `object (`[App](/admob/api/reference/rest/v1beta/accounts.apps#App)`)` The resulting apps for the requested account. |\n| `nextPageToken` | `string` If not empty, indicates that there may be more apps for the request; this value should be passed in a new `ListAppsRequest`. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admob.monetization`\n- `\n https://www.googleapis.com/auth/admob.readonly`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
