Method: accounts.adSources.list
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Listez les sources d'annonces.
Requête HTTP
GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
parent |
string
Obligatoire. Parent propriétaire de cette collection de sources d'annonces. Format: accounts/{publisherId}
|
Paramètres de requête
Paramètres |
pageSize |
integer
Nombre maximal de sources d'annonces à renvoyer. Si aucune valeur n'est spécifiée ou si la valeur est nulle, 10 000 sources d'annonces au maximum sont renvoyées. La valeur maximale est 20 000. les valeurs supérieures à 10 000 sont converties en 20 000.
|
pageToken |
string
Jeton de page reçu d'un appel adSources.list précédent. Fournissez-le pour récupérer la page suivante.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Réponse pour ListAdSourcesRequest.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
{
"adSources": [
{
object (AdSource )
}
],
"nextPageToken": string
} |
Champs |
adSources[] |
object (AdSource )
Sources d'annonces.
|
nextPageToken |
string
Permet de définir pageToken dans ListAdSourcesRequest afin de récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.
|
Champs d'application des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/admob.readonly
https://www.googleapis.com/auth/admob.report
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.
AdSource
Définition d'une source d'annonce de médiation.
Représentation JSON |
{
"name": string,
"adSourceId": string,
"title": string
} |
Champs |
name |
string
Nom de ressource de cette source d'annonces. Le format est: accounts/{publisherId}/adSources/{adSourceId}
|
adSourceId |
string
ID de cette source d'annonces.
|
title |
string
Nom à afficher de cette source d'annonces.
|
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/21 (UTC).
[null,null,["Dernière mise à jour le 2025/08/21 (UTC)."],[[["\u003cp\u003eRetrieves a list of ad sources associated with a specific AdMob account.\u003c/p\u003e\n"],["\u003cp\u003eAllows pagination to retrieve large lists of ad sources using \u003ccode\u003epageSize\u003c/code\u003e and \u003ccode\u003epageToken\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEach ad source is identified by a unique \u003ccode\u003eadSourceId\u003c/code\u003e and has a display \u003ccode\u003etitle\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"]]],["This document details how to list ad sources using the AdMob API. To retrieve ad sources, send a `GET` request to `https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources`, specifying the account ID in the `parent` path parameter. Optional query parameters include `pageSize` (maximum ad sources returned) and `pageToken` (for pagination). The request body must be empty. The response includes a list of `adSources` with their `name`, `adSourceId`, and `title` and a `nextPageToken` for further pages.\n"],null,["# Method: accounts.adSources.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.ListAdSourcesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [AdSource](#AdSource)\n - [JSON representation](#AdSource.SCHEMA_REPRESENTATION)\n- [Examples](#examples)\n- [Try it!](#try-it)\n\nList the ad sources.\n\n### HTTP request\n\n`GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/adSources`\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 sources. Format: accounts/{publisherId} |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` The maximum number of ad sources to return. If unspecified or 0, at most 10,000 ad sources will be returned. The maximum value is 20,000; values above 10,000 will be coerced to 20,000. |\n| `pageToken` | `string` A page token, received from a previous `adSources.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 ListAdSourcesRequest.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"adSources\": [ { object (/admob/api/reference/rest/v1beta/accounts.adSources/list#AdSource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `adSources[]` | `object (`[AdSource](/admob/api/reference/rest/v1beta/accounts.adSources/list#AdSource)`)` The ad sources. |\n| `nextPageToken` | `string` Used to set the `pageToken` in the `ListAdSourcesRequest` 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.readonly`\n- `\n https://www.googleapis.com/auth/admob.report`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nAdSource\n--------\n\nDefinition of a mediation ad source.\n\n| JSON representation |\n|-------------------------------------------------------------------|\n| ``` { \"name\": string, \"adSourceId\": string, \"title\": string } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of this ad source. Format is: accounts/{publisherId}/adSources/{adSourceId} |\n| `adSourceId` | `string` ID of this ad source. |\n| `title` | `string` Display name of this ad source. |"]]