Method: accounts.adSources.adapters.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wyświetl listę adapterów źródła reklam.
Żądanie HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adSources/*}/adapters
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry |
parent |
string
Wymagane. Podmiot nadrzędny, który jest właścicielem tej kolekcji przejściówek. Format: accounts/{publisherId}/adSources/{adSourceId}
|
Parametry zapytania
Parametry |
pageSize |
integer
Maksymalna liczba adapterów do zwrotu. Jeśli wartość nie jest określona lub wynosi 0, zwróconych zostanie maksymalnie 10 000 adapterów. 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 adapters.list . Podaj go, aby pobrać kolejną stronę.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź na żądanie ListAdaptersRequest.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
{
"adapters": [
{
object (Adapter )
}
],
"nextPageToken": string
} |
Pola |
adapters[] |
object (Adapter )
Przejściówka.
|
nextPageToken |
string
Służy do ustawiania elementu pageToken w elemencie ListAdapterRequest w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.
|
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.
Karta
Opis adapterów obsługiwanych przez poszczególne źródła reklam z zapośredniczeniem.
Adaptery odpowiadają konkretnej implementacji źródła reklam w pakiecie SDK i są powiązane z jedną platformą oraz z listą obsługiwanych formatów jednostek reklamowych. Adaptery mogą też wymagać skonfigurowania pewnych ustawień, aby wysyłać żądania reklam. Konfiguracje można określać w AdUnitMapping, ustawiając pary klucz-wartość adUnitConfigurations. Na przykład za pomocą obiektu adUnitConfigurations można przekazywać różne identyfikatory do zewnętrznego pakietu SDK adaptera.
Zapis JSON |
{
"name": string,
"adapterId": string,
"title": string,
"platform": string,
"formats": [
string
],
"adapterConfigMetadata": [
{
object (AdapterConfigMetadata )
}
]
} |
Pola |
name |
string
Tylko dane wyjściowe. Nazwa zasobu adaptera. Format to: accounts/{publisherId}/adSources/{adSourceId}/adapters/{adapterId}.
|
adapterId |
string
Tylko dane wyjściowe. Identyfikator tego adaptera. Służy do ustawiania parametru adapterId.
|
title |
string
Tylko dane wyjściowe. Wyświetlana nazwa adaptera.
|
platform |
string
Tylko dane wyjściowe. Platforma aplikacji mobilnych obsługiwana przez ten adapter. Obsługiwane wartości to: IOS, ANDROID, WINDOWS_PHONE
|
formats[] |
string
Tylko dane wyjściowe. Wskazuje formaty jednostek reklamowych obsługiwane przez ten adapter.
|
adapterConfigMetadata[] |
object (AdapterConfigMetadata )
Tylko dane wyjściowe. Metadane konfiguracji powiązane z tym adapterem.
|
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\u003eLists available adapters for a given ad source, including details like platform, supported ad formats, and required configurations.\u003c/p\u003e\n"],["\u003cp\u003eProvides details on how to make the API request, including required parameters and authorization scopes.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes a list of adapters, each with its unique ID, display name, and configuration metadata.\u003c/p\u003e\n"],["\u003cp\u003eAdapter configuration metadata defines the necessary settings for integrating the adapter with ad units.\u003c/p\u003e\n"],["\u003cp\u003ePagination is supported to retrieve large lists of adapters using page tokens.\u003c/p\u003e\n"]]],["To list adapters, send a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*/adSources/*}/adapters`. The `parent` path parameter specifies the ad source. Use `pageSize` and `pageToken` query parameters to manage the number of results. The request body should be empty. A successful response returns a JSON object containing an array of `adapters` and `nextPageToken` for pagination. Each adapter has details such as `name`, `adapterId`, `title`, `platform`, supported `formats`, and `adapterConfigMetadata`.\n"],null,["# Method: accounts.adSources.adapters.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.ListAdaptersResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Adapter](#Adapter)\n - [JSON representation](#Adapter.SCHEMA_REPRESENTATION)\n- [AdapterConfigMetadata](#AdapterConfigMetadata)\n - [JSON representation](#AdapterConfigMetadata.SCHEMA_REPRESENTATION)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the adapters of the ad source.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*/adSources/*}/adapters`\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 adapters. Format: accounts/{publisherId}/adSources/{adSourceId} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of adapters to return. If unspecified or 0, at most 10,000 adapters 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 `adapters.list` call. Provide this to retrieve the subsequent page. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse for the ListAdaptersRequest.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"adapters\": [ { object (/admob/api/reference/rest/v1beta/accounts.adSources.adapters/list#Adapter) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `adapters[]` | `object (`[Adapter](/admob/api/reference/rest/v1beta/accounts.adSources.adapters/list#Adapter)`)` The adapter. |\n| `nextPageToken` | `string` Used to set the `pageToken` in the `ListAdapterRequest` 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).\n\nAdapter\n-------\n\nDescribes adapters supported by each mediation ad source.\n\nAdapters correspond to a specific SDK implementation of the ad source, and are each associated with a single platform and a list of supported ad unit formats. Adapters may also require setting some configurations to perform ad requests. Configurations can be specified in the AdUnitMapping by setting the [adUnitConfigurations](#AdUnitMapping.ad_unit_configurations) key/value pairs. For example, the adUnitConfigurations can be used to pass various IDs to the adapter's third-party SDK.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"adapterId\": string, \"title\": string, \"platform\": string, \"formats\": [ string ], \"adapterConfigMetadata\": [ { object (/admob/api/reference/rest/v1beta/accounts.adSources.adapters/list#AdapterConfigMetadata) } ] } ``` |\n\n| Fields ||\n|---------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name of the adapter. Format is: accounts/{publisherId}/adSources/{adSourceId}/adapters/{adapterId}. |\n| `adapterId` | `string` Output only. ID of this adapter. It is used to set [adapterId](#AdUnitMapping.adapter_id). |\n| `title` | `string` Output only. The display name of this adapter. |\n| `platform` | `string` Output only. Mobile application platform supported by this adapter. Supported values are: IOS, ANDROID, WINDOWS_PHONE |\n| `formats[]` | `string` Output only. Indicates the formats of the ad units supported by this adapter. |\n| `adapterConfigMetadata[]` | `object (`[AdapterConfigMetadata](/admob/api/reference/rest/v1beta/accounts.adSources.adapters/list#AdapterConfigMetadata)`)` Output only. Configuration metadata associated with this adapter. |\n\nAdapterConfigMetadata\n---------------------\n\nConfiguration metadata associated with this adapter. They are used to define the adUnitConfigurations associated with AdUnitMappings for the this adapter.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------|\n| ``` { \"adapterConfigMetadataId\": string, \"adapterConfigMetadataLabel\": string, \"isRequired\": boolean } ``` |\n\n| Fields ||\n|------------------------------|-------------------------------------------------------------------------------------------------------------|\n| `adapterConfigMetadataId` | `string` This is used to fill the key of the [adUnitConfigurations](#AdUnitMapping.ad_unit_configurations). |\n| `adapterConfigMetadataLabel` | `string` Name of the adapter configuration metadata. |\n| `isRequired` | `boolean` Whether this metadata is required for configuring the AdUnitMappings. |"]]