Method: accounts.adUnits.list
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
واحدهای تبلیغاتی را در حساب AdMob مشخص شده فهرست کنید.
درخواست HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
parent | string مورد نیاز. نام منبع حساب برای فهرست کردن واحدهای تبلیغاتی. مثال: accounts/pub-9876543210987654 |
پارامترهای پرس و جو
| پارامترها |
|---|
pageSize | integer حداکثر تعداد واحدهای تبلیغاتی برای بازگشت. اگر نامشخص یا 0 باشد، حداکثر 10000 واحد تبلیغاتی برگردانده می شود. حداکثر مقدار 20000 است. مقادیر بالای 20000 به 20000 اجباری می شود. |
pageToken | string مقدار بازگشتی توسط آخرین ListAdUnitsResponse ; نشان می دهد که این ادامه تماس قبلی adUnits.list است و سیستم باید صفحه بعدی داده را برگرداند. |
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ به درخواست لیست واحدهای تبلیغاتی.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
| نمایندگی JSON |
|---|
{
"adUnits": [
{
object (AdUnit)
}
],
"nextPageToken": string
} |
| فیلدها |
|---|
adUnits[] | object ( AdUnit ) واحدهای تبلیغاتی به دست آمده برای حساب درخواستی. |
nextPageToken | string اگر خالی نباشد، نشان می دهد که ممکن است واحدهای تبلیغاتی بیشتری برای درخواست وجود داشته باشد. این مقدار باید در یک ListAdUnitsRequest جدید ارسال شود. |
محدوده مجوز
به یکی از حوزه های 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\u003eThis page explains how to list ad units associated with a specific AdMob account using the \u003ccode\u003eadUnits.list\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eThe method requires the \u003ccode\u003eparent\u003c/code\u003e path parameter to specify the AdMob account and accepts optional \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e query parameters for pagination.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses provide a list of \u003ccode\u003eAdUnits\u003c/code\u003e and a \u003ccode\u003enextPageToken\u003c/code\u003e for retrieving additional pages if available.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required using either \u003ccode\u003ehttps://www.googleapis.com/auth/admob.monetization\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/admob.readonly\u003c/code\u003e OAuth scopes.\u003c/p\u003e\n"]]],["This document details how to list ad units associated with a specific AdMob account. The process involves sending a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits`, where `parent` is the account's resource name. Optional query parameters, `pageSize` (up to 20,000) and `pageToken` (for pagination), can be included. The request body must be empty. The response includes an array of `adUnits` and a `nextPageToken` for further results. Authorization requires specific OAuth scopes.\n"],null,["# Method: accounts.adUnits.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.ListAdUnitsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the ad units under the specified AdMob account.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits`\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 ad units for. Example: accounts/pub-9876543210987654 |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of ad units to return. If unspecified or 0, at most 10,000 ad units 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 `ListAdUnitsResponse`; indicates that this is a continuation of a prior `adUnits.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 ad units list request.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"adUnits\": [ { object (/admob/api/reference/rest/v1beta/accounts.adUnits#AdUnit) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------|\n| `adUnits[]` | `object (`[AdUnit](/admob/api/reference/rest/v1beta/accounts.adUnits#AdUnit)`)` The resulting ad units for the requested account. |\n| `nextPageToken` | `string` If not empty, indicates that there may be more ad units for the request; this value should be passed in a new `ListAdUnitsRequest`. |\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)."]]
