Obbligatorio. L'elemento principale proprietario di questa raccolta di mappature delle unità pubblicitarie. Formato: accounts/{publisherId}/adUnits/{adUnitId}
Parametri di query
Parametri
pageSize
integer
Il numero massimo di mappature delle unità pubblicitarie da restituire. Se il valore non è specificato o se il valore è 0, verranno restituite al massimo 10.000 mappature delle unità pubblicitarie. Il valore massimo è 20.000. valori superiori a 20.000 verranno costretti a 20.000.
pageToken
string
Un token di pagina, ricevuto da una precedente chiamata a adUnitMappings.list. Forniscilo per recuperare la pagina successiva.
filter
string
La stringa del filtro che utilizza la sintassi grammaticale EBNF. Il campo in base al quale può essere applicato il filtro è:
"DISPLAY_NAME"
La funzione di filtro possibile è:
IN: utilizzato per filtrare i campi che rappresentano un singleton, tra cui "DISPLAY_NAME".
Le funzioni di filtro possono essere sommate utilizzando AND. La funzionalità di OR non è supportata.
Esempio:
filtro: IN(DISPLAY_NAME, "Mappatura delle unità pubblicitarie di prova 1", "Mappatura delle unità pubblicitarie di prova 2")
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta per ListAdUnitMappingsRequest.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Le mappature delle unità pubblicitarie dell'account e dell'unità pubblicitaria specificati.
nextPageToken
string
Utilizzato per impostare pageToken in ListAdUnitMappingsRequest al fine di recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
[null,null,["Ultimo aggiornamento 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)."]]
