Method: accounts.mediationGroups.list

  • This method lists mediation groups under a specified AdMob account.

  • Access to this method is limited and may require contacting your account manager.

  • The request uses a GET HTTP method and requires the parent account resource name in the path parameters.

  • You can filter the results using various criteria like ad source IDs, app IDs, and platform, and control pagination with pageSize and pageToken.

  • The response body contains a list of mediation groups and a nextPageToken if there are more results.

List mediation groups under the specified AdMob account.

HTTP request

GET https://admob.googleapis.com/v1beta/{parent=accounts/*}/mediationGroups

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name of the account to list mediation groups for. Example: accounts/pub-9876543210987654

Query parameters

Parameters
pageSize

integer

The maximum number of mediation groups to return. If unspecified or 0, at most 10,000 mediation groups will be returned. The maximum value is 20,000; values above 20,000 will be coerced to 20,000.
pageToken

string

The value returned by the last ListMediationGroupsResponse; indicates that this is a continuation of a prior mediationGroups.list call, and that the system should return the next page of data.
filter

string

The filter string that uses EBNF grammar syntax. Possible fields to filter by are:

  • "AD_SOURCE_IDS"
  • "AD_UNIT_IDS"
  • "APP_IDS"
  • "DISPLAY_NAME"
  • "FORMAT"
  • "MEDIATION_GROUP_ID"
  • "PLATFORM"
  • "STATE"
  • "TARGETED_REGION_CODES"

Possible filter functions are:

  • IN: Used to filter fields that represent a singleton including "MEDIATION_GROUP_ID", "DISPLAY_NAME", "STATE", "PLATFORM", and "FORMAT".
  • CONTAINS_ANY: Used to filter fields that represent a collection including "AD_SOURCE_IDS", "AD_UNIT_IDS", "APP_IDS", and "TARGETED_REGION_CODES".

The filter functions can be added together using AND. OR functionality is not supported.

Example:

filter: IN(DISPLAY_NAME, "Test Group 1", "Test Group 2") AND IN(PLATFORM, "ANDROID") AND CONTAINS_ANY(AD_SOURCE_IDS, "5450213213286189855")

Request body

The request body must be empty.

Response body

Response for the mediation groups list request.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "mediationGroups": [
    {
      object (MediationGroup)
    }
  ],
  "nextPageToken": string
}
Fields
mediationGroups[]

object (MediationGroup)

The resulting mediation groups for the requested account.
nextPageToken

string

If not empty, indicates that there may be more mediation groups for the request; this value should be passed in a new ListMediationGroupsRequest.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/admob.monetization
  • https://www.googleapis.com/auth/admob.readonly

For more information, see the OAuth 2.0 Overview.