Method: accounts.adUnits.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyświetl jednostki reklamowe powiązane z określonym kontem AdMob.
Żądanie HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adUnits
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
parent |
string
Wymagane. Nazwa zasobu konta, dla którego chcesz wyświetlić listę jednostek reklamowych. Przykład: accounts/pub-9876543210987654
|
Parametry zapytania
| Parametry |
pageSize |
integer
Maksymalna liczba jednostek reklamowych do zwrotu. Jeśli wartość nie jest określona lub ma wartość 0, zwróconych zostanie maksymalnie 10 000 jednostek reklamowych. Maksymalna wartość to 20 000. wartości powyżej 20 000 zostaną zmienione na 20 000.
|
pageToken |
string
Wartość zwracana przez ostatnie działanie funkcji ListAdUnitsResponse; wskazuje, że jest to kontynuacja poprzedniego wywołania funkcji adUnits.list i że system powinien zwrócić następną stronę danych.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na żądanie wyświetlenia listy jednostek reklamowych.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Zapis JSON |
{
"adUnits": [
{
object (AdUnit)
}
],
"nextPageToken": string
} |
| Pola |
adUnits[] |
object (AdUnit)
Utworzone jednostki reklamowe dla żądanego konta.
|
nextPageToken |
string
Jeśli brak wartości, oznacza, że dla żądania może być więcej jednostek reklamowych. tę wartość należy przekazać w nowym formacie ListAdUnitsRequest.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/admob.monetization
https://www.googleapis.com/auth/admob.readonly
Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-21 UTC.
[null,null,["Ostatnia aktualizacja: 2025-08-21 UTC."],[[["\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)."]]
