Wymagane. Element nadrzędny, do którego należy zbiór mapowań jednostek reklamowych. Format: accounts/{publisherId}/adUnits/{adUnitId}
Parametry zapytania
Parametry
pageSize
integer
Maksymalna liczba mapowań jednostek reklamowych do zwrócenia. Jeśli wartość jest nieokreślona lub ma wartość 0, zwróconych zostanie maksymalnie 10 000 mapowań jednostek reklamowych. Maksymalna wartość to 20 000. wartości powyżej 20 000 zostaną zmienione na 20 000.
pageToken
string
Token strony otrzymany z poprzedniego wywołania funkcji adUnitMappings.list. Podaj go, aby pobrać kolejną stronę.
filter
string
Ciąg tekstowy filtra wykorzystujący składnię gramatyki EBNF. Możliwe pole, według którego można filtrować, to:
„DISPLAY_NAME”
Możliwa funkcja filtra to:
IN: służy do filtrowania pól, które reprezentują singleton, w tym „DISPLAY_NAME”.
Funkcje filtra można dodać do siebie za pomocą funkcji AND. Funkcja OR nie jest obsługiwana.
Przykład:
filtr: IN(DISPLAY_NAME, "Testowe mapowanie jednostki reklamowej 1", "Testowe mapowanie jednostki reklamowej 2")
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na żądanie ListAdUnitMappingsRequest.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Mapowanie jednostek reklamowych z określonego konta i jednostki reklamowej.
nextPageToken
string
Służy do ustawiania elementu pageToken w elemencie ListAdUnitMappingsRequest w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.
[null,null,["Ostatnia aktualizacja: 2025-08-21 UTC."],[[["\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)."]]
