مورد نیاز. والدی که این مجموعه نگاشت واحد تبلیغات را در اختیار دارد. قالب: حساب‌ها/{publisherId}/adUnits/{adUnitId}
پارامترهای پرس و جو
پارامترها
pageSize
integer
حداکثر تعداد نگاشت واحد تبلیغات برای بازگشت. اگر نامشخص یا 0 باشد، حداکثر 10000 نگاشت واحد تبلیغاتی برگردانده می شود. حداکثر مقدار 20000 است. مقادیر بالای 20000 به 20000 اجباری می شود.
pageToken
string
یک نشانه صفحه، دریافت شده از تماس قبلی adUnitMappings.list . این را برای بازیابی صفحه بعدی ارائه کنید.
filter
string
رشته فیلتری که از نحو دستور زبان EBNF استفاده می کند. فیلد ممکن برای فیلتر کردن بر اساس این است:
"DISPLAY_NAME"
عملکرد فیلتر ممکن است:
IN : برای فیلتر کردن فیلدهایی استفاده می‌شود که نشان‌دهنده یک صدا از جمله «DISPLAY_NAME» هستند.
توابع فیلتر را می توان با استفاده از AND با هم اضافه کرد. عملکرد OR پشتیبانی نمی شود.
مثال:
فیلتر: IN(DISPLAY_NAME، «نقشه برداری واحد آگهی آزمایشی 1»، «نقشه برداری واحد آگهی آزمایشی 2»)
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
پاسخ برای ListAdUnitMappingsRequest.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-21 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLists ad unit mappings associated with a specific AdMob account and ad unit, allowing retrieval of mapping details.\u003c/p\u003e\n"],["\u003cp\u003eEnables filtering and pagination for managing large sets of ad unit mappings using query parameters like \u003ccode\u003epageSize\u003c/code\u003e, \u003ccode\u003epageToken\u003c/code\u003e, and \u003ccode\u003efilter\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes (\u003ccode\u003eadmob.monetization\u003c/code\u003e or \u003ccode\u003eadmob.readonly\u003c/code\u003e) for access, with potential limitations requiring account manager intervention.\u003c/p\u003e\n"],["\u003cp\u003eReturns a response containing an array of ad unit mappings and a token for navigating to the next page of results, if available.\u003c/p\u003e\n"],["\u003cp\u003eProvides an HTTP request structure with path and query parameters for interacting with the API endpoint.\u003c/p\u003e\n"]]],["This API lists ad unit mappings under a specified AdMob account and ad unit using a `GET` request to a specific URL. The `parent` path parameter is mandatory, defining the account and ad unit. Optional query parameters `pageSize`, `pageToken`, and `filter` allow for result pagination and filtering. The request body must be empty, while the response includes an array of `adUnitMappings` and an optional `nextPageToken` for pagination. Access requires specific OAuth scopes, potentially needing account manager assistance.\n"],null,["# Method: accounts.adUnits.adUnitMappings.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.ListAdUnitMappingsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList ad unit mappings under the specified AdMob account and ad unit.\n\n\u003cbr /\u003e\n\n| This method has limited access. If you see a 403 permission denied error, please reach out to your account manager for access.\n\n\u003cbr /\u003e\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adUnits/*}/adUnitMappings`\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 unit mappings. Format: accounts/{publisherId}/adUnits/{adUnitId} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of ad unit mappings to return. If unspecified or 0, at most 10,000 ad unit mappings will be returned. The maximum value is 20,000; values above 20,000 will be coerced to 20,000. |\n| `pageToken` | `string` A page token, received from a previous `adUnitMappings.list` call. Provide this to retrieve the subsequent page. |\n| `filter` | `string` The filter string that uses [EBNF grammar syntax](https://google.aip.dev/assets/misc/ebnf-filtering.txt). Possible field to filter by is: - \"DISPLAY_NAME\" Possible filter function is: - `IN`: Used to filter fields that represent a singleton including \"DISPLAY_NAME\". The filter functions can be added together using `AND`. `OR` functionality is not supported. Example: filter: IN(DISPLAY_NAME, \"Test Ad Unit Mapping 1\", \"Test Ad Unit Mapping 2\") |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the ListAdUnitMappingsRequest.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"adUnitMappings\": [ { object (/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings#AdUnitMapping) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|--------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `adUnitMappings[]` | `object (`[AdUnitMapping](/admob/api/reference/rest/v1beta/accounts.adUnits.adUnitMappings#AdUnitMapping)`)` The ad unit mappings from the specified account and ad unit. |\n| `nextPageToken` | `string` Used to set the `pageToken` in the `ListAdUnitMappingsRequest` 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.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)."]]
