חובה. ההורה שהוא הבעלים של אוסף המיפויים של יחידות המודעות הזה. פורמט: accounts/{publisherId}/adUnits/{adUnitId}
פרמטרים של שאילתה
פרמטרים
pageSize
integer
המספר המקסימלי של מיפויים של יחידות מודעות שצריך להחזיר. אם לא צוין 0, יוחזרו 10,000 מיפויים של יחידות מודעות לכל היותר. הערך המקסימלי הוא 20,000; ערכים מעל 20,000 יקובצו ל-20,000.
pageToken
string
אסימון דף, שהתקבל מקריאה קודמת ב-adUnitMappings.list. צריך לספק את הכתובת הזו כדי לאחזר את הדף הבא.
filter
string
מחרוזת סינון לפי תחביר EBNF. השדה האפשרי לסינון הוא:
'DISPLAY_NAME'
פונקציית הסינון האפשרית היא:
IN: משמש לסינון שדות שמייצגים טון יחיד, כולל 'DISPLAY_NAME'.
אפשר לחבר את פונקציות הסינון באמצעות AND. אין תמיכה בפונקציונליות של OR.
דוגמה:
מסנן: IN(DISPLAY_NAME, "מיפוי יחידת מודעות לבדיקה 1", "מיפוי יחידת מודעות לבדיקה 2")
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
תגובה ל-ListAdUnitMappingsRequest.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
[null,null,["עדכון אחרון: 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)."]]
